background image

Querying a Registry

<< Specific JAXR Connection Properties | Finding Organizations by Name >>
<< Specific JAXR Connection Properties | Finding Organizations by Name >>
Q
UERYING A
R
EGISTRY
181
Typically, a client obtains both a
BusinessQueryManager
object and a
Busi-
nessLifeCycleManager
object from the
RegistryService
object. If it is using
the registry for simple queries only, it may need to obtain only a
BusinessQue-
ryManager
object.
Querying a Registry
The simplest way for a client to use a registry is to query it for information about
the organizations that have submitted data to it. The
BusinessQueryManager
interface supports a number of find methods that allow clients to search for data
using the JAXR information model. Many of these methods return a
Bulk-
Response
(a collection of objects) that meets a set of criteria specified in the
method arguments. The most useful of these methods are as follows:
findOrganizations
, which returns a list of organizations that meet the
specified criteria--often a name pattern or a classification within a classi-
fication scheme
findServices
, which returns a set of services offered by a specified orga-
nization
findServiceBindings
, which returns the service bindings (information
about how to access the service) that are supported by a specified service
The
JAXRQuery
program illustrates how to query a registry by organization name
and display the data returned. The
JAXRQueryByNAICSClassification
and
JAXRQueryByWSDLClassification
programs illustrate how to query a registry
using classifications. All JAXR providers support at least the following taxono-
mies for classifications:
The North American Industry Classification System (NAICS). See
http:/
/www.census.gov/epcd/www/naics.html
for details.
The Universal Standard Products and Services Classification (UNSPSC).
See
http://www.eccma.org/unspsc/
for details.
The ISO 3166 country codes classification system maintained by the Inter-
national
Organization
for
Standardization
(ISO).
See
http://
www.iso.org/iso/en/prods-services/iso3166ma/
index.html
for details.
The following sections describe how to perform some common queries:
Finding organizations by name
Finding organizations by classification