com.sun.xml.registry.uddi

Class BusinessQueryManagerImpl

java.lang.Object

com.sun.xml.registry.uddi.QueryManagerImpl

com.sun.xml.registry.uddi.BusinessQueryManagerImpl

All Implemented Interfaces:

BusinessQueryManager, QueryManager

public class BusinessQueryManagerImpl
extends QueryManagerImpl
implements BusinessQueryManager

Class Declaration for Class1

Author:

Kathy Walsh

Constructor Summary

Constructors

Constructor and Description
BusinessQueryManagerImpl()
BusinessQueryManagerImpl(RegistryServiceImpl service)

Method Summary

Modifier and Type	Method and Description
BulkResponse	findAssociations(Collection findQualifiers, String sourceObjectId, String targetObjectId, Collection associationTypes) Finds all Associations that match ALL of the criteria specified by the parameters of this call.
BulkResponse	findCallerAssociations(Collection findQualifiers, Boolean confirmedByCaller, Boolean confirmedByOther, Collection associationTypes) Finds all Association objects owned by the caller that match all of the criteria specified by the parameters of this call.
ClassificationScheme	findClassificationSchemeByName(Collection findQualifiers, String namePattern) Find a ClassificationScheme by name based on the specified name pattern.
BulkResponse	findClassificationSchemes(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection externalLinks) Finds all ClassificationSchemes that match ALL of the criteria specified by the parameters of this call.
Concept	findConceptByPath(String path) Find a Concept based on the path specified.
BulkResponse	findConcepts(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection externalIdentifiers, Collection externalLinks) Finds all Concepts that match ALL of the criteria specified by the parameters of this call.
BulkResponse	findOrganizations(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection specifications, Collection identifiers, Collection externalLinks) Finds all Organizations that match ALL of the criteria specified by the parameters of this call.
BulkResponse	findRegistryPackages(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection externalLinks) Finds all Pac kages that match ALL of the criteria specified by the parameters of this call.
BulkResponse	findServiceBindings(Key serviceKey, Collection findQualifiers, Collection classifications, Collection specifications) Finds all ServiceBindings that match ALL of the criteria specified by the parameters of this call.
BulkResponse	findServices(Key orgKey, Collection findQualifiers, Collection namePatterns, Collection classifications, Collection specifications) Finds all Services that match ALL of the criteria specified by the parameters of this call.

Methods inherited from class com.sun.xml.registry.uddi.QueryManagerImpl

getRegistryObject, getRegistryObject, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryService

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.xml.registry.QueryManager

getRegistryObject, getRegistryObject, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryService

Constructor Detail

BusinessQueryManagerImpl

public BusinessQueryManagerImpl()

BusinessQueryManagerImpl

public BusinessQueryManagerImpl(RegistryServiceImpl service)

Method Detail

findOrganizations

public BulkResponse findOrganizations(Collection findQualifiers,
                                      Collection namePatterns,
                                      Collection classifications,
                                      Collection specifications,
                                      Collection identifiers,
                                      Collection externalLinks)
                               throws JAXRException

Finds all Organizations that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findOrganizations in interface BusinessQueryManager

Parameters:

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

namePatterns - a Collection that may consist of either String or LocalizedString objects. Each String or value within a LocalizedString is a partial or full name pattern with wildcard searching as specified by the SQL-92 LIKE specification. Unless otherwise specified in findQualifiers, this is a logical OR, and a match on any name qualifies as a match for this criterion.

classifications - a Collection of Classification objects that classify the object. It is analogous to a catgegoryBag in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Classifications qualifies as a match for this criterion. The programmer may use the LifeCycleManager.createClassification method to create a transient Classification for use in this Collection.

specifications - a Collection of RegistryObjects that represent (proxy) a technical specification. It is analogous to a tModelBag in the UDDI specification. In the case of a UDDI provider, the RegistryObject is a specification Concept. In the case of an ebXML provider, the RegistryObject is likely to be an ExtrinsicObject. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Specifications qualifies as a match for this criterion.

identifiers - a Collection of ExternalIdentifier objects that provide an external identifier for the object using an identification scheme such as DUNS. It is analogous to an identifierBag in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified ExternalIdentifiers qualifies as a match for this criterion. The programmer may use the LifeCycleManager.createExternalIdentifier method to create a transient ExternalIdentifier for use in this Collection.

externalLinks - a Collection of ExternalLink objects that link the object to content outside the registry. It is analogous to an overviewDoc in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified ExternalLinks qualifies as a match for this criterion.

