UDDIProxy

Description

The UDDIProxy class is used to create a proxy object for a UDDI search and set options for that search.

Methods

UDDIProxy has the following methods:

setInquiryUrl

Description

Sets the UDDI inquiry URL.

Syntax

proxy.setinquiryurl (readonly string url)

Argument	Description
proxy	The name of the UDDIProxy object
url	A valid UDDI inquiry URL

Returns

Integer. Valid values are 1 for success, and 0 for failure.

Examples

Example 1

The following code sets the inquiry URL to a UDDI registry on the IBM Web site:

uddiproxy proxy

int ret

proxy = create uddiproxy

ret = proxy.setinquiryurl   (“http:/www-3.ibm.com/services/uddi/inquiryapi”)

...//search processing

destroy proxy

setOption

Description

Sets UDDI search options for match precision, case sensitivity, result sort order, and the maximum number of rows returned.

Syntax

proxy.setoption (boolean exactMatch, boolean caseSensitive, integer sort, integer maxRow)

Argument	Description
proxy	The name of the UDDIProxy object.
exactMatch	If true, search returns exact matches only.
caseSensitive	If true, search result must match the case used by search key word.
sort	Determines whether or how search results are sorted. Values are: -1 sorts results in descending order 0 performs no sorting 1 sorts results in ascending order
maxRow	Maximum number of items a search can return.

Returns

Integer. Valid values are 1 for success, and 0 for failure.

Examples

Example 1

The following code sets options for case sensitivity and the maximum number of rows returned:

ret = proxy.setoption (false, true, 0, 5)

findBusiness

Description

Finds business items using business names in a UDDI search.

Syntax

proxy.findBusiness (readonly string businessName, ref integer count, 
ref string busNameResult [ ], ref string busDescriptionResult [ ], ref string busKeyResult [ ])

Argument	Description
proxy	The name of the UDDIProxy object
businessName	Business name to search in UDDI registry
count	Number of search results returned; never larger than the maxRow input parameter in a corresponding setOption call
busNameResult	Array of business names matching the search criteria
busDescriptionResult	Array of descriptions for businesses matching the search criteria
busKeyResult	Array of globally unique identifiers (GUIDs) for each business matching the search criteria

Returns

Integer. Valid values are 1 for success, and 0 for failure.

Examples

Example 1

The following code finds business names, descriptions, and keys in the IBM UDDI registry:

uddiproxy proxy

proxy = create uddiproxy

int count

string businessName[], businessDescription[]

string businessKey []

proxy.findbusiness(“IBM”, count, businessName, &
  businessDescription, businessKey)

getBusinessDetail

Description

Gets business details using a business key that is typically obtained from the findBusiness function.

Syntax

proxy.getBusinessDetail (readonly string businessKey, ref integer count, 
ref string serviceNameResult [ ], ref string serviceDescriptionResult [ ], ref string serviceKeyResult [ ], ref string wsdl [ ])

Argument	Description
proxy	The name of the UDDIProxy object
businessKey	Business key to search in UDDI registry
count	Number of search results returned; never larger than the maxRow input parameter in a corresponding setOption call
serviceNameResult	Array of services matching the search criteria
serviceDescriptionResult	Array of descriptions for services matching the search criteria
serviceKeyResult	Array of globally unique identifiers (GUIDs) for each service matching the search criteria
wsdl	Array of WSDL file names for services matching search criteria

Returns

Integer. Valid values are 1 for success, and 0 for failure.

Examples

Example 1

The following code gets business details from business keys obtained by a findBusiness call on an instantiated uddiproxy object (proxy):

int i, count, count2

string businessName[], businessDescription[]

string businessKey []

string serviceName[], serviceDescription[]

string serviceKey [], wsdl [ ]

...//set search options and inquiry URL

proxy.findbusiness (“IBM”, count, businessName, &
  businessDescription, businessKey)

FOR i = 1 TO count

  proxy.getbusinessdetail (businessKey [i], count2, &
     serviceName, serviceDescription, serviceKey, wsdl)

  ...//call findService in secondary FOR/NEXT loop

NEXT

findService

Description

Finds service details using a service name.

Syntax

proxy.findService (readonly string serviceName, ref integer count, 
ref string serviceNameResult [ ], ref string serviceDescriptionResult [ ], ref string serviceKeyResult [ ], ref string busNameResult [ ], ref string wsdl [ ])

Argument	Description
proxy	The name of the UDDIProxy object
serviceName	Service name to search in UDDI registry
count	Number of search results returned; never larger than the maxRow input parameter in a corresponding setOption call
serviceNameResult	Array of services matching the search criteria
serviceDescriptionResult	Array of descriptions for services matching the search criteria
serviceKeyResult	Array of globally unique identifiers (GUIDs) for each service matching the search criteria
busNameResult	Array of business names matching the search criteria
wsdl	Array of WSDL file names for services matching search criteria

Returns

Integer. Valid values are 1 for success, and 0 for failure.

Examples

Example 1

The following code gets service details for the “Weather” service using an instantiated uddiproxy object (proxy):

int ret, count

string serviceName[], serviceDescription[]

string serviceKey [], businessName [], wsdl [ ]

ret = proxy.findService(“Weather”, count, serviceName,&
  serviceDescription, serviceKey, businessName, wsdl)