Web Services Registries and UDDI [email protected] INFOSYS290-3 Web Services: Concepts, Design and...

Web Services Registriesand UDDI

[email protected]

INFOSYS290-3 Web Services: Concepts, Design and Implementation

Agenda

• UDDI V3 Spec– Data structures– Standard APIs

• Mapping WSDL to UDDI• Tools

– .NET APIs for searching for services in UDDI– Systinet for publishing services to UDDI

• Extending UDDI for More Robust Information

Why Do We Need a Web Services Registry

• Web services are valuable because of standardized payloads and transport definitions– The value is creating a web service that is

used by many clients

• Can’t happen unless the services are advertised to multiple consumers

What Does UDDI Contain?

• Businesses and other service providers

• Services they expose

• Bindings (locations) of those services

• Interfaces supported by those services

UDDI Entities

• businessEntity – provider of service• businessService – collection of related services• bindingTemplate - information necessary to use • tModel - “reusable concept” such as

– Interface– Protocol used by web services– Category

• publisherAssertion - relationship that business entity has with another businessEntity

• Subscription – request to be informed of particular changes

Core UDDI Entities

businessService

businessService

Interface tModelbindingTemplate

bindingTemplate

businessEntity

bindingTemplateInterface tModel

Design Principles• Keys as unique identifiers

– Publisher assigned (new in V3)– Or generated by registry

• Containment and references– Keys inside elements are either contained entities or references to other

entities• Collections

– Simple structure (e.g. name) just listed multiple times– Complex structure has container element (e.g. contacts on business)

• Optional attributes– Empty not omitted– <keyedReference

tModelKey=”uddi:uddi.org:ubr:categorization:iso3166” keyName=””

– keyValue=”US-CA”/>

businessEntity Structure

businessEntity Identifying Elements• Uniquely identified by businessKey attribute• discoveryURLs

– <discoveryURL useType=”businessEntity”>http://www.example.com?businessKey=uddi:example.com:registry:sales:53</discoveryURL>

• Returns XML document of type businessEntity– <discoveryURL useType=”homepage”>

http://www.acmewidgets.com</discoveryURL>• name

– Multiple names to do languages or abbreviations– <businessEntity . . . >– ........– <name xml:lang="ja">日本生花店 </name>– <name xml:lang="ja">ニッポンセイカテン </name>– <name xml:lang="en">NIPPON FLOWERS </name>– <name xml:lang="en">NF</name>– .....– </businessEntity>

• description– Multiple descriptions potentially in multiple languages with xml:lang

businessEntity contacts

<

businessEntity Identifiers and Categories

• Optional IdentifierBag– <identifierBag>

<keyedReference tModelKey=”uddi:uddi.org:ubr:identifier:dnb.com:d-u-n-s” keyName=”SAP AG”

• keyValue=”31-626-8655” />– </identifierBag>

• Optional CategoryBag– <categoryBag>

<keyedReference tModelKey=”uddi:uddi.org:ubr:categorization:iso3166” keyName=”California, USA”

– keyValue=”US-CA” />– </categoryBag>

UDDI Keyed References

• tModelKey – – Required reference to tModel representing the

identifier system (e.g. company identifier codes, geographical categories)

• keyName– Optional description of the identifier

• keyValue– Required identifier within the overall system

Keyed Reference Groups• <keyedReferenceGroup

tModelKey=”uddi:uddi.org:ubr:categorizationGroup:wgs84” > <keyedReference tModelKey=”uddi:uddi.org:ubr:categorization:wgs84:latitude” keyName=”WGS 84 Latitude”

• keyValue=”+49.682700” />• <keyedReference

tModelKey=”uddi:uddi.org:ubr:categorization:wgs84:longitude” keyName=”WGS 84 Longitude”

• keyValue=”+008.295200” />• </keyedReferenceGroup>

businessService

businessService

• Uniquely identified by optional serviceKey attribute– Supplied by UDDI if not supplied by publisher

• Optional descriptions

• Optional categorizations in categoryBag

• One or more bindingTemplates

• Optional digital signature

bindingTemplates

bindingTemplate

• Uniquely identified by optional bindingKey attribute

• Optional serviceKey identifies service that contains this bindingTemplate

• descriptions• accessPoint - network address (URL)• hostingRedirector – deprecated• categoryBag – e.g. can indicate that given

template if status of “test” or production”• tModelInstanceDetails -

tModelInstance Details

overviewDoc

tModels

• The “technical fingerprint”– tModel’s define unique identifiers for interfaces and interface

specifications– Once tModel is published service advertises compliance with the

