The web service protocols - Revision history

217.230.233.188 at 00:09, 25 January 2005

2005-01-25T00:09:06Z

← Older revision		Revision as of 00:09, 25 January 2005
Line 118:		Line 118:
	</operation>		</operation>
	</binding>		</binding>

			== UDDI ==

			The “'''U'''niversal '''D'''escription, '''D'''iscovery and '''I'''ntegration” Protocol describes a standard for publishing and discovering web services. Though from a J2EE perspective, the protocol is not considered as fundamental as SOAP and WSDL, it is still a constituent of web services.

			You can imagine UDDI as a registry containing white (identification by the company’s name), yellow (searching by business/product category) and green pages (look up using technical entities). The registry itself is a web service which can be accessed, searched and updated via SOAP messages.

217.230.205.245 at 00:06, 25 January 2005

2005-01-25T00:06:13Z

← Older revision		Revision as of 00:06, 25 January 2005
Line 103:		Line 103:
	'''Single input''': Can be used for asynchronous messaging to send XML documents; just a single input is defined.		'''Single input''': Can be used for asynchronous messaging to send XML documents; just a single input is defined.

	<binding name =~~„TaxiAgentBinding“~~ type=~~„taxi~~:~~TaxiAgent“~~>		<binding name ="TaxiAgentBinding" type="taxi:TaxiAgent">
	<soap: binding style = ~~„rpc“~~		<soap: binding style = "rpc"
	transport=~~„http~~.//schemas.xmlsoap.org/soap/~~http“~~/>		transport="http.//schemas.xmlsoap.org/soap/http"/>
	<operation name=~~„makeReservation“~~>		<operation name="makeReservation">
	<soap:operation soapAction=„“ />		<soap:operation soapAction="" />
	<input>		<input>
	<soap:body use=~~„literal“~~		<soap:body use="literal"
	namespace=~~„http~~://www.taxi.com/~~TaxiAgent“~~/>		namespace="http://www.taxi.com/TaxiAgent"/>
	</input>		</input>
	<output>		<output>
	<soap:body use=~~„literal“~~		<soap:body use="literal"
	namespace=~~„http~~://www.taxi.com/~~TaxiAgent“~~/>		namespace="http://www.taxi.com/TaxiAgent"/>
	</output>		</output>
	</operation>		</operation>
	</binding>		</binding>

217.230.205.245 at 00:02, 25 January 2005

2005-01-25T00:02:24Z

← Older revision		Revision as of 00:02, 25 January 2005
Line 90:		Line 90:
	</xsd:schema>		</xsd:schema>
	</types>		</types>

			=== <portType> ===

			Describes the web service operations (Java methods) that are available.

			The element '''<operation>''' declares the method, '''<input>''' and '''<output>''' refer to the parameters declared in the <message> part. SOAP error messages (analogously to Java exceptions) can be expressed by the '''<fault>''' element.

			You can distinguishes different '''messaging styles''':

			'''Request/Response''': the <operation> element contains a single input and output element, eventually fault element.

			'''Single input''': Can be used for asynchronous messaging to send XML documents; just a single input is defined.

			<binding name =„TaxiAgentBinding“ type=„taxi:TaxiAgent“>
			<soap: binding style = „rpc“
			transport=„http.//schemas.xmlsoap.org/soap/http“/>
			<operation name=„makeReservation“>
			<soap:operation soapAction=„“ />
			<input>
			<soap:body use=„literal“
			namespace=„http://www.taxi.com/TaxiAgent“/>
			</input>
			<output>
			<soap:body use=„literal“
			namespace=„http://www.taxi.com/TaxiAgent“/>
			</output>
			</operation>
			</binding>

217.230.233.188 at 23:58, 24 January 2005

2005-01-24T23:58:06Z

← Older revision		Revision as of 23:58, 24 January 2005
Line 72:		Line 72:
	<part name="reservationId" type="xsd:string" />		<part name="reservationId" type="xsd:string" />
	</message>		</message>

			=== <types> ===

			Allows to declare complex types. Other parts of the WSDL document as well as different WSDL documents can refer to them.

			<types>
			<xsd:schema
			targetNamespace="http://www.taxi.com/TaxiAgent">
			<xsd:complexType name="ReservationType">
			<xsd:sequence>
			<xsd:element name="taxiId" type="xsd:int"/>
			<xsd:element name="carId" type="xsd:int"/>
			<xsd:element name="customerId" type="xsd:int"/>
			<xsd:element name="price" type="xsd:double"/>
			</xsd:sequence>
			</xsd:complexType>
			</xsd:schema>
			</types>

217.230.233.188 at 23:53, 24 January 2005

2005-01-24T23:53:23Z

← Older revision		Revision as of 23:53, 24 January 2005
Line 63:		Line 63:
	Definition of parameters and return values.		Definition of parameters and return values.

	<message name =~~„RequestMessage“~~>		<message name ="RequestMessage">
	<part name=~~„taxiId“~~ type=~~„xsd~~:~~int“~~ />		<part name="taxiId" type="xsd:int" />
	<part name=~~„customerId“~~ type=~~„xsd~~:~~int“~~/>		<part name="customerId" type="xsd:int"/>
	<part name=~~„carId“~~ type=~~„xsd~~:~~int“~~/>		<part name="carId" type="xsd:int"/>
	<part name=~~„price“~~ type=~~„xsd~~:~~double“~~/>		<part name="price" type="xsd:double"/>
	</message>		</message>
	<message name=~~„ResponseMessage“~~>		<message name="ResponseMessage">
	<part name=~~„reservationId“~~ type=~~„xsd~~:~~string“~~ />		<part name="reservationId" type="xsd:string" />
	</message>		</message>

