ECSA'15 - Modeling REST-ful conversations

Modeling RESTful Conversations with Extended

BPMN Choreography Diagrams

Cesare Pautasso, Ana IvanchikjUniversity of Lugano (USI)

Switzerland

Silvia SchreierinnoQ Deutschland GmbH

Germany

European Conference on Software Architecture Cavtat, September 7-11

ECSA 2015

ana.ivanchikj@usi.ch

RESTful conversation

REST BPMN Choreography Extended BPMN Choreography Example Model Abstractions and Simplifications Future work

Resource

GET URI GET URI

reference create

Link Relationships (Hypermedia)

303 See Other

200 OK

RESTful conversation

Resource

GET URI GET URI

reference create

Link Relationships (Hypermedia)

303 See Other

201 Created

200 OK

REST API structure - RAML

REST API structure- Swagger

GET /resource 1 HTTP/1.1

HTTP/1.1 303 See OtherLocation: /resource2GET /resource2 HTTP/1.1

HTTP/1.1 200 OK

REST API dynamics

UML Sequence diagram BPMN Choreography diagram

- Redirect -

BPMN Choreography

Inclusive gateway

Parallel gateway

Exclusive gateway

GET /resource 1 HTTP/1.1

HTTP/1.1 303 See OtherLocation: /resource2GET /resource2 HTTP/1.1

HTTP/1.1 200 OK

REST API dynamics

UML Sequence diagram BPMN Choreography diagram Our proposal

- Redirect -

Extended BPMN Choreography

Assumption:ONE client – ONE server

10REST BPMN Choreography Extended BPMN Choreography Example Model Abstractions and Simplifications Future work

Long-running Request-RESTful Conversation Example-

e.g.: http://docs.aws.amazon.com/amazonglacier/latest/dev/job-operations.html

Long-running Request- Happy path -

Create job POST / job HTTP/1.1

HTTP/1.1 202 AcceptedLocation: / job / 42

Poll GET / job / 42 HTTP/1.1

HTTP/1.1 200 OK

Read results GET / job / 42 / output HTTP/1.1

HTTP/1.1 200 OK

GET / job / 42 HTTP/1.1

HTTP/1.1 303 See OtherLocation: / job / 42 / output

Long-running Request- Resending the request -

HTTP/1.1 200 OK

POST / job HTTP/1.1

Long-running Request- Reading the results -

HTTP/1.1 200 OK

POST / job HTTP/1.1

GET / job / 42 / output HTTP/1.1

HTTP/1.1 200 OK

Long-running Request- Deleting the output resource -

Delete output DELETE / job / 42 / output HTTP/1.1

HTTP/1.1 200 OK

POST / job HTTP/1.1

HTTP/1.1 200 OK

Long-running Request- Deleting the output resource -

HTTP/1.1 200 OK

POST / job HTTP/1.1

Long-running Request

Clean up DELETE / job / 42 HTTP/1.1

HTTP/1.1 200 OK

POST / job HTTP/1.1

- Deleting the job resource -

POST / job HTTP/1.1

Delete job DELETE / job / 42 HTTP/1.1

HTTP/1.1 200 OK

- Deleting the job resource -

Long-running Request- Short happy path -

HTTP/1.1 200 OK

Long-running Request- Long unhappy path -

HTTP/1.1 200 OK

POST / job HTTP/1.1

HTTP/1.1 200 OK

Delete job DELETE / job / 42 HTTP/1.1

HTTP/1.1 200 OK

Long-running Request-BPMN Choreography-

Long-running Request-Extended BPMN Choreography-

Abstractions and Simplifications

Abstraction – Server Error Response

Abstraction – Idempotent requests

Simplification – End events

Simplification - Hyperlinks

Simplifications and abstractions summary

• Survey– Understandability– Ease of use

Future Work

• Conversation Patterns – Expressiveness– Collection– Reusability

Contact us at:ana.ivanchikj@usi.ch

c.pautasso@ieee.orgsilvia.schreier@innoq.com

Contribute to our research by filling in the survey!!!http://restfulconversations.limequery.com/index.php/215135/lang-en

ECSA'15 - Modeling REST-ful conversations

Software

ECSA REGISTRATION WORKSHOP to SACPSdocs\ECSA REGISTRATION WORKSHOP... · ECSA REGISTRATION WORKSHOP Background •Engineering Profession Act, 2000 (Act 46 of 2000) –Establishment

1E ECSA Candidate Appform

ECSA E-News · ECSA Newsletter, June 2019 (No. 31) CONTENTS Messages from ECSA / ECSA events: ECSA Focus Meeting March/April 2020 Focus Meeting on the environmental status of estuaries

ecsa world news june2015-1 - Europahuis Ryckevelde– ECSA Ukraine, Vasile Cucerescu – ECSA Moldova, Ioan Horga – ECSA Romania, Olga Bombardelli – ECSA Italy, Nico S. Groenendijk

ECSA Learning & Teaching Report LT Report 2017 - Final.pdf · ecsa learning & teaching report 2017 pg. 3 self evaluation awards ecsa-llence student executive class rep campus conferences

ECSA Bulletin No 59 Summer 2012 ECSA Bulletin...ECSA Bulletin 59 - Summer 2012 ECSA Bulletin 59 - Summer 2012 to in literature of the Judeo-Christian tradition. It was typically described

SA E-s...ECSA Newsletter, April 2017 (No. 25) CONTENTS Messages from ECSA / ECSA events: • 47th ECSA Annual General Meeting • Peter Jones Memorial Prize Winner 2016 • Marine

European Citizen Science Association (ECSA)

WICSA/ECSA 2009 SOAR

COSMETICS - Homepage | ECSA Chemicals

ECSA FACT-FINDING VISIT TO INDIAN SHIP … Ship Recycling...ECSA FACT-FINDING VISIT TO INDIAN SHIP RECYCLING YARDS ALANG-SOSIYA, 29-30 APRIL 2016 ECSA TECHNICAL REPORT ©ECSA – 29.04.2016

ECSA Feb Bulletin

ECSA v9 brochure

1B ECSA Technologist Appform

20120228 Ecsa Overview

ECSA Member State Assessment Findings 10-25-2016ecsahc.org/.../08/ECSA-Member-State-Assessment-Findings_10-25-… · management baseline assessment of ECSA-HC in August 2015.

ECSA REGISTRATION WORKSHOP Marais PrEng.pdf · ecsa registration workshop document submission stage – overview of ecsa documents – guidelines – submission process. overview

ECSA REGISTRATION WORKSHOP to SACPS REGISTRATION WORKSHOP to... · ECSA REGISTRATION WORKSHOP Background •Engineering Profession Act, 2000 (Act 46 of 2000) –Establishment of ECSA

ECSA 27-29,1993

Presentation ECSA