Querying a Registry
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
· The Universal Standard Products and Services Classification (UNSPSC).
· The ISO 3166 country codes classification system maintained by the Inter-
national
Organization
for
Standardization
(ISO).
See
The following sections describe how to perform some common queries:
· Finding organizations by name
· Finding organizations by classification
