1. Garsc ogolnikow

Do dokladnie daje WSDL:

• opisuje jakie uslugi sa udostepniane przez Web Serwis
• jak wywolywac jego operacje
• gdzie znalezc Web Serwis

Ponieważ WSDL jest abstrakcyjnym opisem interfejsow Web Serwisu możliwe jest obecnie zarówno czesciowe wygenerowanie kodu implementacji Web Serwisu o ile dane sa definicje WSDL, jak i wygenerowanie definicji WSDL jeśli dany jest kod implementujacy Web Serwis.

Podobno lepiej jest najpierw budowac podstawowa, dzialajaca implementacje , a nastepnie przy uzyciu odpowiednich narzedzi wygenerowac definicje WSDL. Przykladowe narzedzia, które udostepniaja taka funkcjinalnosc to np. BEA’s WebLogic Server 6.1 (umozliwia utworzenie EJD lub JMS miejsca przeznaczenia i udostepnia skrypty Ant do utworzenia WSDL ‘a skojarzonego z implementacja) lub Systinet WASP, IBM ‘s Web Services Toolkit.

2. Opis struktury dokumentu WSDL

<definitions>

<import>*

<types>

<schema></schema>*

</types>

<message>*

<part></part>*

</message>

<PortType>*

<operation>*

<input></input>

<output></output>

<fault></fault>*

</operation>

</PortType>

<binding>*

<operation>*

<input></input>

<output></output>

</operation>

</binding>

<service>*

<port></port>*

</service>

</definitions>

<definitions

targetNamespace=”urn:3950”

xmlns:tns=”urn:3950”

>

Nie wszystkie uzyte URI sa prawdziwe (dostepne w sieci) i wskazuja na dokumenty XML Schema nie dostepne w Internecie.

Atrybut targetNamespace definiuje przestrzen nazw, która tworzy ten dokument.

<definitions

targetNamespace=”urn:3950”

xmlns:tns=”urn:3950”

>

Element <types> zawiera zero lub wiecej podelementow <schema>, które musza stosowac się do regul dotyczacych dokumentow XML Schema.

<types>

<xsd:element name=”PDU” type=”PDU”/>

<xsd:complexType name=”PDU”>

<xsd:choice>

<xsd:element name=”initRequest” type=”InitializeRequest” />

<xsd:element name=”initResponse” type=”InitializeResponse” />

<xsd:element name=”searchRequest” type=”SearchRequest” />

<xsd:element name=”searchResponse” type=”SearchResponse” />

<xsd:element name=”presentRequest” type=”PresentRequest” />

<xsd:element name=”presentResponse” type=”PresentResponse” />

<xsd:element name=”deleteResultSetRequest”

type=”DeleteResultSetRequest” />

<xsd:element name=”deleteResultSetResponse”

type=”DeleteResultSetResponse” />

<xsd:element name=”accessControlRequest”

type=”AccessControlRequest” />

<xsd:element name=”accessControlResponse”

type=”AccessControlResponse” />

<xsd:element name=”resourceControlRequest”

type=”ResourceControlRequest” />

<xsd:element name=”resourceControlResponse”

type=”ResourceControlResponse” />

<xsd:element name=”triggerResourceControlRequest”

type=”TriggerResourceControlRequest” />

<xsd:element name=”resourceReportRequest”

type=”ResourceReportRequest” />

<xsd:element name=”resourceReportResponse”

type=”ResourceReportResponse” />

<xsd:element name=”scanRequest” type=”ScanRequest” />

<xsd:element name=”scanResponse” type=”ScanResponse” />

<xsd:element name=”sortRequest” type=”SortRequest” />

<xsd:element name=”sortResponse” type=”SortResponse” />

<xsd:element name=”segmentRequest” type=”Segment” />

<xsd:element name=”extendedServicesRequest”

type=”ExtendedServicesRequest” />

<xsd:element name=”extendedServicesResponse”

type=”ExtendedServicesResponse” />

<xsd:element name=”close” type=”Close” />

</xsd:choice>

</xsd:complexType>

<xsd:restriction base=”xsd:string”>

<xsd:enumeration value=”character” />

<xsd:enumeration value=”word” />

<xsd:enumeration value=”sentence” />

<xsd:enumeration value=”paragraph” />

<xsd:enumeration value=”section” />

<xsd:enumeration value=”chapter” />

<xsd:enumeration value=”document” />

<xsd:enumeration value=”element” />

