BusinessQueryManager (Java EE 5)

Java EE API

previous page next page
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

javax.xml.registry Interface BusinessQueryManager

All Superinterfaces:
QueryManager
public interface BusinessQueryManager
extends QueryManager

Implements: QueryManager

BusinessQueryManager 接口是通过 Registry Service 公开的，它实现业务样式的查询接口。它也被称为焦点查询接口。
See also javax.xml.registry.DeclarativeQueryManager, javax.xml.registry.FindQualifier, javax.xml.registry.BulkResponse
英文文档：

The BusinessQueryManager interface, which is exposed by the Registry Service, implements the business style query interface. It is also referred to as the focused query interface.

Author:
Farrukh S. Najmi
See Also:
DeclarativeQueryManager, FindQualifier, BulkResponse

Method Summary
 BulkResponse findAssociations(Collection findQualifiers, String sourceObjectId, String targetObjectId, Collection associationTypes)
          Finds all Association objects that match all of the criteria specified by the parameters of this call.
 BulkResponse findCallerAssociations(Collection findQualifiers, Boolean confirmedByCaller, Boolean confirmedByOtherParty, 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)
          Finds a ClassificationScheme by name based on the specified find qualifiers and name pattern.
 BulkResponse findClassificationSchemes(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection externalLinks)
          Finds all ClassificationScheme objects that match all of the criteria specified by the parameters of this call.
 Concept findConceptByPath(String path)
          Finds a Concept based on the path specified.
 BulkResponse findConcepts(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection externalIdentifiers, Collection externalLinks)
          Finds all Concept objects that match all of the criteria specified by the parameters of this call.
 BulkResponse findOrganizations(Collection findQualifiers, Collection namePatterns, Collection classifications, Collection specifications, Collection externalIdentifiers, Collection externalLinks)
          Finds all Organization objects 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 RegistryPackage objects 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 ServiceBinding objects 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 Service objects that match all of the criteria specified by the parameters of this call.
 
Methods inherited from interface javax.xml.registry.QueryManager
getRegistryObject, getRegistryObject, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryObjects, getRegistryService
 

Method Detail

public BulkResponse findAssociations(java.util.Collection<E> findQualifiers, String sourceObjectId, String targetObjectId, java.util.Collection<E> associationTypes) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 Association 对象。这是所有非 null 参数之间的逻辑 AND 操作。如果没有指定任何参数，则不返回任何 Association。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
sourceObjectId 表示 RegistryObject ID 的 String，该 RegistryObject 必须是匹配的 Association 的 sourceObject。如果指定为 null，则忽略此参数。
targetObjectId 表示 RegistryObject ID 的 String，该 RegistryObject 必须是匹配的 Association 的 targetObject。如果指定为 null，则忽略此参数。
associationTypes associationTypes 所组成的 Collection。这是对整个 Collection 的逻辑 OR 操作。如果指定为 null，则忽略此参数。
return 一个 BulkResponse，它包含 Association 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findAssociations

BulkResponse findAssociations(Collection findQualifiers,
                              String sourceObjectId,
                              String targetObjectId,
                              Collection associationTypes)
                              throws JAXRException
Finds all Association objects 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.

Capability Level: 0

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.
sourceObjectId - a String that represents the id for a RegistryObject that must be the sourceObject of the Associations that match. This parameter is ignored if specified as null.
targetObjectId - a String that represents the id for a RegistryObject that must be the targetObject of the Associations that match. 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

public BulkResponse findCallerAssociations(java.util.Collection<E> findQualifiers, Boolean confirmedByCaller, Boolean confirmedByOtherParty, java.util.Collection<E> associationTypes) throws JAXRException
查找调用者拥有的所有符合此调用参数所指定的所有标准的 Association 对象。这是所有非 null 参数之间的逻辑 AND 操作。如果没有指定任何参数，则不返回任何 Association。

此调用对调用者的身份很敏感，是一个特许操作，它要求调用者向与此对象关联的 Connection 提供其身份凭据。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
confirmedByCaller 如果为 true，则提供者必须包含涉及调用者的 Association，且该 Association 已经经过调用者的确认。如果为 false，则提供者必须包括涉及调用者的 Association，且该 Association 未经调用者的确认。如果指定为 null，则忽略此参数。
confirmedByOtherParty 如果为 true，则提供者必须包含涉及调用者的 Association，且该 Association 已经经过其他方的确认。如果为 false，则提供者必须包括涉及调用者的 Association，且该 Association 未经其他方的确认。如果指定为 null，则忽略此参数。
associationTypes associationTypes 所组成的 Collection。这是对整个 Collection 的逻辑 OR 操作。如果指定为 null，则忽略此参数。
return 一个 BulkResponse，它包含 Association 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findCallerAssociations

BulkResponse findCallerAssociations(Collection findQualifiers,
                                    Boolean confirmedByCaller,
                                    Boolean confirmedByOtherParty,
                                    Collection associationTypes)
                                    throws JAXRException
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

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.
confirmedByOtherParty - 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

