Soa amsterdam-restws-pautasso-talk

7.10.2008 SOA Symposium 2008, Amsterdam
©2008 Cesare Pautasso
1
REST vs. SOAP:
Making the Right
Architectural Decision
Cesare Pautasso
Faculty of Informatics
University of Lugano (USI), Switzerland
http://www.pautasso.info

2
Agenda
1. Motivation: A short history of Web Services
2. Comparing REST vs. SOAP/WS-*
3. Architectural Decision Modeling
4. Conceptual Comparison
5. Technology Comparison
6. How to measure the “complexity” of WS-*
or the “simplicity” of REST?
7. Conclusion: Making the right Architectural
Decision

3
Web Sites (1992)
HTTP
HTMLWeb
Browser
Web
Server
(HTTP)
SOAP
ServerClient XML
WSDL
WS-* Web Services (2000)

4
RESTful Web Services (2006)
Client
HTTP
PO-XML
RSS
JSON
Web
Server
WADL
WS-* Web Services (2000)
(HTTP)
SOAP
ServerClient XML
WSDL

5

6
XML
URI HTTP
MIME
JSON
RESTful
SSL
RSS

7
Is REST being used?
SlidefromPaulDowney,BT

8
Can we really compare
WS-* vs. REST?
WS-* REST

9
Can we really compare
WS-* vs. REST?
WS-*
SOA Middleware
Interoperability
Standards
REST
Architectural
style for
the Web

10
How to compare?
WS-*
SOA Middleware
Interoperability
Standards
REST
Architectural
style for
the Web
Architectural
Decision Modeling

11
Architectural Decisions
• Architectural decisions
capture the main design
issues and the rationale
behind a chosen technical
solution
• The choice between REST
vs. WS-* is an important
architectural decision for
integration projects
• Architectural decisions
affect one another
Architectural Decision:
Communication Protocol
Architecture Alternatives:
1. TCP
2. SMTP
3. HTTP
4. MQ
5. BEEP
6. CORBA IIOP
7. …
Rationale

12
Application Integration Styles
File
Transfer
Shared
Database
Message BusRemote
Procedure
Call
WS-*REST
Integration Technology Platform

13
Related Decisions (WS-*)
File
Transfer
Shared
Database
Message BusRemote
Procedure
Call
WS-*REST

14
Related Decisions (RPC)
File
Transfer
Shared
Database
Message BusRemote
Procedure
Call
WS-*REST

15
Decision Space Overview

16
Decision Space Summary
21 Decisions and 64 alternatives
Classified by level of abstraction:
• 3 Architectural Principles
• 9 Conceptual Decisions
• 9 Technology-level Decisions
Decisions help us to measure the
complexity implied by the choice of
REST or WS-*

17
Architectural Principles
1. Protocol Layering
• HTTP = Application-level Protocol (REST)
• HTTP = Transport-level Protocol (WS-*)
2. Dealing with Heterogeneity
3. Loose Coupling

18
RESTful Web Service Example
HTTP Client
(Web Browser)
Web Server Database
GET /book?ISBN=222
SELECT *
FROM books
WHERE isbn=222
POST /order INSERT
INTO orders
301 Location: /order/612
PUT /order/612 UPDATE orders
WHERE id=612

19
Big Web Service Example
(from REST perspective)
HTTP Client
(Stub Object)
Web Server
POST /soap/endpoint
POST /soap/endpoint
POST /soap/endpoint
return getBook(222)
return new Order()
order.setCustomer(x)
Web Service
Implementation

20
Protocol Layering
• “The Web is the universe of globally
accessible information”
(Tim Berners Lee)
– Applications should publish their
data on the Web (through URI)
• “The Web is the universal (tunneling)
transport for messages”
– Applications get a chance to
interact but they remain
“outside of the Web”
Application
Resource URI
HTTP
POST
Application
Endpoint URI
POX
HTTP
GET
HTTP
PUT
HTTP
DEL
HTTP
POST
SOAP (WS-*)
MQ…SMTP
RSS JSON …

21
Dealing with Heterogeneity
CICS
IMS
PicturefromEricNewcomer,IONA
• Enterprise Computing
HTTP
• Web Applications

22
Conceptual Comparison
Note: this table
will scroll up
during the talk

23
Technology Comparison
Note: this table
will scroll up
during the talk

24
Measuring Complexity
• Architectural Decisions give a
quantitative measure of the complexity
of an architectural design space:
– Total number of decisions
– For each decision, number of alternative options
– For each alternative option, estimate the effort
3527Alternatives
1417Decisions
WS-*REST
Decisions with 1 or more alternative options

25
3527Alternatives
1417Decisions
WS-*REST
Decisions with 1 or more alternative options
3216Alternatives
125Decisions
WS-*REST
Decisions with more than 1 alternative options

26
3216Alternatives
125Decisions
WS-*REST
• URI Design
• Resource Interaction Semantics
• Payload Format
• Service Description
• Service Composition

27
3216Alternatives
125Decisions
WS-*REST
212Decisions
WS-*REST
Decisions with only 1 alternative option

28
212Decisions
WS-*REST
• Payload Format
• Data Representation Modeling

29
Measuring Effort
212Decisions
WS-*REST
05Do-it-yourself
Alternatives
WS-*REST
Decisions with only do-it-yourself alternatives

