240 likes | 320 Views
The Web Services Game. This game is intended for a non technical audience ; We have purposely simplified technical aspect. What is a Web Service. It is a piece of software that runs remotely, It is accessible over a network (e.g. Internet),
E N D
This game is intended for a non technical audience; • We have purposely simplified technical aspect.
What is a Web Service • It is a piece of software that runs remotely, • It is accessible over a network (e.g. Internet), • It is meant for machine to machine communication, • Independent from programming languages, • It can be operated following specific rules (i.e. protocol), • There are 2 main protocols in use…
REST Web Services 2 1 3 WADL Reads URL Data / Status
SOAP Web Services 2 4 4 1 WSDL 3 5 5 GET WSDL Reads WSDL SOAP Request SOAP Response Method / Parameters Data
SOAP vs. REST • Based on Standards, • Only accessed by software, • Allow description of complex data structure in request and response, SOAP REST • Geared to simplicity, • A browser can be a client, • Request as complex as a URL can be,
The Actors • The user • The client application • The REST Service • Mr Internet
How to play the REST game • Choose the actors • Get the User to ask a question to the Client Application • Get the Client Application to format a URL with user parameters • The Client Application invoked the Web Service with the URL • The Web Service processes the request and sends the data back to the Client Application (with the help of Mr Internet) • The Client application processed the data and shows to the User
The REST Service • Name: Dbfetch • Purpose: To serve sequence of biological entities • Documentation: http://www.ebi.ac.uk/Tools/dbfetch • Query Example: • Get sequence of protein Q07812 from UniProt • Get Gene sequence for Ensembl Transcript: ENST00000345358
Dbfetch Documentation How to build a URL ? http://www.ebi.ac.uk/Tools/dbfetch/dbfetch?db=${DB}&id=${ID}&format=${FORMAT}&style=raw URL Parameters • DB • uniprotkb • ensembl • embl • … • ID • FORMAT • fasta • embl • …
The REST URL http://www.ebi.ac.uk/Tools/dbfetch/dbfetch?db=_____&id=_________&format=____&style=raw
The Actors • The user • The client application • The SOAP Service • Mr Internet
How to play the SOAP game • Choose the actors • Get the User to ask a question to the Client Application • Get the Client Application to retrieve the WSDL from the Web Service (with the help of Mr Internet) • The Client Application chooses the method and parameters • The Client Application sends the SOAP request to the Web Service (with the help of Mr Internet) • Web Service process the request and generate data, wraps it in a SOAP Response and send it back to the Client Application • The Client application processed the data and shows to the User
The SOAP Service • Name: Dbfetch • Purpose: To serve sequence of biological entities • Documentation: http://www.ebi.ac.uk/Tools/webservices/services/dbfetch • Query Example: • Get sequence of protein Q07812 from UniProt • Get Gene sequence for Ensembl Transcript: ENST00000345358
Dbfetch WSDL Where is the WSDL file ? http://www.ebi.ac.uk/ws/services/WSDbfetchDoclit?wsdl Methods available • getSupportedDbs • getSupportedFormats • getDbFormats • db • fetchData • query (i.e. db:id) • format • style
A SOAP Request Method name: _____________________ Parameters:
Acknowledgments Rafael Jimenez Samuel Kerrien You for being such good actors ;)