RESTful services are becoming increasingly popular. This work, that was carried out at Scania IT, investigates how a RESTful service should be designed and specified so that it meets the demands of an enterprise environment. In particular, this report will focus on documentation and validation of RESTful services, i.e. specifications. These are important aspects in an enterprise environment. The investigation consists of a comparative case study of four specification formats and Hypermedia As The Engine Of Application State (HATEOAS). The results show that the most commonly used specification formats have flaws. They also suggest that Swagger and RAML (RESTful API Modeling Language) are the two most mature formats. The results also show that HATEOAS, which is a more dynamic approach, can be useful in an enterprise environment but that it requires careful design. / REST-tjänster blir alltmer populära. Detta arbete, som utfördes på Scania IT, undersöker hur en REST-tjänst bör designas och specifieras för att möta de krav som finns i en enterprise-miljö. Specifikt kommer denna rapport att fokusera på dokumentation och validering av REST-tjänster, med andra ord specifikationer. Dessa är viktiga aspekter i en enterprise-miljö. Undersökningen består av en jämförande fallstudie med fyra specifikationsformat samt Hypermedia As The Engine Of Application State (HATEOAS). Resultaten visar att de mest vanligt förekommande specifikationsformaten har brister. De antyder också att Swagger och RAML (RESTful API Modeling Language) är de två mest mogna formaten. Resultaten visar också att HATEOAS, som är ett mer dynamiskt angreppssätt, kan vara användbart i en enterprise-miljö men att det kräver omsorgsfull design.
| Identifer | oai:union.ndltd.org:UPSALLA1/oai:DiVA.org:kth-172833 |
| Date | January 2015 |
| Creators | Wideberg, Robert |
| Publisher | KTH, Skolan för datavetenskap och kommunikation (CSC) |
| Source Sets | DiVA Archive at Upsalla University |
| Language | English |
| Detected Language | English |
| Type | Student thesis, info:eu-repo/semantics/bachelorThesis, text |
| Format | application/pdf |
| Rights | info:eu-repo/semantics/openAccess |
Page generated in 0.0017 seconds