public BulkResponse findOrganizations(java.util.Collection<E> findQualifiers, java.util.Collection<E> namePatterns, java.util.Collection<E> classifications, java.util.Collection<E> specifications, java.util.Collection<E> externalIdentifiers, java.util.Collection<E> externalLinks) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 Organization 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePatterns String 或 LocalizedString 对象所组成的 Collection。每个 String 或 LocalizedString 中的值都是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行。除非在 findQualifier 中另行指定，否则这是一个逻辑 OR，任何名称匹配都视为是符合此标准的匹配。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
specifications 表示（代理）技术规范的 RegistryObject 所组成的 Collection。这类似于 UDDI 规范中的 tModelBag。如果是 UDDI 提供者，则 RegistryObject 是规范 Concept。如果是 ebXML 提供者，则 RegistryObject 可能是 ExtrinsicObject。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Specification 的匹配都视为是符合此标准的匹配。
externalIdentifiers 为使用标识模式（如 DUNS）的对象提供外部标识符的 ExternalIdentifier 对象所组成的 Collection。这类似于 UDDI 规范中的 identifierBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalIdentifier 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createExternalIdentifier 方法创建瞬态 ExternalIdentifier，以供此 Collection 使用。
externalLinks 连接对象与注册表外部内容的 ExternalLink 对象所组成的 Collection。这类似于 UDDI 规范中的 overviewDoc。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalLink 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 Organization 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findOrganizations

BulkResponse findOrganizations(Collection findQualifiers,
                               Collection namePatterns,
                               Collection classifications,
                               Collection specifications,
                               Collection externalIdentifiers,
                               Collection externalLinks)
                               throws JAXRException
Finds all Organization objects 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

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.
externalIdentifiers - 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:
a BulkResponse containing a Collection of Organizations
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse findServices(Key orgKey, java.util.Collection<E> findQualifiers, java.util.Collection<E> namePatterns, java.util.Collection<E> classifications, java.util.Collection<E> specifications) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 Service 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：0
orgKey 标识 Organization 的 Key。需要 UDDI 提供者。
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePatterns String 或 LocalizedString 对象所组成的 Collection。每个 String 或 LocalizedString 中的值都是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行。除非在 findQualifier 中另行指定，否则这是一个逻辑 OR，任何名称匹配都视为是符合此标准的匹配。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
specifications 表示（代理）技术规范的 RegistryObject 所组成的 Collection。这类似于 UDDI 规范中的 tModelBag。如果是 UDDI 提供者，则 RegistryObject 是规范 Concept。如果是 ebXML 提供者，则 RegistryObject 可能是 ExtrinsicObject。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Specification 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 Service 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findServices

BulkResponse findServices(Key orgKey,
                          Collection findQualifiers,
                          Collection namePatterns,
                          Collection classifications,
                          Collection specifications)
                          throws JAXRException
Finds all Service objects 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

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

public BulkResponse findServiceBindings(Key serviceKey, java.util.Collection<E> findQualifiers, java.util.Collection<E> classifications, java.util.Collection<E> specifications) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 ServiceBinding 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：0
serviceKey 标识 Service 的 Key。需要 UDDI 提供者。
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
specifications 表示（代理）技术规范的 RegistryObject 所组成的 Collection。这类似于 UDDI 规范中的 tModelBag。如果是 UDDI 提供者，则 RegistryObject 是规范 Concept。如果是 ebXML 提供者，则 RegistryObject 可能是 ExtrinsicObject。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Specification 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 ServiceBinding 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findServiceBindings

BulkResponse findServiceBindings(Key serviceKey,
                                 Collection findQualifiers,
                                 Collection classifications,
                                 Collection specifications)
                                 throws JAXRException
Finds all ServiceBinding objects 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

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:
a BulkResponse containing a Collection of ServiceBindings
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse findClassificationSchemes(java.util.Collection<E> findQualifiers, java.util.Collection<E> namePatterns, java.util.Collection<E> classifications, java.util.Collection<E> externalLinks) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 ClassificationScheme 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePatterns String 或 LocalizedString 对象所组成的 Collection。每个 String 或 LocalizedString 中的值都是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行。除非在 findQualifier 中另行指定，否则这是一个逻辑 OR，任何名称匹配都视为是符合此标准的匹配。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
externalLinks 连接对象与注册表外部内容的 ExternalLink 对象所组成的 Collection。这类似于 UDDI 规范中的 overviewDoc。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalLink 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 ClassificationScheme 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findClassificationSchemes

BulkResponse findClassificationSchemes(Collection findQualifiers,
                                       Collection namePatterns,
                                       Collection classifications,
                                       Collection externalLinks)
                                       throws JAXRException
