Welcome!

Microservices Expo Authors: Zakia Bouachraoui, Elizabeth White, Pat Romanski, Liz McMillan, Yeshim Deniz

Related Topics: Microservices Expo

Microservices Expo: Article

UDDI as an Extended Web Services Registry

Versioning, quality of service, and more...

As enterprises build a critical mass of Web services, they need some way of keeping track of those services. UDDI is an ideal store for such information.

Using UDDI's built-in abstractions of business services, binding templates, and tModels referring to interface specifications, UDDI can be used to manage all of the addresses and protocols and formats of those services. This information can be used for several purposes, including providing location independence and identification of common supported interfaces among those services.

But the amount of information tracked on each Web service is a small subset of the information that companies truly need to manage for each of these services. Developers want to access the actual formats used by those Web services within the registry. This includes objects from the WSDL descriptions of Web services, such as portTypes, and also includes other artifacts associated with Web services such as XML Schemas to represent types used by those WSDLs. They also want to be able to keep track of the versions of those Web services and their associated objects. IT administrators typically want to know a variety of information on each Web services' quality of service. They also want to know who has access to those services, and what applications and Web services may be dependent on those services.

This article discusses how UDDI can be used as this more robust registry of extensive information on each Web service. It describes UDDI tModels for categorization and shows how they are used in the "Using WSDL in a UDDI Registry, Version 2.0" Technical Note [WSDL-UDDI] to represent all of the information present in WSDL in UDDI. It then describes how the techniques used by the WSDL mapping technical note can be used to represent new classes and attributes of information generally.

We then show how to use these techniques to represent versioning information of Web service objects and quality of service information for a Web service. My company is working with the UDDI Technical Committee as well as customers and partner companies to create Technical Notes in each of these areas: versioning and quality of service metrics. Our hope is that the techniques developed in these areas will be useful models to extending UDDI to cover other areas of describing Web services mentioned above as well.

UDDI tModels

tModels, short for technical models, can register two types of things: specifications and categorizations. Specifications describe the Web service and can be expressed in Web Service Description Language (WSDL) files, XML Schema definitions, policy expressions, or just a reference to a Web page for a spec. Categorization tModels provide an extensible mechanism for adding property information to a UDDI entity. The uddi-org:types category indicates which type of tModel is at hand. The following example below demonstrates how to define a categorization tModel, and how to use a categorization tModel to categorize a UDDI entity. This tModel entity represents the WSDL Transport Categorization tModel as defined in the WSDL mapping technical note. It's used to specify what type of transport is supported by a Web service. This tModel includes a categoryBag that defines the tModel as a checked categorization tModel (see Listing 1).

Entities are categorized with the keyedReference structure on a categoryBag. A keyedReference element has a tModelKey attribute that refers to the unique ID of the categorization tModel. In this example, the tModelKeys in the two keyedReference structures refer to the uddi-org:types tModel. The keyName attribute is purely for human readability. The keyValue attribute contains the value for the category. The first keyedReference specifies that the tModel represents a taxonomy. The second keyedReference specifies that the values specified for the taxonomy are checked against a defined value set. Taxonomies used for categorization may have validated value sets or may support arbitrary values.

WSDL Mapping

WSDL files describe a Web service's interfaces (portTypes), their encoding formats and transport protocols (bindings), specific endpoint locations (ports) that implement a binding, and services that contain a collection of named ports. Some of this information already exists in UDDI in some form. Specifically, WSDL ports are mapped to UDDI bindingTemplates. The bindingTemplate's tModelInstanceDetails collection points to the tModels generated for the WSDL portType and binding (described below). WSDL services are represented as UDDI businessService entities. More interesting than these mappings is how to represent WSDL artifacts that are not already present in UDDI.

WSDL PortTypes
The v2.0 WSDL mapping generates a UDDI tModel for each WSDL portType. The name of the tModel is the same as the local name of the portType in the WSDL specification. The overviewURL of the tModel is the URL of the WSDL specification.

