Previous section   Next section
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 Collections 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 Classifications 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 Classifications 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 Associations 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( )


  Previous section   Next section