<xsd:enumeration value=”subelement” />

<xsd:enumeration value=”elementType” />

<xsd:enumeration value=”byte” />

</xsd:restriction>

</xsd:simpleType>

Przykład:

<message name=”soapHeader”>

<part type=”xsd:string” name=”id”/>

<part type=”xsd:string” name=”timeout”/>

</message>

• Request-response – port otrzymuje zadanie i odsyla wynik (<input>, <output>, <fault>)

• Solicit-response – port wysyla komunikat do klienta i otrzymuje odpowiedz (<output>, <input>, <fault>)
• One-way – port otrzymuje komunikat (<input>)
• Notification – port wysyla komunikat (<output>)

Przykład:

<service name=”Oxford University Libraries”>

<documentation>

Z39.50 Server for Oxford University Libraries

</documentation>

<port name=”OLIS” binding=”ez:ez3950SOAPBinding”>

</port>

</service>

Po pierwsze nie należy definiowac zbyd duzo operacji i komunikatow – nic ponadto co jest naprawde potrzebne. Należy tez pamietac, ze WSDL nie jest kodem programu, a metadanymi dotyczacymi kodu. Nie należy dlaczac niczego, czego klient Web Serwisu nie musi wiedziec, żeby z niego skorzystac. Żeby zapewnic niezaleznosc od platformy jako system typow należy uzywac XML Schema, kiedy tylko jest to możliwe.

UDDI jest rejestrem dla Web Serwisow. Pomaga znalezc serwis oraz jego opis (WSDL). Dostarcza zestandaryzowane metody do publikowania i odkrywania informacji dotyczacych Web Serisow. Umozliwia wyszukiwanie po rodzaju prowadzonej dzialalnosci oraz wyszukiwanie po typie serwisu. Rejestr UDDI jest rozproszony pomiedzy wiele wezlow, a dane sa replikowane w wezlach. Co jest istotne, to fakt, ze specyfikacja UDDI ma wsparcie ze strony najwiekszych przedsiebiorstw, a priorytetem jest przenosnosc i latwosc adaptacji Web Serwisow.

Analityk biznesowy może uzywac UDDI jak wyszukiwarki Web Serwisow. Producenci oprogramowania uzywaja API do UDDI żeby publikowac serwisy, wyszukiwac serwisy wedlug zadanych kryteriow.

UDDI Business Registry (UBR) – koncepcyjnie jest to pojedynczy system zbudowany z wielu wezlow, których dane sa synchronizowane przy pomocy replikacji.

Oczywiście UDDI nie oznacza wylacznie UBR – możliwe sa zarownoprywatne wezly, nie bedace czescia UBR, jak i prywatne sieci wezlow, które synchronizuje się miedzy soba, ale nie oddzialuja w żaden sposób z UBR.

Produkty, które umozliwiaja utworzenie wlasnych publicznych oraz prywatnych rejestrow UDDI, to np. BEA WebLogic Server i IBM WebSphere.

Przyklady kilku komunikatow uzywanych do zdobywania informacji o przedsiebiorstwie. Wszystkie komunikaty uzywaja SOAP (UUID – universally unique identifier sluzacy do identyfikowania instancji struktur UDDI).

Wymaga Tomcat’a do zaimplementowania klienta, ale prawdopodobnie niedlugo (o ile już nie teraz) nie będzie wymagany żaden zewnetrzny serwer.

import javax.xml.registry.*;

import javax.xml.registry.infomodel.*;

import java.net.*;

import java.util.*;

/*

• This is the FindBusiness UDDI example implemented using

• the JAXR libraries and the reference implementation

• JAXR provider for accessing a UDDI registry.

*/

