KEMBAR78
Overview of java web services | PPTX
Java Training Overview
Web Services
Introduction
• Who am I?
– Worked for TSB for 13+ years as FNA
– October 2012 moved to ITSO
– TSB and ITSO was kind enough to send me to San
Antonio with Sean, Vicky and Tony
What we will be covering
•
•
•
•

Web services architecture
Web services definitions and terms
How Web Services work
Overview and examples of SOAP and RESTful
Web Services
What we won’t be covering
• Java programming
• How to functional test Web Services
What are Web Services?

“A piece of software that provides some useful
functionality by a programmatic interface that is
available via the standard protocols of the Internet.”
What are Web Services?
•
•
•
•

Application components
Use open protocols
Self-contained and self-describing
Can be discovered using Universal Description
Discovery and Integration (UDDI)
• Can be used by other applications
• Allows data exchange between different applications
and different platforms
Web Services Platform
•
•
•
•
•
•

Lots of confusion
2 general types of Web Services – SOAP and REST
SOAP is a protocol, REST is an architecture style
Can have many overlaps
Usually over HTTP
Usually uses XML (or JSON)
How do Web Services work?
CGI
Web
Application

Browser
HTML

Web
Service

Client
(Phone
App)

Web
Service
Web
Service

Web Service
Provider

Database
SOAP
SOAP…
•
•
•
•
•
•
•
•
•

Stands for Simple Object Access Protocol
Is a communication protocol
Is a format for sending messages
Is designed to communicate via the Internet
Is platform and language independent
Is based on XML
Is simple and extensible
Allows you to get around firewalls
Is a W3C standard
SOAP building blocks
A SOAP message is an ordinary XML document
containing the following elements:
• An Envelope element that identifies the XML
document as a SOAP message
• A Header element that contains header information
• A Body element that contains call and response
information
• A Fault element containing errors and status
information
SOAP syntax rules
• A SOAP message MUST be encoded using XML
• A SOAP message MUST use the SOAP Envelope
namespace
• A SOAP message MUST use the SOAP Encoding
namespace
• A SOAP message must NOT contain a DTD reference
• A SOAP message must NOT contain XML Processing
Instructions
• SOAP request could be an HTTP POST or HTTP GET
Example: A SOAP Request
POST /InStock HTTP/1.1
Host: www.example.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: nnn
<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Body xmlns:m="http://www.example.org/stock">
<m:GetStockPrice>
<m:StockName>IBM</m:StockName>
</m:GetStockPrice>
</soap:Body>
</soap:Envelope>
Example: A SOAP Response
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: nnn
<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Body xmlns:m="http://www.example.org/stock">
<m:GetStockPriceResponse>
<m:Price>34.5</m:Price>
</m:GetStockPriceResponse>
</soap:Body>
</soap:Envelope>
WSDL
WSDL is an XML-based language for locating and
describing Web services.
• WSDL stands for Web Services Description Language
• WSDL is based on XML
• WSDL is used to describe Web services
• WSDL is used to locate Web services
• WSDL is a W3C standard
WSDL document structure
The main structure of a WSDL document looks like this:
<definitions>

<types>
data type definitions........
</types>
<message>
definition of the data being communicated....
</message>

<portType>
set of operations......
</portType>
<binding>
protocol and data format specification....
</binding>

</definitions>
A WSDL document can also contain other elements, like extension elements, and a service element that makes it
possible to group together the definitions of several web services in one single WSDL document.
Example: WSDL document
<message name="getTermRequest">
<part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="getTerm">
<input message="getTermRequest"/>
<output message="getTermResponse"/>
</operation>
</portType>
UDDI
UDDI is a directory service where companies can
register and search for Web services.
• UDDI stands for Universal Description, Discovery
and Integration
• UDDI is a directory for storing information about
web services
• UDDI is a directory of web service interfaces
described by WSDL
• UDDI communicates via SOAP
• UDDI is built into the Microsoft .NET platform
REST
REST
•
•
•
•
•
•
•
•