217.230.233.188 at 23:52, 24 January 2005

2005-01-24T23:52:03Z

← Older revision		Revision as of 23:52, 24 January 2005
Line 58:		Line 58:
	targetNamespace="http://www.taxi.com/TaxiAgent"		targetNamespace="http://www.taxi.com/TaxiAgent"
	...		...

			=== <message> ===

			Definition of parameters and return values.

			<message name =„RequestMessage“>
			<part name=„taxiId“ type=„xsd:int“ />
			<part name=„customerId“ type=„xsd:int“/>
			<part name=„carId“ type=„xsd:int“/>
			<part name=„price“ type=„xsd:double“/>
			</message>
			<message name=„ResponseMessage“>
			<part name=„reservationId“ type=„xsd:string“ />
			</message>

217.230.205.245 at 23:50, 24 January 2005

2005-01-24T23:50:27Z

← Older revision		Revision as of 23:50, 24 January 2005
Line 34:		Line 34:
	</env:Body>		</env:Body>
	</env:Envelope>		</env:Envelope>


			== WSDL ==

			WSDL stands for '''W'''eb '''S'''ervice '''D'''escription '''L'''anguage. As the name already indicates, it is a XML markup language that describes a Web Service. Comparable to the IDL (Interface Definition Language) in CORBA, it can be used for generating web services interfaces, stubs and deployment information.

			Just like the advantage of SOAP is its independence of transfer protocols, programming language and platform, WSDL promises to be protocol agnostic. Though wsdl files are normally generated automatically by tools such as AXIS, bugs and deployment problems force developers to understand the different WSDL pieces.

			A WSDL document itself comprises the elements described in the following.

			=== <definitions> ===

			This element is the root element. It declares all needed namespaces.

			The default namespace is the WSDL Schema. Furthermore, the prefix “soap” is assigned to the SOAP Schema and “xsd” to the XML Schema Language. Therefore, you can integrate SOAP relevant elements and the XML Schema elements (e.g. <complexType> in the wsdl document. Finally the wsdl schema itself needs an identifier, which is declared with the targetNamespace attribute.

			<? xml version = '1.0'?>
			<definitions name = "TaxiAgent"
			xmlns="http://schemas.xmlsoap.org/wsdl/"
			xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema"
			xmlns:titan="http://www.taxi.com/TaxiAgent"
			targetNamespace="http://www.taxi.com/TaxiAgent"
			...

217.230.233.188 at 23:41, 24 January 2005

2005-01-24T23:41:08Z

← Older revision		Revision as of 23:41, 24 January 2005
Line 1:		Line 1:

	== SOAP ==		== SOAP ==

Line 12:		Line 11:
	Originally, SOAP was accomplished to transfer messages via http and therefore take advantage of the internet. (Firewalls and proxi servers normally do not block http traffic via port 80) Nevertheless, SOAP can be used with other protocols such as ftp, smtp as well.		Originally, SOAP was accomplished to transfer messages via http and therefore take advantage of the internet. (Firewalls and proxi servers normally do not block http traffic via port 80) Nevertheless, SOAP can be used with other protocols such as ftp, smtp as well.

	'''A SOAP message ~~can be seen as~~...'''		'''A SOAP message is...'''

	* an ordinary XML document, which integrates the SOAP XML Schema by using namespaces.		* an ordinary XML document, which integrates the SOAP XML Schema by using namespaces.

217.230.205.245 at 23:40, 24 January 2005

2005-01-24T23:40:17Z

New page

== SOAP ==

'''SOAP is...'''

* the abbreviation for '''S'''imple '''O'''bject '''A'''ccess '''P'''rotocol
The protocol serves as a distributed object protocol such as RMI or CORBA-IIOP. Thus, whereas RMI is based on the Java platform, and CORBA-IIOP requires the CORBA infrastructure to exchange messages, SOAP is platform and language independent.

* a standard, proposed to the W3C consortium in May 2000 by companies like Ariba, HQ, IBM, Microsoft

* an opportunity to support different transport protocols.
Originally, SOAP was accomplished to transfer messages via http and therefore take advantage of the internet. (Firewalls and proxi servers normally do not block http traffic via port 80) Nevertheless, SOAP can be used with other protocols such as ftp, smtp as well.

'''A SOAP message can be seen as...'''

* an ordinary XML document, which integrates the SOAP XML Schema by using namespaces.

It consists of three basic elements:

'''<envelope>''': Root, identifies XML documents as a SOAP message

'''<header>''': (optional) infrastructure data

'''<body>''': application data

<?xml version='1.0' encoding='UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header />
<env:Body>
<reservation xmlns="http://www.taxi.com/TaxiReservation">
<customer>
...
</customer>
</reservation>
</env:Body>
</env:Envelope>