research-article

Towards a View-Based Process for Designing and Documenting RESTful Service Architectures

Authors:

Paulo F. Pires,

Flávia C. Delicato,

Flávio OquendoAuthors Info & Claims

ECSAW '15: Proceedings of the 2015 European Conference on Software Architecture Workshops

Article No.: 50, Pages 1 - 7

https://doi.org/10.1145/2797433.2797485

Published: 07 September 2015 Publication History

Abstract

Representational State Transfer (REST) is an architectural style for service-based design. Regarded to be used in massively distributed and loosely coupled hypermedia systems, REST has been the de facto architecture style for REST-based web services (called RESTful services). Besides business functionality, RESTful services should address quality attribute requirements, which are commonly described in scenarios (textual descriptions of how to achieve such attribute in the system's context). However, to properly mapping scenarios into architectural elements is a non-trivial task. Furthermore, architects often fail to document adequately the design decisions taken during such mapping. These issues can result in low-quality RESTful services. In this paper, we present a view-based process that provides mechanisms to represent quality attribute scenarios as concrete design decisions that can be later used in the design of RESTful service architectures.

References

[1]

F. Bachmann, L. Bass, M. Klein, and C. Shelton. Designing software architectures to achieve quality attribute requirements. Software, IEE Proceedings, 152(4): 153--165, August 2005.

[2]

L. Bass, M. Klein, and G. Moreno. Applicability of General Scenarios to the Architecture Tradeoff Analysis Method. Technical Report CMU/SEI-2001-TR-014. Software Engineering Institute, Carnegie Mellon University, 2001.

[3]

L. Bass, P. Clements, and R. Kazman. Software Architecture in Practice. Addison-Wesley, 2012.

Digital Library

[4]

P. Clements, et al. Documenting Software Architectures: Views and Beyond. Pearson Education, 2010.

Digital Library

[5]

B. Costa, P. F. Pires, F. C. Delicato, ando P. Merson. Evaluating a Representational State Transfer (REST) Architecture - What is the impact of REST in my architecture? In IEEE/IFIP Conference on Software Architecture (WICSA) Proceedings, pages 105--114. April 2014.

Digital Library

[6]

EMF-REST: http://emf-rest.com/. Accessed: 2015-03-05.

[7]

N. B. Harrison, P. Avgeriou, and U. Zdun. Using Patterns to Capture Architectural Decisions. IEEE Software, 24(4): 38--45, July 2007.

Digital Library

[8]

F. Haupt, D. Karastoyanova, F. Leymann, and B. Schroth. A Model-Driven Approach for REST Compliant Services. In IEEE International Conference on Web Services Proceedings, pages 129--136. June 2014.

Digital Library

[9]

JBoss AS - Project Documentation: https://docs.jboss.org/author/display/JBASDOC/Home. Accessed: 2015-04-13.

[10]

J. Knodel, and M. Naab. Software Architecture Evaluation in Practice: Retrospective on More Than 50 Architecture Evaluations in Industry. In IEEE/IFIP Conference on Software Architecture (WICSA) Proceedings, pages 115--124. April 2014.

Digital Library

[11]

P. Kruchten, H. Obbink, and J. Stafford. The Past, Present, and Future for Software Architecture. IEEE Software, 23(2): 22--30, March 2006.

Digital Library

[12]

M. Laitkorpi, P. Selonen, and T. Systa. Towards a model-driven process for designing restful web services. In IEEE International Conference on Web Services (ICWS) Proceedings, pages 173--180. July 2009.

Digital Library

[13]

RAML - RESTful API modeling language: http://raml.org/. Accessed: 2015-03-05.

[14]

RESTEasy: http://resteasy.jboss.org/. Accessed: 2015-03-14.

[15]

S. Schreier. Modeling RESTful applications. In Second International Workshop on RESTful Design (WS-REST) Proceedings, pages 15--21. March 2011.

Digital Library

[16]

D. Steinberg, F. Budinsky, M. Paternostro, and E. Merks. Emf: Eclipse Modeling Framework 2.0 (2nd ed.). Addison-Wesley Professional, 2009.

Digital Library

[17]

E. Wilde, and C. Pautasso, C. REST: From Research to Practice. Springer Science & Business Media, 2011.

Digital Library

[18]

ISO/IEC/IEEE 42010:2011 - Systems and software engineering -- Architecture description.

Cited By

Santos RPenchel RBontempo MArismar Cerqueira S(2016)Reconfigurable printed antenna arrays for mm-wave applications2016 10th European Conference on Antennas and Propagation (EuCAP)10.1109/EuCAP.2016.7481340(1-5)Online publication date: Apr-2016
https://doi.org/10.1109/EuCAP.2016.7481340
Costa BPires PDelicato FMerson P(2016)Evaluating REST architectures-Approach, tooling and guidelinesJournal of Systems and Software10.1016/j.jss.2015.09.039112:C(156-180)Online publication date: 1-Feb-2016
https://dl.acm.org/doi/10.1016/j.jss.2015.09.039

Index Terms

Towards a View-Based Process for Designing and Documenting RESTful Service Architectures
1. Software and its engineering
  1. Software organization and properties
    1. Software system structures
      1. Software architectures

Recommendations

Towards Automatic Discovering for a Real-World RESTful Web Service
WISA '12: Proceedings of the 2012 Ninth Web Information Systems and Applications Conference

Web services have been emerging and are by now one of the most popular techniques for building versatile distributed systems. With the increasing popularity of the Restful Web services on the network, how to select the real-world Restful Web services ...
Designing level 3 behavioral RESTful web service interfaces

A web service interface contains information about the names of the operations that can be invoked on the service and the input and output parameters of these operations. This information is not enough to facilitate service developer and consumer in ...
Adaptive matchmaking for RESTful services based on hRESTS and MicroWSMO
WEWST '10: Proceedings of the 5th International Workshop on Enhanced Web Service Technologies

Matchmaking -- i.e., the task of finding functionally suitable service offers based on a service request -- has only been addressed in the context of WS-* Web services. However, RESTful services are gaining increasing attraction and have been adopted by ...

Comments

Please enable JavaScript to view thecomments powered by Disqus.

Information & Contributors

Information

Published In

cover image ACM Other conferences

ECSAW '15: Proceedings of the 2015 European Conference on Software Architecture Workshops

September 2015

364 pages

ISBN:9781450333931

DOI:10.1145/2797433

General Chair:
Ivica Crnkovic

Copyright © 2015 ACM.

Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 07 September 2015

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Research-article
Research
Refereed limited

Funding Sources

Conference

ECSAW '15

ECSAW '15: 2015 European Conference on Software Architecture Workshops

September 7 - 11, 2015

Cavtat, Dubrovnik, Croatia

Acceptance Rates

ECSAW '15 Paper Acceptance Rate 51 of 77 submissions, 66%;

Overall Acceptance Rate 80 of 120 submissions, 67%

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

2
Total Citations
View Citations
92
Total Downloads

Downloads (Last 12 months)3
Downloads (Last 6 weeks)0

Reflects downloads up to 16 Feb 2025

Other Metrics

View Author Metrics

Citations

Cited By

Santos RPenchel RBontempo MArismar Cerqueira S(2016)Reconfigurable printed antenna arrays for mm-wave applications2016 10th European Conference on Antennas and Propagation (EuCAP)10.1109/EuCAP.2016.7481340(1-5)Online publication date: Apr-2016
https://doi.org/10.1109/EuCAP.2016.7481340
Costa BPires PDelicato FMerson P(2016)Evaluating REST architectures-Approach, tooling and guidelinesJournal of Systems and Software10.1016/j.jss.2015.09.039112:C(156-180)Online publication date: 1-Feb-2016
https://dl.acm.org/doi/10.1016/j.jss.2015.09.039

View Options

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Full Access

Get this Publication

View options

PDF

View or Download as a PDF file.

eReader

View online with eReader.

Figures

Tables

Media

View Table of Conten