spec represented by including the correct tModelKey

• Value sets– Categorization hierarchies– E.g. categoryBag and identifierBag have references to tModels

with the system of values

• Find qualifiers– find_business uddi:uddi.org:findqualifier:sortbydateasc

tModel Structure

tModel Structure

• Exactly one non-empty name• Zero or more descriptions• Zero or more overviewDocs

– useType=text– useType=wsdlInterface

• identifierBag– Contains tModelKey which uniquely identifies tModel

(inconsistent?)– Other logical identifiers

• categoryBag– list of categories that describe specific aspects of the tModel

UDDI Keys

• Domain keys– uddi:acmewidgets.com

• UUID keys– uddi:4CD7E4BC-648B-426D-9936-

443EAAC8AE23

• Derived keys– uddi:tempuri.com:fish:buyingservice

• Key generator keys– Uddi:acmewidgets.com:keygenerator

UDDI Standard APIs

UDDI APIs

• Inquiry

• Publication

• Subscription

• Security

• Custody Transfer

• Replication

Inquiry API Patterns

• Browse– find_xx

• Drill-down– Use browse then drill-down– get_xx

• Invocation– Use browse and drilldown and get

bindingTemplate– Invoke from bindingTemplate

Inquiry API Functions

• find_binding

• find_business

• find_relatedBusinesses

• find_service

• find_tModel

• get_bindingDetail

• get_businessDetail

• get_operationalInfo

• get_serviceDetail

• get_tModelDetail

find_binding

find_business

Find_business example• <find_business xmlns="urn:uddi-org:api_v3">

<findQualifiers> <findQualifier> uddi:uddi.org:findqualifier:approximatematch </findQualifier> <findQualifier> uddi:uddi.org:findqualifier:combinecategorybags </findQualifier> </findQualifiers> <categoryBag> <keyedReference keyValue="34.10.%" tModelKey="uddi:uddi.org:ubr:categorization:unspsc"/> </categoryBag></find_business>

find_service

find_tModel

find_tModel Example

<find_tModel xmlns="urn:uddi-org:api_v3"> <findQualifiers> <findQualifier>

uddi:uddi.org:findqualifier:caseinsensitivematch </findQualifier> <findQualifier> uddi:uddi.org:findqualifier:approximatematch </findQualifier> </findQualifiers> <name>rosetta%</name></find_tModel>

Combined Searches<find_business xmlns="urn:uddi-org:api_v3">

<findQualifiers> <findQualifier> uddi:uddi.org:findqualifier:sortbynameasc </findQualifier> <findQualifier> uddi:uddi.org:sortorder:uts-10 </findQualifier> <findQualifier> uddi:uddi.org:findqualifier:orallkeys </findQualifier> </findQualifiers>  <tModelBag> <tModelKey>uddi:some.specific.example:tmodelkey</tModelKey> </tModelBag>  <find_tModel xmlns="urn:uddi-org:api_v3"> <findQualifiers> <findQualifier> uddi:uddi.org:findqualifier:approximatematch </findQualifier> <findQualifier> uddi:uddi.org:findqualifier:caseinsensitivematch </findQualifier> <findQualifier> uddi:uddi.org:sortorder:uts-10 </findQualifier> </findQualifiers> <name>Rosetta%</name> </find_tModel></find_business>

Publication API

• save_binding

• save_business

• save_service

• save_tModel

• Delete_xx

• Xx_publisherAssertions

UDDI Tools

UDDI Registries

• UBR– Microsoft

• Uddi.microsoft.com

– IBM• https://uddi.ibm.com/ubr/registry.html

– SAP– NTT

• Systinet– http://www.systinet.com/uddi/web

https://uddi.ibm.com/ubr/registry.html

http://www.systinet.com/uddi/web

Searching for Web Services

Publishing a Web Service

Connecting to UDDI with .NETpublic UddiConnection InitializeConnection() {

string szInquiry = "http://test.uddi.microsoft.com/inquire"; string szPublish = "https://test.uddi.microsoft.com/publish"; string szExtension = "http://test.uddi.microsoft.com/extension.asmx"; string szUsername = null; string szPassword = null; UddiConnection oConnection = null; try {

oConnect = new UddiConnection(szInquiry, szPublish, szExtension, szUsername, szPassword); System.Net.IWebProxy oProxy =

System.Net.WebProxy("http://someproxy:80",true); oConnect.AutoGetAuthToken = true; oConnect.HttpClient.Proxy = oProxy; GetAuthToken oGetToken = new GetAuthToken(szUsername, szPassword);

oConnect.AuthInfo = oGetToken.Send(oConnect); } catch(InvalidUrlPassedException oUddiEx) {

// Insert exception-handling code. return null;

} catch(UddiException oUddiEx) {

// Insert exception-handling code. return null;

} return oConnect;

}

