Marek Polák
ABSTRACT
Nowadays, the REST (Representational State Transfer) is becoming the most commonly used way how to create, publish, and consume Web Services, exploiting JSON (JavaScript Object Notation) as the data exchange format. However, there are still no official standards for REST (like WSDL for Web Services) and for JSON (like XML Schema for the XML language). Next, there are no defined instructions how the resource versions should be managed.
In this paper we focus on managing and generating REST resources based on the MDA (Model-Driven Architecture) principle which enables designing and maintenance of complex projects. We introduce a way how to describe the REST API in MDA and how to provide automatic evolution management between subsequent API versions derived from the original version. The proposed solution describes a novel model which represents REST requests and algorithms for providing evolution of this model based on changes done in the PIM (Platform-Independent Model) of MDA.
- API Blueprint. http://apiblueprint.org/.Google Scholar
- API Evolution. https://www.mnot.net/blog/2012/12/04/api-evolution.Google Scholar
- API versioning. http://pivotallabs.com/api-versioning/.Google Scholar
- Hypertext Application Language. http://stateless.co/hal_specification.html.Google Scholar
- JavaScript Object Notation. http://www.json.org/.Google Scholar
- RESTful API Modeling Language. http://raml.org/.Google Scholar
- Swagger. http://swagger.io/.Google Scholar
- D. Booth and C. K. Liu. Web Services Description Language (WSDL) Version 2.0 Part 0: Primer. W3C, June 2007.Google Scholar
- DaemonX-Team. DaemonX, June 2011. http://daemonx.codeplex.com.Google Scholar
- R. T. Fielding. Architectural Styles and the Design of Network-based Software Architectures. PhD thesis, University of California, 2000. AAI9980887. Google ScholarDigital Library
- GitHub. GitHub, December 2014. https://github.com/.Google Scholar
- Microsoft. ASP.NET Web API, February 2015. http://www.asp.net/web-api.Google Scholar
- J. Miller and J. Mukerji. MDA Guide Version 1.0.1. OMG, 2003. http://www.omg.org/docs/omg/03-06-01.pdf.Google Scholar
- OMG. UML Superstructure Specification 2.1.2, November 2007. http://www.omg.org/spec/UML/2.1.2/Superstructure/PDF/.Google Scholar
- OMG. Meta Object Facility (MOF) 2.0 Query/View/Transformation Specification, April 2008.Google Scholar
- A. Ronacher. Flask Microframework, December 2014. http://flask.pocoo.org.Google Scholar
- H. S. Thompson, D. Beech, M. Maloney, and N. Mendelsohn. XML Schema Part 1: Structures (Second Edition). W3C, October 2004. http://www.w3.org/TR/xmlschema-1/.Google Scholar
- Twitter. Twitter, March 2015. https://dev.twitter.com/overview/api.Google Scholar
- W3C. Extensible Markup Language (XML). http://www.w3.org/XML/, 2010.Google Scholar
- W3C. AJAX, December 2014. http://www.w3schools.com/ajax/default.asp.Google Scholar
Index Terms
- REST API Management and Evolution Using MDA
Recommendations
Advanced REST API Management and Evolution Using MDA
DChanges 2015: Proceedings of the 3rd International Workshop on (Document) Changes: modeling, detection, storage and visualizationThe REST (Representational State Transfer) has become a popular and preferred way of communication on the Web. JSON (JavaScript Object Notation) [5] is the most used data interchange format these days. JSON can be easily used with (but not-only) ...
Definition of REST web services with JSON schema
The Web has evolved from being a collection of documents to a collection of interconnected services that interoperate throughout the Internet. Web services are a natural consequence of this evolution. The web services model was initially centered around ...
EMF-REST: generation of RESTful APIs from models
SAC '16: Proceedings of the 31st Annual ACM Symposium on Applied ComputingIn the last years, there has been an increasing interest for Model-Driven Engineering (MDE) solutions in the Web. Web-based modeling solutions can leverage on better support for distributed management (i.e., the Cloud) and collaboration. However, ...
Comments