XML
HTTP
URIs
Soap has a single front door, REST has URIs
Resource based, each with it's own URI
Requests are GETs and responses are XML
No request body, no SOAP envelope
SOAP only does GET and POST, REST does GET, POST,
PUT, DELETE (and others)
Key component of a REST architecture
• Resources, which are identified by logical URLs.
Both state and functionality are represented using resources.
– The logical URLs imply that the resources are universally
addressable by other parts of the system.
– Resources are the key element of a true RESTful design,
as opposed to "methods" or "services" used in RPC and
SOAP Web Services, respectively. You do not issue a
"getProductName" and then a "getProductPrice" RPC calls
in REST; rather, you view the product data as a resource -and this resource should contain all the required
information (or links to it).
Key component of a REST architecture
• A web of resources, meaning that a single resource should
not be overwhelmingly large and contain too fine-grained
details. Whenever relevant, a resource should contain links to
additional information -- just as in web pages.
• The system has a client-server, but of course one
component's server can be another component's client.
• There is no connection state; interaction is stateless (although
the servers and resources can of course be stateful). Each new
request should carry all the information required to complete
it, and must not rely on previous interactions with the same
client.
Key component of a REST architecture
• Resources should be cachable whenever possible (with an
expiration date/time). The protocol must allow the server to
explicitly specify which resources may be cached, and for how
long.
– Since HTTP is universally used as the REST protocol, the
HTTP cache-control headers are used for this purpose.
– Clients must respect the server's cache specification for
each resource.
• Proxy servers can be used as part of the architecture, to
improve performance and scalability. Any standard HTTP
proxy can be used.
REST: Request Example
• REST Request is often just a URL
http://www.acme.com/phonebook/UserDetails?firstName=John&lastName=Doe

or
http://www.acme.com/phonebook/UserDetails/firstName/John/lastName/Doe

• While REST services might use XML in
their responses (as one way of organizing structured
data), REST requests rarely use XML.
REST: Response Example
• Response is usually XML or JSON
<person>
<firstName>John</firstName>
<lastName>Doe</lastName>
<age>25</age>
<address>
<streetAddress>21 2nd Street</streetAddress>
<city>New York</city>
<state>NY</state>
<postalCode>10021</postalCode>
</address>
<phoneNumbers>
<phoneNumber type="home">212 555-1234</phoneNumber>
<phoneNumber type="fax">646 555-4567</phoneNumber>
</phoneNumbers>
</person>
That, in a nutshell, is it
What we covered
•
•
•
•

Web services architecture
Web services definitions and terms
How Web Services work
Overview and examples of SOAP and RESTful
Web Services
Questions?