Returns:

BulkResponse containing Collection of Organizations

Throws:

JAXRException - if the JAXR provider encounters an internal error

findServices

public BulkResponse findServices(Key orgKey,
                                 Collection findQualifiers,
                                 Collection namePatterns,
                                 Collection classifications,
                                 Collection specifications)
                          throws JAXRException

Finds all Services that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findServices in interface BusinessQueryManager

Parameters:

orgKey - Key identifying an Organization. Required for UDDI providers.

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

namePatterns - a Collection that may consist of either String or LocalizedString objects. Each String or value within a LocalizedString is a partial or full name pattern with wildcard searching as specified by the SQL-92 LIKE specification. Unless otherwise specified in findQualifiers, this is a logical OR, and a match on any name qualifies as a match for this criterion.

classifications - a Collection of Classification objects that classify the object. It is analogous to a catgegoryBag in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Classifications qualifies as a match for this criterion. The programmer may use the LifeCycleManager.createClassification method to create a transient Classification for use in this Collection.

specifications - a Collection of RegistryObjects that represent (proxy) a technical specification. It is analogous to a tModelBag in the UDDI specification. In the case of a UDDI provider, the RegistryObject is a specification Concept. In the case of an ebXML provider, the RegistryObject is likely to be an ExtrinsicObject. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Specifications qualifies as a match for this criterion.

Returns:

a BulkResponse containing a Collection of Services

Throws:

JAXRException - if the JAXR provider encounters an internal error

findServiceBindings

public BulkResponse findServiceBindings(Key serviceKey,
                                        Collection findQualifiers,
                                        Collection classifications,
                                        Collection specifications)
                                 throws JAXRException

Finds all ServiceBindings that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findServiceBindings in interface BusinessQueryManager

Parameters:

serviceKey - Key identifying a Service. Required for UDDI providers.

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

classifications - a Collection of Classification objects that classify the object. It is analogous to a catgegoryBag in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Classifications qualifies as a match for this criterion. The programmer may use the LifeCycleManager.createClassification method to create a transient Classification for use in this Collection.

specifications - a Collection of RegistryObjects that represent (proxy) a technical specification. It is analogous to a tModelBag in the UDDI specification. In the case of a UDDI provider, the RegistryObject is a specification Concept. In the case of an ebXML provider, the RegistryObject is likely to be an ExtrinsicObject. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Specifications qualifies as a match for this criterion.

Returns:

BulkResponse containing Collection of ServiceBindings

Throws:

JAXRException - if the JAXR provider encounters an internal error

findClassificationSchemes

public BulkResponse findClassificationSchemes(Collection findQualifiers,
                                              Collection namePatterns,
                                              Collection classifications,
                                              Collection externalLinks)
                                       throws JAXRException

Finds all ClassificationSchemes that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findClassificationSchemes in interface BusinessQueryManager

Parameters:

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

namePatterns - a Collection that may consist of either String or LocalizedString objects. Each String or value within a LocalizedString is a partial or full name pattern with wildcard searching as specified by the SQL-92 LIKE specification. Unless otherwise specified in findQualifiers, this is a logical OR, and a match on any name qualifies as a match for this criterion.

classifications - a Collection of Classification objects that classify the object. It is analogous to a catgegoryBag in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified Classifications qualifies as a match for this criterion. The programmer may use the LifeCycleManager.createClassification method to create a transient Classification for use in this Collection.

externalLinks - a Collection of ExternalLink objects that link the object to content outside the registry. It is analogous to an overviewDoc in the UDDI specification. Unless otherwise specified in findQualifiers, this is a logical AND, and a match on all specified ExternalLinks qualifies as a match for this criterion.

Returns:

BulkResponse containing Collection of ClassificationSchemes

Throws:

JAXRException - if the JAXR provider encounters an internal error

findClassificationSchemeByName

public ClassificationScheme findClassificationSchemeByName(Collection findQualifiers,
                                                           String namePattern)
                                                    throws JAXRException

Find a ClassificationScheme by name based on the specified name pattern. If specified name pattern matches more than one ClassificationScheme then the one that is returned is implementation dependent.

Specified by:

findClassificationSchemeByName in interface BusinessQueryManager

Parameters:

namePattern - Is a String that is a partial or full name pattern with wildcard searching as specified by the SQL-92 LIKE specification.

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

Returns:

the ClassificationScheme matching the namePattern, or null if no match is found.

