Details
| Original language | English |
|---|---|
| Article number | 6193085 |
| Pages (from-to) | 36-44 |
| Number of pages | 9 |
| Journal | IEEE Internet computing |
| Volume | 16 |
| Issue number | 4 |
| Publication status | Published - 2012 |
Abstract
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.
Keywords
- Computer architecture, design notations, Documentation, Protocols, RESTful Web services, Servers, service design, service documentation, Unified modeling language, Web services
ASJC Scopus subject areas
- Computer Science(all)
- Computer Networks and Communications
Cite this
- Standard
- Harvard
- Apa
- Vancouver
- BibTeX
- RIS
In: IEEE Internet computing, Vol. 16, No. 4, 6193085, 2012, p. 36-44.
Research output: Contribution to journal › Article › Research › peer review
}
TY - JOUR
T1 - Welcome to the real world
T2 - A notation for modeling REST services
AU - Liskin, Olga
AU - Singer, Leif
AU - Schneider, Kurt
PY - 2012
Y1 - 2012
N2 - 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.
AB - 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.
KW - Computer architecture
KW - design notations
KW - Documentation
KW - Protocols
KW - RESTful Web services
KW - Servers
KW - service design
KW - service documentation
KW - Unified modeling language
KW - Web services
UR - http://www.scopus.com/inward/record.url?scp=84864920049&partnerID=8YFLogxK
U2 - 10.1109/MIC.2012.59
DO - 10.1109/MIC.2012.59
M3 - Article
AN - SCOPUS:84864920049
VL - 16
SP - 36
EP - 44
JO - IEEE Internet computing
JF - IEEE Internet computing
SN - 1089-7801
IS - 4
M1 - 6193085
ER -