public class JAXRFindBusiness {

public JAXRFindBusiness( ) {}

public static void main(String[] args) {

if (args.length != 1) {

System.out.println(“Usage: java “ +

“JAXRFindBusiness <query-string>”);

System.exit(1);

}

String queryString = new String(args[0]);

System.out.println(“Query string is “ + queryString);

doQuery(queryString);

}

public static void doQuery(String qString) {

Connection conn = null;

// Define connection configuration properties // To query, you need only the query URL Properties props = new Properties( );

props.setProperty(“javax.xml.registry.queryManagerURL”,

props.setProperty(“javax.xml.registry.factoryClass”,

“com.sun.xml.registry.uddi.ConnectionFactoryImpl”);

try {

// Create the connection, passing it the

// configuration properties

ConnectionFactory factory =

ConnectionFactory.newInstance( );

factory.setProperties(props);

conn = factory.createConnection( );

// Get registry service and query manager

RegistryService rs = conn.getRegistryService( );

BusinessQueryManager bqm = rs.getBusinessQueryManager( );

// Define find qualifiers and name patterns

Collection qualifiers = new ArrayList( );

qualifiers.add(FindQualifier.SORT_BY_NAME_DESC);

Collection namePatterns = new ArrayList( );

namePatterns.add(qString);

// Find using the name

BulkResponse response =

bqm.findOrganizations(qualifiers,

namePatterns, null, null, null, null);

Collection orgs = response.getCollection( );

// Display information about the organizations found

Iterator orgIter = orgs.iterator( );

while (orgIter.hasNext( )) {

Organization org =

(Organization) orgIter.next( );

System.out.println(“Org name: “ + getName(org));

System.out.println(“Org description: “ +

getDescription(org));

System.out.println(“Org key id: “ + getKey(org));

// Display primary contact information

User pc = org.getPrimaryContact( );

if (pc != null) {

PersonName pcName = pc.getPersonName( );

System.out.println(“ Contact name: “ +

pcName.getFullName( ));

Collection phNums =

pc.getTelephoneNumbers(pc.getType( ));

Iterator phIter = phNums.iterator( );

while (phIter.hasNext( )) {

TelephoneNumber num =

(TelephoneNumber) phIter.next( );

System.out.println(“ Phone number: “ +

num.getNumber( ));

}

Collection eAddrs = pc.getEmailAddresses( );

Iterator eaIter = eAddrs.iterator( );

while (phIter.hasNext( )) {

System.out.println(“ Email Address: “ +

(EmailAddress) eaIter.next( ));

}

}

// Display service and binding information

Collection services = org.getServices( );

Iterator svcIter = services.iterator( );

while (svcIter.hasNext( )) {

Service svc = (Service) svcIter.next( );

System.out.println(“ Service name: “ +

getName(svc));

System.out.println(“ Service description: “ +

getDescription(svc));

Collection serviceBindings =

svc.getServiceBindings( );

Iterator sbIter = serviceBindings.iterator( );

while (sbIter.hasNext( )) {

ServiceBinding sb =

(ServiceBinding) sbIter.next( );

System.out.println(“ Binding “ +

“Description: “ +

getDescription(sb));

System.out.println(“ Access URI: “ +

sb.getAccessURI( ));

}

}

// Print spacer between organizations

System.out.println(“ --- “);

}

} catch (Exception e) {

e.printStackTrace( );

} finally {

// At end, close connection to registry

if (conn != null) {

try {

conn.close( );

} catch (JAXRException je) {}

}

}

}

private static String getName(RegistryObject ro) throws JAXRException {

try {

return ro.getName().getValue( );

} catch (NullPointerException npe) {

return “”;

}

}

private static String getDescription(RegistryObject ro) throws JAXRException {

try {

return ro.getDescription().getValue( );

} catch (NullPointerException npe) {

return “”;

}

}

private static String getKey(RegistryObject ro) throws JAXRException {

try {

return ro.getKey().getId( );

} catch (NullPointerException npe) {

return “”;

}

}

}

import javax.xml.registry.*;

import javax.xml.registry.infomodel.*;

import java.net.*;

import java.util.*;

/*

• This is the FindBusiness UDDI example implemented using

• the JAXR libraries and the reference implementation

• JAXR provider for accessing a UDDI registry.

*/

public class JAXRFindBusiness {

public JAXRFindBusiness( ) {}

public static void main(String[] args) {

// Parameter parsing, not entirely relevant

doQuery(queryString);

}

<tModel authorizedName=”...” operator=”...” tModelKey=”...”>

<name>HertzReserveService</name>

<description xml:lang=”en”>WSDL description of the Hertz reservation service

interface</description>

<overviewDoc>

<description xml:lang=”en”>WSDL source document.</description>

<overviewURL>http://mach3.ebphost.net/wsdl/hertz_reserve.wsdl</overviewURL>

</overviewDoc>

<categoryBag>

<keyedReference tModelKey=”uuid:C1ACF26D-9672-4404-9D70-39B756E62AB4”

keyName=”uddi-org:types” keyValue=”wsdlSpec”/>

</categoryBag>

</tModel>

URL do dokumentu WSDL opisujacego ten serwis jest zapisany jako wartosc <overviewURL>.