Finds all ClassificationScheme objects 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

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:
a BulkResponse containing a Collection of ClassificationSchemes
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ClassificationScheme findClassificationSchemeByName(java.util.Collection<E> findQualifiers, String namePattern) throws JAXRException
根据基于指定查找限定符和名称模式的名称查找 ClassificationScheme。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePattern 一个 String，它是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行
return 与 namePattern 匹配的 ClassificationScheme；如果没有找到任何匹配项，则返回 null。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误如果找到多个匹配项，则抛出 InvalidRequestException。
英文文档：

findClassificationSchemeByName

ClassificationScheme findClassificationSchemeByName(Collection findQualifiers,
                                                    String namePattern)
                                                    throws JAXRException
Finds a ClassificationScheme by name based on the specified find qualifiers and name pattern.

Capability Level: 0

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.
namePattern - a String that is a partial or full name pattern with wildcard searching as specified by the SQL-92 LIKE specification
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.

public BulkResponse findConcepts(java.util.Collection<E> findQualifiers, java.util.Collection<E> namePatterns, java.util.Collection<E> classifications, java.util.Collection<E> externalIdentifiers, java.util.Collection<E> externalLinks) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 Concept 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：0
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePatterns String 或 LocalizedString 对象所组成的 Collection。每个 String 或 LocalizedString 中的值都是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行。除非在 findQualifier 中另行指定，否则这是一个逻辑 OR，任何名称匹配都视为是符合此标准的匹配。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
externalIdentifiers 为使用标识模式（如 DUNS）的对象提供外部标识符的 ExternalIdentifier 对象所组成的 Collection。这类似于 UDDI 规范中的 identifierBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalIdentifier 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createExternalIdentifier 方法创建瞬态 ExternalIdentifier，以供此 Collection 使用。
externalLinks 连接对象与注册表外部内容的 ExternalLink 对象所组成的 Collection。这类似于 UDDI 规范中的 overviewDoc。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalLink 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 Concept 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findConcepts

BulkResponse findConcepts(Collection findQualifiers,
                          Collection namePatterns,
                          Collection classifications,
                          Collection externalIdentifiers,
                          Collection externalLinks)
                          throws JAXRException
Finds all Concept objects 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

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.
externalIdentifiers - 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:
a BulkResponse containing a Collection of Concepts
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Concept findConceptByPath(String path) throws JAXRException
基于指定的路径查找 Concept。如果指定的路径与多个 Concept 匹配，则返回最通用（在 Concept 分层结构中较高）的那个。

功能级别：0
path 标识 Concept 的规范路径表示，符合 JAXR 规范的定义。
return 发现的 Concept；如果没有发现任何匹配项，则返回 null
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findConceptByPath

Concept findConceptByPath(String path)
                          throws JAXRException
Finds a Concept based on the path specified. If the specified path matches more than one Concept, the one that is most general (higher in the concept hierarchy) is returned.

Capability Level: 0

Parameters:
path - a canonical path expression, as defined in the JAXR specification, 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

public BulkResponse findRegistryPackages(java.util.Collection<E> findQualifiers, java.util.Collection<E> namePatterns, java.util.Collection<E> classifications, java.util.Collection<E> externalLinks) throws JAXRException
查找所有符合此调用参数所指定的所有标准的 RegistryPackage 对象。这是所有非 null 参数之间的逻辑 AND 操作。

功能级别：1
findQualifiers FindQualifier 接口定义的 find 限定符所组成的 Collection，FindQualifier 接口指定能影响字符串匹配、排序、boolean 谓词逻辑 (predicate logic) 之类的限定符。
namePatterns String 或 LocalizedString 对象所组成的 Collection。每个 String 或 LocalizedString 中的值都是部分或完整的名称模式，通配符搜索按照 SQL-92 LIKE 规范的规定执行。除非在 findQualifier 中另行指定，否则这是一个逻辑 OR，任何名称匹配都视为是符合此标准的匹配。
classifications 对对象进行分类的 Classification 对象所组成的 Collection。这类似于 UDDI 规范中的 catgegoryBag。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 Classification 的匹配都视为是符合此标准的匹配。程序员可以使用 LifeCycleManager.createClassification 方法创建瞬态 Classification，以供此 Collection 使用。
externalLinks 连接对象与注册表外部内容的 ExternalLink 对象所组成的 Collection。这类似于 UDDI 规范中的 overviewDoc。除非在 findQualifier 中另行指定，否则这是一个逻辑 AND，所有指定 ExternalLink 的匹配都视为是符合此标准的匹配。
return 一个 BulkResponse，它包含 RegistryPackage 所组成的 Collection
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

findRegistryPackages

BulkResponse findRegistryPackages(Collection findQualifiers,
                                  Collection namePatterns,
                                  Collection classifications,
                                  Collection externalLinks)
                                  throws JAXRException
Finds all RegistryPackage objects 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

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:
a BulkResponse containing a Collection of RegistryPackages
Throws:
JAXRException - if the JAXR provider encounters an internal error
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正；若因此而造成任何损失请直接找人民主席，请勿与本人联系。谢谢！

previous page start next page