Each portType tModel contains a categoryBag with at least two keyedReference structures. The first keyedReference indicates the type of WSDL artifact, and the second keyedReference indicates the namespace of the portType. The first keyedReference specifies the tModelKey referring to the WSDL Entity Type tModel (uddi-org:wsdl:types), which is a checked taxonomy of WSDL entity types. The taxonomy defines four allowed values: portType, binding, port, and service. The keyValue in this keyedReference will be "portType". The second keyedReference specifies the tModelKey referring to the XML Namespace tModel (uddi-org:xml:namespace), which is an unchecked taxonomy. The keyValue in this keyedReference will contain the target namespace of the WSDL document that defines the portType. These taxonomies are defined in the WSDL mapping technical note.

WSDL Bindings
In similar fashion, the v2.0 WSDL mapping generates a UDDI tModel for each WSDL binding, with the name of the tModel gathered from the local name of the WSDL binding, and the overviewURL being the URL of the WSDL definition file. Using categoryBags with keyedReferences:

  • The tModel is categorized as a WSDL entity of type "binding".
  • The namespace category specifies the target namespace of the WSDL document that defines the binding.
  • A portType category is used to refer to the portType tModel that was created for the WSDL portType (as described above).
  • Protocol and transport categories indicate what XML and transport protocols (e.g., SOAP 1.1 and HTTP) the binding supports.

Techniques for Information Extension

Looking at how WSDL bindings and portTypes were represented in UDDI, we can see some generally useful approaches to putting new types of information associated with Web services into the registry.

tModels as Classes
To represent new classes of information associated with Web services, we can generate additional specification tModels that we can then categorize (using taxonomy tModels) to represent the attributes of those classes. An example of a new class of information might be "quality of service information for a given binding template" - a QoS Information tModel. The specific QoS information that applies to the businessService would be specified using keyedReferences in the QoS Information tModel. The UDDI businessService entity would include a reference to its associated QoS Information tModel by including the tModel in the tModelInstanceDetails structure in its bindingTemplate. (The tModelInstanceDetails structure points to a set of specification tModels that collectively define the "technical fingerprint" of the service. According to the WSDL mapping technical note, the tModelInstanceDetails structure points to (at least) the portType and binding tModels. We are suggesting that an additional tModel be included in this list to represent QoS information.)

A QoS Information tModel could also be referenced directly from the businessService entity or from a UDDI version 3 bindingTemplate entity using a keyedReference structure in the entity's categoryBag.

Categories as Attributes
To annotate a UDDI entity with attributes, create new categorization tModels to represent the property types. The categorization tModels can be included in the categoryBag structures on UDDI businessService, bindingTemplate, or the new "class tModels" that we just described. UDDI business services and UDDI v3 bindingTemplates can link to these tModels by adding a keyedReference structure to the categoryBag on the businessService or bindingTemplate that references these new categories. Examples of this technique from the mapping spec are the WSDL Entity Type and XML Namespace tModel that are placed as categories on the UDDI business services themselves as well as the tModels which represent WSDL portTypes and bindings. If there is a set of related categories, the new UDDI v3 keyedReferenceGroup can be used to associate related categories together.

Versioning Information

Let's try to put these techniques to work to represent some of the other information about Web services discussed above. One particular area of interest we have heard from many customers is a standard way of representing the versions of various Web service objects: business services, binding templates, portType tModels, and binding tModels. It would be helpful to categorize each of these objects with:

  • Major and minor version numbers
  • Revision or build numbers
  • Named milestones or phases
  • A label to allow associating related objects together

Let's create some new taxonomies to represent this information. Let's assume that the taxonomy names are "uddi:uddi-org:versioning:major-version", "uddi:uddi-org:versioning:minor-version", "uddi:uddi-org:versioning:revision-number", "uddi:uddi-org:versioning:milestone", and "uddi:uddi-org:versioning:versioning-component", although of course these actual names (prefixed as they are by "uddi-org") would not be used unless this proposal actually did become a Technical Note from the UDDI TC.

