Welcome to the Real World: A Notation for Modeling REST Services

Documentation of REST and REST-style services often uses prose only, making it hard for client developers to understand the ties between the service's parts. We developed a notation for REST-style services that's based on UML state charts. It can be used with existing tools and is simple e...

Full description

Saved in:
Bibliographic Details
Published in:IEEE internet computing 2012-07, Vol.16 (4), p.36-44
Main Authors: Liskin, O., Singer, L., Schneider, K.
Format: Article
Language:English
Subjects:
Charts
Computation
Computer architecture
design notations
Developers
Documentation
Hypermedia
Internet
Protocols
Rest
RESTful Web services
Servers
service design
service documentation
Unified Modeling Language
Web services
Citations: Items that this one cites
Items that cite this one
Online Access:Request full text
Tags: Add Tag
No Tags, Be the first to tag this record!
Description
Summary:Documentation of REST and REST-style services often uses prose only, making it hard for client developers to understand the ties between the service's parts. We developed a notation for REST-style services that's based on UML state charts. It can be used with existing tools and is simple enough for use on whiteboards. The notation visualizes relationships between application states, thereby improving the understanding of hypermedia use in services. This benefits both service designers and client developers. Because the notation makes REST-related design problems more obvious, it might even improve service design.
ISSN:1089-7801
1941-0131
DOI:10.1109/MIC.2012.59