Search

Categories

Documents

UDDI - UDDI client interface

• NAME
• SYNOPSIS
• DESCRIPTION
• FUNCTIONS
• GLOBALS
• %UDDI::err
• $UDDI::registry
• $UDDI::TRACE
• SEE ALSO
• AUTHOR

NAME

UDDI - UDDI client interface

SYNOPSIS

 use UDDI;

 my $list = UDDI::find_business(name => "a");
 my $bis = $list->businessInfos;
 for my $b ($bis->businessInfo) {
     print $b->name, "\n";
 }

DESCRIPTION

This module provide functions to interact with UDDI registry servers. UDDI (Universal Description, Discovery and Integration) is the name of a group of web-based registries that expose information about businesses and their technical interfaces (APIs). Learn more about UDDI at www.uddi.org.

The interface exposed comply with the ``UDDI Programmer's API Specification''. Currently only the UDDI inquiry interface is provided.

FUNCTIONS

The following functions are provided. None of them are exported by default. A successful invocation will return some UDDI object. On error undef is returned and the global variable %UDDI::err is set.

All the find_xxx() functions take key/value pairs as arguments. All they get_xxx() functions simply take one or more keys as argument.

find_binding( serviceKey => $key, ... )

This function will find binding details for a specific service. On success a UDDI::bindingDetails object is returned. Optional arguments are maxRows, findQualifiers and tModelBag.

find_business( ... )

This function will return businesses that fullfil the search criteria given. On success a UDDI::businessList object is returned. The returned businessList might be empty. Arguments are maxRows, findQualifiers, name, identiferBag, categoryBag, tModelBag are discoveryURLs.

find_service( businessKey => $key, ... )

This function will find services for a specific business. On success a UDDI::serviceList object is returned. Optional arguments are maxRows, findQualifiers, name, categoryBag and tModelBag.

find_tModel( ... )

This function will return tModels that fullfil the search criteria given. On success a UDDI::tModelList object is returned. The returned tModelList might be empty. Arguments are maxRows, findQualifiers, name, identiferBag and categoryBag.

get_bindingDetail( $bindingKey, ... )

This function will return a UDDI::bindingDetail object containing a UDDI::bindingTemplate for each binding key given as argument.

get_businessDetail( $businessKey, ... )

This function will return a UDDI::businessDetail object containing a UDDI::businessEntity for each business key given as argument.

get_businessDetailExt( $businessKey, ... )

This function will return a UDDI::businessDetailExt object containing a UDDI::businessEntityExt for each business key given as argument.

get_serviceDetail( $serviceKey, ... )

This function will return a UDDI::serviceDetail object containing a UDDI::businessService for each service key given as argument.

get_tModelDetail( $tModelKey, ... )

This function will return a UDDI::tModelDetail object containing a UDDI::tModel for each tModel key given as argument.

GLOBALS

%UDDI::err

In case of errors the functions above will return undef and the %UDDI::err hash will be filled with the following values:

type

A short string giving the overall type of the failure. It can be either ``HTTP'' or ``SOAP''.

code

Error code. For HTTP it is a 3 digit number. For UDDI failures it is some string prefixed with ``E_''. For general SOAP failures it is a short string like ``VersionMismatch'', ``MustUnderstand'', ``Client'', ``Server'' (defined in section 4.4.1 in the SOAP spec.)

message

A short human readable (English) message describing the error.

detail

A reference to the corresponing error object.

The hash will be empty after a successful function call.

$UDDI::registry

The $UDDI::registry variable contains the URL to the registry server to use for the calls. Currently it defaults to Microsoft's test server.

$UDDI::TRACE

For debugging you might assign a file handle to the $UDDI::TRACE variable. Trace logs of the SOAP messages are then written to this file.

SEE ALSO

http://www.uddi.org, SOAP, the SOAP::Lite manpage

AUTHOR

Gisle Aas <gisle@ActiveState.com>

Copyright 2000 ActiveState Tool Corp.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Information