Listing 2 shows you how to use all of these taxonomies to categorize a portType tModel as version 2.1, build 1241, and the latest revision. It also uses the "versioning-component" tModel with a value of "StockQuoteSampleComponent" to tie together the portType with other UDDI objects (business services, binding templates, binding tModels, other portType tModels, and other versions of the portType tModel). The versioning-component taxonomy is used to establish an association between two versions of the same object. That is, it can be used to establish that two portType tModels are versions 1 and 2 of the same interface (relying on the name is not a reliable way of doing that). It can also be used to associate various UDDI objects as part of the same component. As portType tModels get replaced, there may not be a bindingTemplate that points to the old versioned portType tModels. So using this "versioning-component" is a reliable way to be able to ask "give me all of the UDDI objects associated with version n of this component" (rather than relying on business services containing binding templates which point to all supported tModels.

Quality of Service Information

For another example of extending UDDI with more information, let's also provide a method of representing quality of service metrics. Systinet is working with AmberPoint, a leading Web services management vendor, to author a Technical Note in this area. The example below represents an approximation of the currently envisioned approach, but this may change by the time the TN is released.

In this example, we represent quality of service information for each Web service deployment by generating a tModel for quality of service information for the binding template that represents the deployment. We then assign properties for each QoS metric on the generated tModel using keyedReferences. This QoS information allows companies to track the actual delivered quality of service of a particular physical implementation of a Web service according to many criteria. Examples of this might be classifications of average response time (fast, medium, slow), categories of average throughput (>10 Mbps, 1-10Mbps, <1Mbps), and overall reliability (99.99%, 99.9%, 99%).

Listing 3 is an example of the bindingTemplate reference to the tModel that will have the QoS attribute categories attached. It starts with the Stock Quote Service example used in the WSDL mapping technical note, but for simplicity does not include the WSDL artifacts that the example uses. In order to retrieve more detailed management information, we store the location of a WSDL in a keyed reference with tModelKey "uddi:uddi.org:QoS-Detail". This tModel has the reference to a binding template of a "management Web service" endpoint which provides operations for more detailed analysis of the given Web service's performance.

Listing 4 is an example of the QoS Information tModel, which contains a categoryBag specifying QoS metrics.

Additional Standards for Enhanced Web Services Information

We've just described how a given company can use the extensibility methods in UDDI to track more extensive information about Web services than just their locations, access protocols, and supported formats. Specifically, we have shown how we can use categories on UDDI objects to represent both versioning information and quality of service information. As mentioned, we expect to finalize Technical Notes working with the OASIS UDDI TC, in these areas as well.

In addition, we are helping to create ways of representing other classes of Web services information, as additional technical notes under the aegis of OASIS' UDDI Technical Committee. Some of the areas that we think are of most immediate value to track for each Web service include:

  • Extending the versioning information to "lifecycle information" describing attributes of the milestones referred to
  • More detailed WSDL mapping, storing individual operations and types in the registry
  • Additional resources related to Web services such as XML schemas and individual XML documents and mappings between interface formats
  • Dependency information between Web services and on Web services
  • Access permissions (what developers have access to what services)

Summary

UDDI is an excellent basis for an enterprise Web services registry. Incremental standards such as the "Using WSDL in a UDDI Registry" technical note demonstrate methods of storing additional information in UDDI. Companies can start leveraging these approaches to add more information on additional attributes of Web services, such as quality of service and versioning information, to their enterprise UDDI registries. Incremental standards in the form of UDDI Technical Notes are emerging for these attributes of Web services and others to allow tracking of this information.

Acknowledgements

Thanks to Anne Thomas Manes, Zdenek Svoboda, Mirek Novotny, Fred Carter, and Luc Clement for helpful feedback on topics related to this article.

References

  • "Using WSDL in a UDDI Registry, Version 2.0": www.oasis-open.org/committees/uddi-spec/doc/tn/uddi-spec-tc-tn-wsdl-v2.htm
  • More Stories By Adam Blum

    Adam Blum is CEO of Rhomobile. He came from Good Technology and while spending millions on enterprise mobile application development he realized there was a need for a framework for enterprises to build mobile applications easily and cost-effectively empower their workforce without training their programmers to learn different programming languages and building apps from scratch. He has spoken at Interop in Las Vegas and at Ruby events all over the world.

    Comments (1)

    Share your thoughts on this story.

    Add your comment
    You must be signed in to add a comment. Sign-in | Register

    In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


    Microservices Articles
    When building large, cloud-based applications that operate at a high scale, it’s important to maintain a high availability and resilience to failures. In order to do that, you must be tolerant of failures, even in light of failures in other areas of your application. “Fly two mistakes high” is an old adage in the radio control airplane hobby. It means, fly high enough so that if you make a mistake, you can continue flying with room to still make mistakes. In his session at 18th Cloud Expo, Lee A...
    In his general session at 19th Cloud Expo, Manish Dixit, VP of Product and Engineering at Dice, discussed how Dice leverages data insights and tools to help both tech professionals and recruiters better understand how skills relate to each other and which skills are in high demand using interactive visualizations and salary indicator tools to maximize earning potential. Manish Dixit is VP of Product and Engineering at Dice. As the leader of the Product, Engineering and Data Sciences team at D...
    Lori MacVittie is a subject matter expert on emerging technology responsible for outbound evangelism across F5's entire product suite. MacVittie has extensive development and technical architecture experience in both high-tech and enterprise organizations, in addition to network and systems administration expertise. Prior to joining F5, MacVittie was an award-winning technology editor at Network Computing Magazine where she evaluated and tested application-focused technologies including app secu...
    Containers and Kubernetes allow for code portability across on-premise VMs, bare metal, or multiple cloud provider environments. Yet, despite this portability promise, developers may include configuration and application definitions that constrain or even eliminate application portability. In this session we'll describe best practices for "configuration as code" in a Kubernetes environment. We will demonstrate how a properly constructed containerized app can be deployed to both Amazon and Azure ...
    Modern software design has fundamentally changed how we manage applications, causing many to turn to containers as the new virtual machine for resource management. As container adoption grows beyond stateless applications to stateful workloads, the need for persistent storage is foundational - something customers routinely cite as a top pain point. In his session at @DevOpsSummit at 21st Cloud Expo, Bill Borsari, Head of Systems Engineering at Datera, explored how organizations can reap the bene...
    Using new techniques of information modeling, indexing, and processing, new cloud-based systems can support cloud-based workloads previously not possible for high-throughput insurance, banking, and case-based applications. In his session at 18th Cloud Expo, John Newton, CTO, Founder and Chairman of Alfresco, described how to scale cloud-based content management repositories to store, manage, and retrieve billions of documents and related information with fast and linear scalability. He addresse...
    The now mainstream platform changes stemming from the first Internet boom brought many changes but didn’t really change the basic relationship between servers and the applications running on them. In fact, that was sort of the point. In his session at 18th Cloud Expo, Gordon Haff, senior cloud strategy marketing and evangelism manager at Red Hat, will discuss how today’s workloads require a new model and a new platform for development and execution. The platform must handle a wide range of rec...
    SYS-CON Events announced today that DatacenterDynamics has been named “Media Sponsor” of SYS-CON's 18th International Cloud Expo, which will take place on June 7–9, 2016, at the Javits Center in New York City, NY. DatacenterDynamics is a brand of DCD Group, a global B2B media and publishing company that develops products to help senior professionals in the world's most ICT dependent organizations make risk-based infrastructure and capacity decisions.
    Discussions of cloud computing have evolved in recent years from a focus on specific types of cloud, to a world of hybrid cloud, and to a world dominated by the APIs that make today's multi-cloud environments and hybrid clouds possible. In this Power Panel at 17th Cloud Expo, moderated by Conference Chair Roger Strukhoff, panelists addressed the importance of customers being able to use the specific technologies they need, through environments and ecosystems that expose their APIs to make true ...
    In his keynote at 19th Cloud Expo, Sheng Liang, co-founder and CEO of Rancher Labs, discussed the technological advances and new business opportunities created by the rapid adoption of containers. With the success of Amazon Web Services (AWS) and various open source technologies used to build private clouds, cloud computing has become an essential component of IT strategy. However, users continue to face challenges in implementing clouds, as older technologies evolve and newer ones like Docker c...