Registering a Web Service in UDDI @ JDJ
UDDI (Universal Description, Discovery and integration) is a registry for Web Services. It provides a mechanism to advertise and discover Web Services. Although you don't need to use UDDI to implement a Web Services solution, you'll find that a UDDI registry greatly simplifies the management and administration of your Services, particularly once they have reached a certain critical mass.
Once you've developed more than a few Services, and once you start giving access to those Services to more than a few controlled individuals, management starts to get more challenging. Potential Service consumers need a way to search for available Services, to determine which Services might be applicable to their projects, and to find metadata about those Services. in particular, a Service consumer must find the WSDL (Web Services Description Language) files that define a Service. UDDI was designed to support these requirements.
A business may set up multiple UDDI registries in-house to support intranet and extranet operations, and a business may use UDDI registries set up by its customers and business partners. The UDDI Business Registry (UBR) is a free, public registry operated by IBM, Microsoft, SAP, and NTT, although few businesses feel comfortable advertising their business Services in such an insecure public forum.
One key difference between a UDDI registry and other registries and directories is that UDDI provides a mechanism to categorize businesses and Services using taxonomies. For example, Service providers can use a taxonomy to indicate that a Service implements a specific domain standard, or that it provides Services to a specific geographic area. These taxonomies make it easier for consumers to find Services that match their specific requirements.
Now, of course, in order for consumers to find a Service, the Service provider must first properly register the Service. There are many different ways to register a Service, so it's important to define registration conventions so that consumers know what to search for.
in July 2003, the standards group that manages the UDDI specification (the OASIS UDDI-Spec Technical Committee) published a Technical Note called "Using WSDL in a UDDI Registry, Version 2.0." This Technical Note defines conventions for registering a Web Service based on information in the Service's WSDL definition. (This Technical Note supercedes the previous UDDI Best Practices document, "Using WSDL in a UDDI Registry, Version 1.08.")
The UDDI Data Model
A UDDI registry manages information about Service types and Service implementations. Going back to basic object-oriented concepts, a type is the definition of a thing, and an implementation is an instance of a thing. A Service-type registration, called a technical model (tModel), represents a technical specification or some other metadata. For example, a tModel could represent a WSDL document that defines a Web Service.
A Service implementation registration represents a Service offered by a specific Service provider. It specifies information about the business entity that offers the Service (businessEntity), describes the Service (businessService), and captures the binding information (bindingTemplate) required to use the Service. The binding Template captures the Service endpoint address, and associates the Service with the tModels that represent its technical specifications. Figure 1 shows the UDDI data model that captures these registrations.
UDDI also uses tModels to represent taxonomies. Service providers categorize UDDI registrations using a construct called a keyedReference. A keyedReference allows you to assign property values to a UDDI entity using a name/value pair. The "name" is the tModelKey of the taxonomy tModel. The "value" is the descriptive information supplied for this categorization. You may define a limited set of valid values (a Value Set) for a taxonomy. For example, you could define a taxonomy to represent the deployment status of a Service, and define a Value Set with values of "development", "test", and "production". To indicate that a Service is in production, you would add a keyedReference to the businessService entity that represents the Service. The keyedReference would specify the tModelKey for the deployment status tModel taxonomy, and a value of "production". It would look something like this:
You'll notice that the keyedReference includes three attributes: tModelKey, keyName, and keyValue. The tModelKey and keyValue attributes are required. The keyName attribute is optional and insignificant. The keyName attribute allows you to assign a human-readable name to the keyedReference attribute, but you cannot search the registry using this name.
The WSDL Data Model
A WSDL file describes a Web Service. A WSDL file describes what functionality a Web Service offers, how it communicates, and where to find it. Figure 2 shows the WSDL data model, and shows the relationship of the various definition elements.
The what part of a WSDL document (a portType) defines the abstract interface of a Web Service. A portType is a reusable definition component. Multiple providers can offer Web Services that implement the same portType. A portType specifies what operations the abstract Service supports, and it specifies the input and output messages associated with each operation. Each message is defined in a separate message definition, which in turn references element or type definitions in the types section.
The how part of a WSDL document (a binding) maps a portType to a concrete set of formats and protocols. A binding indicates how the input and output messages defined in the referenced portType should be packaged into a message, and it specifies what communication protocols can be used to convey the messages. As with portTypes, a WSDL binding is a reusable definition component. Multiple Service providers can support the same WSDL binding. A Service can also implement multiple bindings of the same portType, thereby supporting multiple protocols.
The where part of a WSDL document (a Service) describes a specific Web Service implementation. A Web Service implementation contains one or more ports. A port implements the referenced binding and specifies the endpoint of that Web Service binding. A business might offer multiple endpoints to a particular Service, each implementing a different binding.
Figure 3 shows a Web Service description that consists of three different WSDL files for the portType, binding, and Service definitions. The Service definition imports the binding definition, and the binding definition imports the portType definition. By breaking the descriptions into multiple files, the portType and binding definitions support reusability.
This is the approach people should take when defining corporate standards or industry-specific domain standards. A standards group should define the abstract Service portTypes and bindings, but it should not define specific Service implementations. A Service provider that implements a standard Service description should not redefine the standard definitions. It should import the standard definitions.
The WSDL-to-UDDI mapping model is designed to help users find Services that implement standard definitions. It also helps users find Services that support a specific set of protocols, such as SOAP over HTTP. The Technical Note defines a new set of canonical tModels to help capture the necessary information. These tModels include categorization systems to capture the WSDL element type (portType, binding, or Service) and the element's fully qualified name (its local name and namespace name), along with the protocols supported by a WSDL binding.
The mapping model works as follows:
Register each WSDL portType as a tModel. Give the tModel the same name as the portType local name. Capture the URL of the WSDL file in the tModel overviewURL. Use keyedReferences to indicate that the tModel represents a WSDL portType and to capture the namespace.
Register each WSDL binding as a tModel. Give the tModel the same name as the binding local name. Capture the URL of the WSDL file in the tModel overviewURL. Use keyedReferences to indicate that the tModel represents a WSDL binding, to capture the namespace, to reference the tModel that describes the portType for this binding, and to indicate protocols supported by this binding.
Register each WSDL Service as a businessService. Give the businessService a hu-man-readable name. Use keyedReferences to indicate that this Service is described by WSDL and to capture the WSDL Service local and namespace names.
Register each WSDL Service port as a bindingTemplate. Capture the port endpoint address in the bindingTemplate accessPoint. Using the tModelinstanceDetails structure, associate the Service with all the tModels that describe the Service. At a minimum, the bindingTemplate should point to the tModels that represent the WSDL portType and WSDL binding definitions. Capture the port's local name in the instanceParms field of the WSDL binding link.
Find specifications by namespace name
Find implementations by namespace name
Find all implementations of a WSDL portType
Find all SOAP implementations of a WSDL portType