Finding Businesses with .NETusing Microsoft.Uddi;

try {

// Create a connection to the UDDI node that is to be accessed.UddiConnection myConn = new UddiConnection("http://test.uddi.microsoft.com/inquire");

// Create an object to find a business.FindBusiness fb = new FindBusiness("Fabrikam");

// Send the prepared FindBusiness request over the connection.BusinessList bizList = fb.Send(myConn);

// Report the summary result.Console.WriteLine("Found " + bizList.BusinessInfos.Count + " businesses");}catch (Microsoft.Uddi.UddiException e){ Console.WriteLine("UDDI error: " + e.Message); }catch (Exception gen){ Console.WriteLine("General exception: {0}", gen.Message);

}

Publishing with .NET • UddiConnection myConn = new

UddiConnection(InquireTextbox.Text,PublishTextBox.Text);• myConn.AuthenticationMode =

AuthenticationMode.UddiAuthentication;• myConn.Username = UserTextbox.Text;• myConn.Password = PasswordTextbox.Text;

• // Create a named business entity.• BusinessEntity myBiz = new

BusinessEntity(BusinessNameTextbox.Text);

• // Use business entity to create an object to save a business.• SaveBusiness sb = new SaveBusiness(myBiz);

• // Send the prepared save business request.• BusinessDetail savedBiz = sb.Send(myConn);

• ReturnBiz.Text= savedBiz.BusinessEntities[0].Names[0].Text;• ReturnKey.Text=savedBiz.BusinessEntities[0].BusinessKey;

Finding Services with .NETtry {

UddiConnection conn = new UddiConnection("http://localhost/uddi/inquire.asmx");

FindService fs = new FindService(“holdem odds”);

ServiceList servList = fs.Send(conn); // Display the service name and unique identifying key.

foreach (ServiceInfo servInfo in servList.ServiceInfos) { MessageBox.Show("Service: " + servInfo.Names[0].Text + " " + servInfo.ServiceKey);

} } catch (Microsoft.Uddi.UddiException ex) {

MessageBox.Show("UDDI Exception: " + ex.Message); } catch (Exception gen) {

MessageBox.Show("General Exception: " + gen.Message); }

Finding Bindings and Connecting

//servicekey= xxxx;Tmodelkey=xxxx;

Microsoft.Uddi.Inquire.Url = “uddi.microsoft.com”; bindingSearcher = new Microsoft.Uddi.FindBinding();//bindingSearcher.ServiceKey=servicekey;bindingSearcher.TModelKeys.Add(tmodelkey);Microsoft.Uddi.BindingDetail details = bindingSearcher.Send(); string[] urllist=new string[details.BindingTemplates.Count]; for(int x=0;x<details.BindingTemplates.Count;x++)