Overview of java web services

  • 1.
  • 2.
    Introduction • Who amI? – Worked for TSB for 13+ years as FNA – October 2012 moved to ITSO – TSB and ITSO was kind enough to send me to San Antonio with Sean, Vicky and Tony
  • 3.
    What we willbe covering • • • • Web services architecture Web services definitions and terms How Web Services work Overview and examples of SOAP and RESTful Web Services
  • 4.
    What we won’tbe covering • Java programming • How to functional test Web Services
  • 5.
    What are WebServices? “A piece of software that provides some useful functionality by a programmatic interface that is available via the standard protocols of the Internet.”
  • 6.
    What are WebServices? • • • • Application components Use open protocols Self-contained and self-describing Can be discovered using Universal Description Discovery and Integration (UDDI) • Can be used by other applications • Allows data exchange between different applications and different platforms
  • 7.
    Web Services Platform • • • • • • Lotsof confusion 2 general types of Web Services – SOAP and REST SOAP is a protocol, REST is an architecture style Can have many overlaps Usually over HTTP Usually uses XML (or JSON)
  • 8.
    How do WebServices work? CGI Web Application Browser HTML Web Service Client (Phone App) Web Service Web Service Web Service Provider Database
  • 9.
  • 10.
    SOAP… • • • • • • • • • Stands for SimpleObject Access Protocol Is a communication protocol Is a format for sending messages Is designed to communicate via the Internet Is platform and language independent Is based on XML Is simple and extensible Allows you to get around firewalls Is a W3C standard
  • 11.
    SOAP building blocks ASOAP message is an ordinary XML document containing the following elements: • An Envelope element that identifies the XML document as a SOAP message • A Header element that contains header information • A Body element that contains call and response information • A Fault element containing errors and status information
  • 12.
    SOAP syntax rules •A SOAP message MUST be encoded using XML • A SOAP message MUST use the SOAP Envelope namespace • A SOAP message MUST use the SOAP Encoding namespace • A SOAP message must NOT contain a DTD reference • A SOAP message must NOT contain XML Processing Instructions • SOAP request could be an HTTP POST or HTTP GET
  • 13.
    Example: A SOAPRequest POST /InStock HTTP/1.1 Host: www.example.org Content-Type: application/soap+xml; charset=utf-8 Content-Length: nnn <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Body xmlns:m="http://www.example.org/stock"> <m:GetStockPrice> <m:StockName>IBM</m:StockName> </m:GetStockPrice> </soap:Body> </soap:Envelope>
  • 14.
    Example: A SOAPResponse HTTP/1.1 200 OK Content-Type: application/soap+xml; charset=utf-8 Content-Length: nnn <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Body xmlns:m="http://www.example.org/stock"> <m:GetStockPriceResponse> <m:Price>34.5</m:Price> </m:GetStockPriceResponse> </soap:Body> </soap:Envelope>
  • 15.
    WSDL WSDL is anXML-based language for locating and describing Web services. • WSDL stands for Web Services Description Language • WSDL is based on XML • WSDL is used to describe Web services • WSDL is used to locate Web services • WSDL is a W3C standard
  • 16.
    WSDL document structure Themain structure of a WSDL document looks like this: <definitions> <types> data type definitions........ </types> <message> definition of the data being communicated.... </message> <portType> set of operations...... </portType> <binding> protocol and data format specification.... </binding> </definitions> A WSDL document can also contain other elements, like extension elements, and a service element that makes it possible to group together the definitions of several web services in one single WSDL document.
  • 17.
    Example: WSDL document <messagename="getTermRequest"> <part name="term" type="xs:string"/> </message> <message name="getTermResponse"> <part name="value" type="xs:string"/> </message> <portType name="glossaryTerms"> <operation name="getTerm"> <input message="getTermRequest"/> <output message="getTermResponse"/> </operation> </portType>
  • 18.
    UDDI UDDI is adirectory service where companies can register and search for Web services. • UDDI stands for Universal Description, Discovery and Integration • UDDI is a directory for storing information about web services • UDDI is a directory of web service interfaces described by WSDL • UDDI communicates via SOAP • UDDI is built into the Microsoft .NET platform
  • 19.
  • 20.
    REST • • • • • • • • XML HTTP URIs Soap has asingle front door, REST has URIs Resource based, each with it's own URI Requests are GETs and responses are XML No request body, no SOAP envelope SOAP only does GET and POST, REST does GET, POST, PUT, DELETE (and others)
  • 21.
    Key component ofa REST architecture • Resources, which are identified by logical URLs. Both state and functionality are represented using resources. – The logical URLs imply that the resources are universally addressable by other parts of the system. – Resources are the key element of a true RESTful design, as opposed to "methods" or "services" used in RPC and SOAP Web Services, respectively. You do not issue a "getProductName" and then a "getProductPrice" RPC calls in REST; rather, you view the product data as a resource -and this resource should contain all the required information (or links to it).
  • 22.
    Key component ofa REST architecture • A web of resources, meaning that a single resource should not be overwhelmingly large and contain too fine-grained details. Whenever relevant, a resource should contain links to additional information -- just as in web pages. • The system has a client-server, but of course one component's server can be another component's client. • There is no connection state; interaction is stateless (although the servers and resources can of course be stateful). Each new request should carry all the information required to complete it, and must not rely on previous interactions with the same client.
  • 23.
    Key component ofa REST architecture • Resources should be cachable whenever possible (with an expiration date/time). The protocol must allow the server to explicitly specify which resources may be cached, and for how long. – Since HTTP is universally used as the REST protocol, the HTTP cache-control headers are used for this purpose. – Clients must respect the server's cache specification for each resource. • Proxy servers can be used as part of the architecture, to improve performance and scalability. Any standard HTTP proxy can be used.
  • 24.
    REST: Request Example •REST Request is often just a URL http://www.acme.com/phonebook/UserDetails?firstName=John&lastName=Doe or http://www.acme.com/phonebook/UserDetails/firstName/John/lastName/Doe • While REST services might use XML in their responses (as one way of organizing structured data), REST requests rarely use XML.
  • 25.
    REST: Response Example •Response is usually XML or JSON <person> <firstName>John</firstName> <lastName>Doe</lastName> <age>25</age> <address> <streetAddress>21 2nd Street</streetAddress> <city>New York</city> <state>NY</state> <postalCode>10021</postalCode> </address> <phoneNumbers> <phoneNumber type="home">212 555-1234</phoneNumber> <phoneNumber type="fax">646 555-4567</phoneNumber> </phoneNumbers> </person>
  • 26.
    That, in anutshell, is it
  • 27.
    What we covered • • • • Webservices architecture Web services definitions and terms How Web Services work Overview and examples of SOAP and RESTful Web Services
  • 28.

Editor's Notes

  • #17 A WSDL document describes a web service using these major elements:ElementDescription&lt;types&gt;A container for data type definitions used by the web service&lt;message&gt;A typed definition of the data being communicated&lt;portType&gt;A set of operations supported by one or more endpoints&lt;binding&gt;A protocol and data format specification for a particular port type
  • #18 In this example the &lt;portType&gt; element defines &quot;glossaryTerms&quot; as the name of a port, and &quot;getTerm&quot; as the name of an operation.The &quot;getTerm&quot; operation has an input message called &quot;getTermRequest&quot; and an output messagecalled &quot;getTermResponse&quot;.The &lt;message&gt; elements define the parts of each message and the associated data types.Compared to traditional programming, glossaryTerms is a function library, &quot;getTerm&quot; is a function with &quot;getTermRequest&quot; as the input parameter, and getTermResponse as the return parameter.