30
Measuring Effort
05Do-it-yourself
Alternatives
WS-*REST
Decisions with only do-it-yourself alternatives
• Resource Identification
• Resource Relationship
• Reliability
• Transactions
• Service Discovery

31
Freedom of Choice
Freedom from Choice

32
Comparison Summary
• Architectural Decisions measure complexity implied
by alternative technologies
• REST simplicity = freedom from choice
– 5 decisions require to choose among 16 alternatives
– 12 decisions are already taken (but 5 are do-it-yourself)
• WS-* complexity = freedom of choice
– 12 decisions require to choose among 32 alternatives
– 2 decisions are already taken (SOAP, WSDL+XSD)

33
Conclusion
• You should focus on whatever solution gets the job
done and try to avoid being religious about any
specific architectures or technologies.
• WS-* has strengths and weaknesses and will be
highly suitable to some applications and positively
terrible for others. Likewise with REST.
• The decision of which to use depends entirely on the
application requirements and constraints.
• We hope this comparison will help you make the right
choice.

34
References
• Cesare Pautasso, Olaf Zimmermann, Frank Leymann,
RESTful Web Services vs. Big Web Services: Making the Right
Architectural Decision, Proc. of the 17th International World Wide
Web Conference (WWW2008), Bejing, China, April 2008.
• Cesare Pautasso, BPEL for REST, Proc. of the 6th International
Conference on Business Process Management (BPM 2008), Milan,
Italy, September 2008.
• Cesare Pautasso, Gustavo Alonso: From Web Service Composition
to Megaprogramming In: Proceedings of the 5th VLDB Workshop on
Technologies for E-Services (TES-04), Toronto, Canada, August 29-
30, 2004.

35
REST vs. SOAP:
Making the Right
Architectural Decision
Cesare Pautasso

36
Backup Material
on REST
Cesare Pautasso

37
REST in one Slide
• REpresentational State Transfer defines the architectural
style of the World Wide Web
• Its four principles can explain the success and the
scalability of the HTTP protocol implementing them
1. Resource Identification through URI
2. Uniform Interface for all resources:
GET (Query the state, idempotent, can be cached)
POST (Update a resource or create child resource)
PUT (Transfer the state on existing/new resource)
DELETE (Delete a resource)
3. “Self-Descriptive” Message representations
4. Hyperlinks to define relationships between resources
and valid state transitions of the service interaction

38
URI: Uniform Resource Identifier
• Internet Standard for resource naming and identification
(originally from 1994, revised until 2005)
• Examples:
http://tools.ietf.org/html/rfc3986
https://www.google.ch/search?q=rest&start=10#1
• REST advocates the use of “nice” URIs
• In most HTTP stacks URIs cannot have arbitrary length (4Kb)
URI Scheme Authority Path
Query Fragment

39
What is a “nice” URI?
http://map.search.ch/lugano
http://maps.google.com/maps?f=q&hl=en&q=lugano,
+switzerland&layer=&ie=UTF8&z=12&om=1&iwloc=addr
http://maps.google.com/lugano
Prefer Nouns to Verbs
Keep them Short

40
Uniform Interface Principle
(CRUD Example)
DELETE
UPDATE
READ
CREATE
CRUD
Clear a resource,
after the URI is no
longer valid
Modify the state
of a resource
Retrieve the current
state of the resource
Initialize the state of a
new resource
at the given URI
DELETE
PUT
GET
POST/PUT
REST

41
POST vs. GET
• GET is a read-only operation.
It can be repeated without
affecting the state of the
resource (idem-potent)
• POST is a read-write
operation and may change
the state of the resource
and provoke side effects on
the server.
Web browsers warn
you when refreshing
a page generated
with POST

42
RESTful Web Services Design
1. Identify resources to be exposed as
services (e.g., yearly risk report, book
catalog, purchase order, open bugs)
2. Define “nice” URLs to address them
3. Understand what it means to do a GET,
POST, PUT, DELETE on a given resource
URI
4. Design and document resource
representations (payload formats)
5. Model relationships (e.g., containment,
reference, state transitions) between
resources with hyperlinks that can be
followed to get more details
6. Implement and deploy on Web server
7. Test with a Web browser
XXX/soap
??/order
/book
?/client
XXX/balance
/loan
DELETE
POST
PUT
GET

43
• XML
– PO-XML
– SOAP (WS-*)
– RSS, ATOM
• Standard textual syntax for
semi-structured data
• Many tools available:
XML Schema, DOM, SAX, XPath,
XSLT, XQuery
• Everyone can parse it
(not necessarily understand it)
• Slow and Verbose
• JavaScript Object Notation (JSON)
• Wire format introduced for AJAX
Web applications (Browser-
Web Server communication)
• Textual syntax for serialization of
non-recurrent data structures
• Supported in most languages
(not only JavaScript)
• Not extensible
(does not need to be)
• “JSON has become the X in Ajax”
Resource Representation
Formats: XML vs JSON

Soa amsterdam-restws-pautasso-talk

More Related Content

Viewers also liked (9)

Similar to Soa amsterdam-restws-pautasso-talk (20)

Recently uploaded (20)

Soa amsterdam-restws-pautasso-talk