{ if(details.BindingTemplates[x].AccessPoint.URLType==Microsoft.Uddi.Api.URL Type.Http||

details.BindingTemplates[x].AccessPoint.URLType==Microsoft.Uddi.Api.URLType.Https) {

localhost.pokerodds po = new localhost.pokerodds();po.Url = accessPoint; percentage = po.AfterFlopDraw(14

}}

Mapping WSDL to UDDI

• UDDI technote (V2.0 in August 2003) regarding– How to take about WSDL objects and store

them in UDDI equivalents– Enables queries on WSDL constituents

(portTypes, operations, ports)

Overview

Wsdl:portType->uddi:tModel

WSDL UDDI

portType tModel (categorized as portType)

Namespace of portType keyedReference in categoryBag

Local name of portType tModel Name

Location of WSDL Document

overviewURL

portType->tModel• <tModel tModelKey="uuid:e8cf1163-8234-4b35-865f-94a7322e40c3" >• <name>• StockQuotePortType• </name>• <overviewDoc>• <overviewURL>• http://location/sample.wsdl• <overviewURL>• <overviewDoc>• <categoryBag>• <keyedReference • tModelKey="uuid:d01987d1-ab2e-3013-9be2-2a66eb99d824"• keyName="portType namespace" • keyValue="http://example.com/stockquote/" />• <keyedReference • tModelKey="uuid:6e090afa-33e5-36eb-81b7-

1ca18373f457"• keyName="WSDL type" • keyValue="portType" />• </categoryBag>• </tModel>

WSDL Binding to UDDI tModel

WSDL UDDI

binding tModel (categorized as binding and wsdlSpec)

Namespace of binding keyedReference in categoryBag

Local name of binding tModel Name

Location of WSDL Document

overviewURL

portType reference and protocol references

keyedReferences in category bag

• <tModel tModelKey="uuid:49662926-f4a5-4ba5-b8d0-32ab388dadda">• <name>StockQuoteSoapBinding</name>• <overviewDoc>• <overviewURL>• http://location/sample.wsdl• </overviewURL>• </overviewDoc>• <categoryBag>• <keyedReference • tModelKey="uuid:d01987d1-ab2e-3013-9be2-2a66eb99d824"• keyName="binding namespace" • keyValue="http://example.com/stockquote/" />• <keyedReference • tModelKey="uuid:6e090afa-33e5-36eb-81b7-1ca18373f457"• keyName="WSDL type" • keyValue="binding" />• <keyedReference • tModelKey="uuid:082b0851-25d8-303c-b332-f24a6d53e38e" • keyName="portType reference"• keyValue="uuid:e8cf1163-8234-4b35-865f-94a7322e40c3" />• <keyedReference • tModelKey="uuid:4dc74177-7806-34d9-aecd-33c57dc3a865" • keyName="SOAP protocol"• keyValue= "uuid:aa254698-93de-3870-8df3-a5c075d64a0e" />• <keyedReference • tModelKey="uuid:e5c43936-86e4-37bf-8196-1d04b35c0099" • keyName="HTTP transport"• keyValue=" uuid:68DE9E80-AD09-469D-8A37-088422BFBC36" />• <keyedReference • tModelKey="uuid:c1acf26d-9672-4404-9d70-39b756e62ab4" • keyName="uddi-org:types"• keyValue="wsdlSpec" />• </categoryBag>• </tModel>

WSDL Service to UDDI Business Service

WSDL UDDI

Service businessService (categorized as service)

Namespace of Service keyedReference in categoryBag

Local Name of Service keyedReference in categoryBag; optionally also the name of the service

WSDL Port to UDDI bindingTemplate

WSDL UDDI

port bindingTemplate

Namespace Captured in keyedReference of the

containing businessService Local name of port instanceParms of the tModelInstanceInfo

relating to the tModel for the binding

Binding implemented by port

tModelInstanceInfo with tModelKey of the tModel corresponding to the binding

portType implemented by port

tModelInstanceInfo with tModelKey of the tModel corresponding to the portType

Business Service and Binding Templates• <businessService

• serviceKey="102b114a-52e0-4af4-a292-02700da543d4" • businessKey="1e65ea29-4e0f-4807-8098-d352d7b10368">• <name>Stock Quote Service</name>• <bindingTemplates>• <bindingTemplate • bindingKey="f793c521-0daf-434c-8700-0e32da232e74" • serviceKey="102b114a-52e0-4af4-a292-02700da543d4">• <accessPoint URLType="http">• http://location/sample• </accessPoint>• <tModelInstanceDetails>• <tModelInstanceInfo • tModelKey="uuid:49662926-f4a5-4ba5-b8d0-32ab388dadda">• <description xml:lang="en">• The wsdl:binding that this wsdl:port implements. The instanceParms

specifies the port local name.• </description>• <instanceDetails>• <instanceParms>StockQuotePort</instanceParms>• </instanceDetails>• </tModelInstanceInfo>• <tModelInstanceInfo • tModelKey="uuid:e8cf1163-8234-4b35-865f-94a7322e40c3">• <description xml:lang="en">• The wsdl:portType that this wsdl:port implements.• </description>• </tModelInstanceInfo>• </tModelInstanceDetails>• </bindingTemplate>• </bindingTemplates>•

… and category bags for same• <categoryBag>• <keyedReference • tModelKey="uuid:6e090afa-33e5-36eb-81b7-1ca18373f457"• keyName="WSDL type"• keyValue="service" />• <keyedReference • tModelKey="uuid:d01987d1-ab2e-3013-9be2-2a66eb99d824"• keyName="service namespace" • keyValue="http://example.com/stockquote/" />• <keyedReference • tModelKey="uuid:2ec65201-9109-3919-9bec-c9dbefcaccf6"• keyName="service local name"• keyValue="StockQuoteService" />• </categoryBag>• </businessService>

Extending the Registry

• Categorization of tModels can be used to provide– Versioning of interfaces– QoS information on bindingTemplates

Versioning of tModels<tModel tModelKey="uddi:mycompany.com:stockquoteporttype">

<name>StockQuotePortType</name> <overviewDoc> <overviewURL> http://location/sample.wsdl <overviewURL> <overviewDoc> <categoryBag> <keyedReference tModelKey="uddi:uddi.org:versioning:major-version" keyName="Major Version" keyValue="2"/> <keyedReference tModelKey="uddi:uddi.org:versioning:minor-version" keyName="Minor Version" keyValue="1"/> <keyedReference tModelKey="uddi:uddi.org:versioning:revision-number" keyName="Revision Number" keyValue="Build 1241"/> <keyedReference tModelKey="uddi:uddi.org:versioning:milestone" keyName="Milestone" keyValue="latest-revision"/> <keyedReference tModelKey="uddi:uddi.org:versioning:versioning-component" keyName="Versioning Component" keyValue="StockQuoteSampleComponent"/> <keyedReference tModelKey="uddi:uddi-org:xml:namespace" keyName="portType namespace" keyValue="http://example.com/stockquote/"/> <keyedReference tModelKey="uddi:uddi-org:wsdl:types" keyName="WSDL type" keyValue="portType"/> </categoryBag>

</tModel>

QoS Information on BindingTemplates

<businessService serviceKey="uddi:mycompany.com:StockQuoteService" businessKey="uddi:mycompany.com:business> <name>Stock Quote Service</name> <bindingTemplates> <bindingTemplate bindingKey="uddi:mycompany.com:StockQuoteService:primaryBinding" serviceKey="uddi:mycompany.com:StockQuoteService"> <accessPoint URLType="http">http://location/sample </accessPoint> <tModelInstanceDetails>

<tModelInstanceInfo tModelKey="uddi:mycompany.com:StockQuoteService:PrimaryBinding:QoSInformation">

<description xml:lang="en"> This is the reference to the tModel that will have all of the QOS related categories attached. </description> </tModelInstanceInfo> <tModelInstanceInfo

tModelKey="uddi:mycompany.com:StockQuoteService:Primary Binding:QoSDetail">

<description xml:lang="en"> This points to the tModel that has the reference to the web

service endpoint that allows detailed retrieval of information </description> </tModelInstanceInfo>

</tModelInstanceDetails> </bindingTemplate> </bindingTemplates>

</businessService>

The tModel with the QoS Information

• <tModel tModelKey="mycompany.com:StockQuoteService: PrimaryBinding:QoSInformation"" > – <name> QoS Information for Stock Quote Service

</name> <overviewDoc> • <overviewURL> http://<URL describing schema of QoS attributes> <overviewURL>

– <overviewDoc> • <categoryBag>

– <keyedReference tModelKey="uddi:uddi.org:QoS:ResponseTime" keyName="Average ResponseTime" keyValue="fast" /> <keyedReference tModelKey="uddi:uddi.org:QoS:Throughput" keyName="Average Throughput" keyValue=">10Mbps" /> <keyedReference tModelKey="uddi:uddi.org:QoS:Reliability" keyName="Average Reliability" keyValue="99.9%" />

• </categoryBag> • </tModel>

Specs

• “Using WSDL in a UDDI Registry, Version 2.0.2”– http://www.oasis-open.org/committees/uddi-

spec/doc/tn/uddi-spec-tc-tn-wsdl-v202-20040631.htm

Articles• .NET UDDI

– Web Services Journal, “Microsoft UDDI SDK 2.0”, http://www.sys-con.com/webservices/article.cfm?id=544

– MSDN, “Using UDDI at Run Time, Part I”, http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnuddi/html/runtimeuddi1.asp - uses UDDI to query for other services for redundancy

– MSDN, “Using UDDI and Run Time, Part II”, http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnuddi/html/runtimeuddi2.asp - uses UDDI to register service and then to query for instances of services supporting given tModel

• Extending UDDI– UDDI as an Extended Web Services Registry: Versioning, quality of service, and

more”, Blum• Web Services Journal, June 2004, http://www.sys-con.com/story/?storyid

=45102&DE=1– “Extending UDDI with robust Web services information”, Blum

• http://searchwebservices.techtarget.com/originalContent/0,289142,sid26_gci952129,00.html

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnuddi/html/runtimeuddi1.asp




http://www.sys-con.com/story/?storyid=45102&DE=1

http://www.sys-con.com/story/?storyid=45102&DE=1

Web Services Registries and UDDI [email protected] INFOSYS290-3 Web Services: Concepts, Design and...

Documents

Transcript of Web Services Registries and UDDI [email protected] INFOSYS290-3 Web Services: Concepts, Design and...