BusinessQueryManager

   

---

BusinessQueryManager

javax.xml.registry

---

JAXR 1.0; JWSDP 1.0, J2EE 1.4

 public interface BusinessQueryManager extends QueryManager {  // Public Instance Methods  public abstract BulkResponse findAssociations(Collection   findQualifiers   ,           String   sourceObjectId   , String   targetObjectId   , Collection   associationTypes   )           throws JAXRException;  // L0  public abstract BulkResponse findCallerAssociations(  // L0  Boolean   confirmedByCaller   ,      Boolean   confirmedByOtherParty   ,      Collection   associationTypes   ) throws JAXRException;      public abstract javax.xml.registry.infomodel.ClassificationScheme findClassificationSchemeByName       Collection   findQualifiers   , String   namePattern   )        throws JAXRException;  // L0  public abstract BulkResponse findClassificationSchemes(Collection   findQualifiers   ,           Collection   namePatterns   , Collection   classifications   ,           Collection   externalLinks   )  throws JAXRException;  // L0  public abstract javax.xml.registry.infomodel.Concept findConceptByPath(String   path   )           throws JAXRException;  // L0  public abstract BulkResponse findConcepts(Collection   findQualifiers   ,          Collection   namePatterns   , Collection   classifications   ,          Collection   externalIdentifiers   , Collection   externalLinks   )          throws JAXRException;  // L0  public abstract BulkResponse findOrganizations(Collection   findQualifiers   , Collection   namePatterns   ,          Collection   classifications   , Collection   specifications   ,          Collection   externalIdentifiers   ,Collection   externalLinks   )          throws JAXRException;  // L0  public abstract BulkResponse findRegistryPackages(Collection   findQualifiers   , Collection   namePatterns   ,          Collection   classifications   , Collection   externalLinks   )          throws JAXRException;  // L1  public abstract BulkResponse findServiceBindings(javax.xml.registry.infomodel.Key   serviceKey   ,         Collection   findQualifiers   , Collection   classifications   ,         Collection   specifications   )         throws JAXRException;  // L0  public abstract BulkResponse findServices(javax.xml.registry.infomodel.Key   orgKey   ,  Collection   findQualifiers   ,          Collection   namePatterns   , Collection   classifications   ,          Collection   specifications   )          throws JAXRException;  // L0  } 

BusinessQueryManager is a derived interface of QueryManager that provides convenience methods allowing registry searches to be performed based on registry object type, together with various criteria that allow filtering of the objects contained in the response. A search may also specify a sort order for the results that are returned. Most of the methods in this interface require a set of Collection s that contain the filtering and sorting criteria. Where no criterion of a given type is to be applied, the corresponding collection may be supplied as null . The filter and sorting arguments that may be supplied are as follows ; note that not all of these arguments are valid for every method.

findQualifiers

A collection of filters and sorting criteria as defined by the FindQualifier interface. Values such as AND_ALL_KEYS specified here override the default methods of combining multiple criteria described in each of the following paragraphs.

name patterns

A collection of strings that completely or partially specify the names of the registry objects to be returned. The syntax defined for the SQL-92 LIKE clause may be used to specify wildcards. By default, these names are combined using an OR operator, so that objects whose names matching any of the supplied patterns are returned.

classifications

A collection of Classification s that are required to be attached to the registry objects returned. These values are combined using an AND operator, so that only those objects that have all of the Classification s specified are returned.

specifications

A ServiceBinding may have associated with it any number of specifications that provide information of use to the developers writing applications that will invoke the service. The connection between a ServiceBinding and a specification is made via a SpecificationLink that must point to another object in the registry typically, a Concept . This search criterion uses any object that might be linked to by a SpecificationLink and, if more than one criterion is supplied, requires a match on all of them.

external identifiers

Specifies a collection of objects of type ExternalIdentifier that must be associated with the registry object. The specified external identifiers are combined with an AND operator; therefore, the returned objects will have all of the requested external identifiers.

external link

Specifies a collection of objects of type ExternalLink that must be associated with the registry object. The specified links are combined with an AND operator; therefore, the returned objects will have all of the requested links.

association type

A collection of association types. This filter is applied only to the findAssociations( ) method and is combined using an OR operator, so that Association s with any of the types in the collection are returned.

The query operations provided by this interface may be performed either synchronously (the default) or asynchronously. In either case, the BulkResponse object returned is valid immediately, but may not contain valid data. An attempt to access either the object collection or the exception set results in the calling thread being blocked until the operation completes. See the reference section for BulkResponse earlier in this chapter for a discussion of asynchronous operations.

Returned By

RegistryService.getBusinessQueryManager( )

---