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

setOption

findBusiness

getBusinessDetail

findService

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


Return value

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

Examples

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.


Return value

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

Examples

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


Return value

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

Examples

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 method.

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


Return value

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

Examples

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


Return value

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

Examples

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)