Throws:

JAXRException - if the JAXR provider encounters an internal error. Throws an InvalidRequestException if multiple matches are found.

findConcepts

public BulkResponse findConcepts(Collection findQualifiers,
                                 Collection namePatterns,
                                 Collection classifications,
                                 Collection externalIdentifiers,
                                 Collection externalLinks)
                          throws JAXRException

Finds all Concepts that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findConcepts in interface BusinessQueryManager

Parameters:

findQualifier - specifies qualifiers that effect string matching, sorting etc.

Returns:

BulkResponse containing Collection of Concepts

Throws:

JAXRException - if the JAXR provider encounters an internal error

findConceptByPath

public Concept findConceptByPath(String path)
                          throws JAXRException

Find a Concept based on the path specified. If specified path matches more than one ClassificationScheme then the one that is most general (higher in the concept hierarchy) is returned.

Specified by:

findConceptByPath in interface BusinessQueryManager

Parameters:

path - Is an XPATH expression that identifies the Concept.

Returns:

the Concept found, or null if no match is found

Throws:

JAXRException - if the JAXR provider encounters an internal error

findRegistryPackages

public BulkResponse findRegistryPackages(Collection findQualifiers,
                                         Collection namePatterns,
                                         Collection classifications,
                                         Collection externalLinks)
                                  throws JAXRException

Finds all Pac kages that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 1

Specified by:

findRegistryPackages in interface BusinessQueryManager

Parameters:

findQualifier - specifies qualifiers that effect string matching, sorting etc.

Returns:

BulkResponse containing Collection of Packages

Throws:

JAXRException - if the JAXR provider encounters an internal error

findAssociations

public BulkResponse findAssociations(Collection findQualifiers,
                                     String sourceObjectId,
                                     String targetObjectId,
                                     Collection associationTypes)
                              throws JAXRException

Finds all Associations that match ALL of the criteria specified by the parameters of this call. This is a Logical AND operation between all non-null parameters.

Capability Level: 0

Specified by:

findAssociations in interface BusinessQueryManager

Parameters:

sourceObjectId - Is a String that represents the id for a RegistryObject which must be the sourceObject of the Associations that match. This parameter is ignored if specified as null.

targetObjectId - Is a String that represents the id for a RegistryObject which must be the targetObject of the Associations that match. This parameter is ignored if specified as null.

associationTypes - Is a Collection of associationsType. This is a logical OR operation across the collection. This parameter is ignored if specified as null.

sourceObjectConfirmed - If true, provider must include Associations owned by caller that have their sourceObject confirmed. If false, provider must include Associations owned by caller that have their sourceObject not confirmed. This parameter is ignored if specified as null.

targetObjectConfirmed - If true, provider must include Associations owned by caller that have their targetObject confirmed. If false, provider must include Associations owned by caller that have their targetObject not confirmed. This parameter is ignored if specified as null.

Returns:

BulkResponse containing Collection of Associations

Throws:

JAXRException - if the JAXR provider encounters an internal error

findCallerAssociations

public BulkResponse findCallerAssociations(Collection findQualifiers,
                                           Boolean confirmedByCaller,
                                           Boolean confirmedByOther,
                                           Collection associationTypes)
                                    throws JAXRException

Description copied from interface: BusinessQueryManager

Finds all Association objects owned by the caller that match all of the criteria specified by the parameters of this call. This is a logical AND operation between all non-null parameters. If no parameters are specified, no Associations are returned.

This call is sensitive to the identity of the caller and is a privileged operation that requires the caller to have provided its identity credentials to the Connection associated with this object.

Capability Level: 0

Specified by:

findCallerAssociations in interface BusinessQueryManager

Parameters:

findQualifiers - a Collection of find qualifiers as defined by the FindQualifier interface, which specifies qualifiers that affect string matching, sorting, boolean predicate logic, and the like.

confirmedByCaller - If true, provider must include Associations involving the caller that have been confirmed by the caller. If false, provider must include Associations involving the caller that have not been confirmed by the caller. This parameter is ignored if specified as null.

confirmedByOther - If true, provider must include Associations involving the caller that have been confirmed by the other party. If false, provider must include Associations involving the caller that have not been confirmed by the other party. This parameter is ignored if specified as null.

associationTypes - a Collection of associationTypes. This is a logical OR operation across the collection. This parameter is ignored if specified as null.

Returns:

a BulkResponse containing a Collection of Associations

Throws:

JAXRException - if the JAXR provider encounters an internal error