LifeCycleManager (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 LifeCycleManager

All Known Subinterfaces:
BusinessLifeCycleManager
public interface LifeCycleManager

Implemented by: BusinessLifeCycleManager

LifeCycleManager 接口是 API 中的主要接口，用于管理对信息模型定义的对象进行的生命周期操作。

如果客户端试图创建 JAXR 提供者的功能级别不支持的信息模型接口实例，则此接口的工厂方法必定抛出 UnsupportedCapabilityException。

英文文档：

The LifeCycleManager interface is the main interface in the API for managing life cycle operations on objects defined by the information model.

The factory methods of this interface must throw an UnsupportedCapabilityException if the client attempts to create an instance of an infomodel interface that is not supported by the capability level of the JAXR provider.

Author:
Farrukh S. Najmi

Field Summary
static String ASSOCIATION
           
static String AUDITABLE_EVENT
           
static String CLASSIFICATION
           
static String CLASSIFICATION_SCHEME
           
static String CONCEPT
           
static String EMAIL_ADDRESS
           
static String EXTERNAL_IDENTIFIER
           
static String EXTERNAL_LINK
           
static String EXTRINSIC_OBJECT
           
static String INTERNATIONAL_STRING
           
static String KEY
           
static String LOCALIZED_STRING
           
static String ORGANIZATION
           
static String PERSON_NAME
           
static String POSTAL_ADDRESS
           
static String REGISTRY_ENTRY
           
static String REGISTRY_PACKAGE
           
static String SERVICE
           
static String SERVICE_BINDING
           
static String SLOT
           
static String SPECIFICATION_LINK
           
static String TELEPHONE_NUMBER
           
static String USER
           
static String VERSIONABLE
           
 
Method Summary
 Association createAssociation(RegistryObject targetObject, Concept associationType)
          Creates an Association instance using the specified parameters.
 Classification createClassification(ClassificationScheme scheme, InternationalString name, String value)
          Creates a Classification instance for an external Classification using the specified InternationalString name and String value that identify a taxonomy element within the specified ClassificationScheme.
 Classification createClassification(ClassificationScheme scheme, String name, String value)
          Creates a Classification instance for an external Classification using the specified String name and String value that identify a taxonomy element within the specified ClassificationScheme.
 Classification createClassification(Concept concept)
          Creates a Classification instance for an internal Classification using the specified Concept that identifies a taxonomy element within an internal ClassificationScheme.
 ClassificationScheme createClassificationScheme(Concept concept)
          Creates a ClassificationScheme from a Concept that has no ClassificationScheme or parent Concept.
 ClassificationScheme createClassificationScheme(InternationalString name, InternationalString description)
          Creates a ClassificationScheme given the specified InternationalString parameters.
 ClassificationScheme createClassificationScheme(String name, String description)
          Creates a ClassificationScheme given the specified String parameters.
 Concept createConcept(RegistryObject parent, InternationalString name, String value)
          Creates a Concept instance using the specified parameters, where the name is an InternationalString.
 Concept createConcept(RegistryObject parent, String name, String value)
          Creates a Concept instance using the specified parameters, where the name is a String.
 EmailAddress createEmailAddress(String address)
          Creates an EmailAddress instance using an address as the parameter.
 EmailAddress createEmailAddress(String address, String type)
          Creates an EmailAddress instance using both an address and a type as parameters.
 ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme, InternationalString name, String value)
          Creates an ExternalIdentifier instance using the specified parameters, where the name is an InternationalString.
 ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme, String name, String value)
          Creates an ExternalIdentifier instance using the specified parameters, where the name is a String.
 ExternalLink createExternalLink(String externalURI, InternationalString description)
          Creates an ExternalLink instance using the specified parameters, where the description is an InternationalString.
 ExternalLink createExternalLink(String externalURI, String description)
          Creates an ExternalLink instance using the specified parameters, where the description is a String.
 ExtrinsicObject createExtrinsicObject(DataHandler repositoryItem)
          Creates an ExtrinsicObject instance using the specified parameters.
 InternationalString createInternationalString()
          Creates an empty InternationalString instance.
 InternationalString createInternationalString(Locale l, String s)
          Creates an InternationalString instance using the specified Locale and String parameters.
 InternationalString createInternationalString(String s)
          Creates an InternationalString instance using a String parameter and the default Locale.
 Key createKey(String id)
          Creates a Key instance from an ID.
 LocalizedString createLocalizedString(Locale l, String s)
          Creates a LocalizedString instance using the specified Locale and String parameters.
 LocalizedString createLocalizedString(Locale l, String s, String charSetName)
          Creates a LocalizedString instance using the specified Locale, String, and character set parameters.
 Object createObject(String interfaceName)
          Creates instances of information model interfaces (factory method).
 Organization createOrganization(InternationalString name)
          Creates an Organization instance using the specified name, where the name is an InternationalString.
 Organization createOrganization(String name)
          Creates an Organization instance using the specified name, where the name is a String.
 PersonName createPersonName(String fullName)
          Creates a PersonName instance using the specified full name.
 PersonName createPersonName(String firstName, String middleName, String lastName)
          Creates a PersonName instance using the specified first, middle, and last names.
 PostalAddress createPostalAddress(String streetNumber, String street, String city, String stateOrProvince, String country, String postalCode, String type)
          Creates a PostalAddress instance using the specified parameters.
 RegistryPackage createRegistryPackage(InternationalString name)
          Creates a RegistryPackage instance using the specified name, where the name is an InternationalString.
 RegistryPackage createRegistryPackage(String name)
          Creates a RegistryPackage instance using the specified name, where the name is a String.
 Service createService(InternationalString name)
          Creates a Service instance using the specified name, where the name is an InternationalString.
 Service createService(String name)
          Creates a Service instance using the specified name, where the name is a String.
 ServiceBinding createServiceBinding()
          Creates an empty ServiceBinding instance.
 Slot createSlot(String name, Collection values, String slotType)
          Creates a Slot instance using the specified parameters, where the value is a Collection of Strings.
 Slot createSlot(String name, String value, String slotType)
          Creates a Slot instance using the specified parameters, where the value is a String.
 SpecificationLink createSpecificationLink()
          Creates an empty SpecificationLink instance.
 TelephoneNumber createTelephoneNumber()
          Creates an empty TelephoneNumber instance.
 User createUser()
          Creates an empty User instance.
 BulkResponse deleteObjects(Collection keys)
          Deletes one or more previously submitted objects from the registry using the object keys.
 BulkResponse deleteObjects(Collection keys, String objectType)
          Deletes one or more previously submitted objects from the registry using the object keys and a specified objectType attribute.
 BulkResponse deprecateObjects(Collection keys)
          Deprecates one or more previously submitted objects.
 RegistryService getRegistryService()
          Returns the parent RegistryService that created this object.
 BulkResponse saveObjects(Collection objects)
          Saves one or more Objects to the registry.
 BulkResponse unDeprecateObjects(Collection keys)
          Undeprecates one or more previously deprecated objects.
 

Field Detail

英文文档：

ASSOCIATION 

static final String ASSOCIATION
See Also:
Constant Field Values

英文文档：

AUDITABLE_EVENT 

static final String AUDITABLE_EVENT
See Also:
Constant Field Values

英文文档：

CLASSIFICATION 

static final String CLASSIFICATION
See Also:
Constant Field Values

英文文档：

CLASSIFICATION_SCHEME 

static final String CLASSIFICATION_SCHEME
See Also:
Constant Field Values

英文文档：

CONCEPT 

static final String CONCEPT
See Also:
Constant Field Values

英文文档：

EMAIL_ADDRESS 

static final String EMAIL_ADDRESS
See Also:
Constant Field Values

英文文档：

EXTERNAL_IDENTIFIER 

static final String EXTERNAL_IDENTIFIER
See Also:
Constant Field Values

英文文档：

EXTERNAL_LINK 

static final String EXTERNAL_LINK
See Also:
Constant Field Values

英文文档：

EXTRINSIC_OBJECT 

static final String EXTRINSIC_OBJECT
See Also:
Constant Field Values

英文文档：

INTERNATIONAL_STRING 

static final String INTERNATIONAL_STRING
See Also:
Constant Field Values

英文文档：

KEY 

static final String KEY
See Also:
Constant Field Values

英文文档：

LOCALIZED_STRING 

static final String LOCALIZED_STRING
See Also:
Constant Field Values

英文文档：

ORGANIZATION 

static final String ORGANIZATION
See Also:
Constant Field Values

英文文档：

PERSON_NAME 

static final String PERSON_NAME
See Also:
Constant Field Values

英文文档：

POSTAL_ADDRESS 

static final String POSTAL_ADDRESS
See Also:
Constant Field Values

英文文档：

REGISTRY_ENTRY 

static final String REGISTRY_ENTRY
See Also:
Constant Field Values

英文文档：

REGISTRY_PACKAGE 

static final String REGISTRY_PACKAGE
See Also:
Constant Field Values

英文文档：

SERVICE 

static final String SERVICE
See Also:
Constant Field Values

英文文档：

SERVICE_BINDING 

static final String SERVICE_BINDING
See Also:
Constant Field Values

英文文档：

SLOT 

static final String SLOT
See Also:
Constant Field Values

英文文档：

SPECIFICATION_LINK 

static final String SPECIFICATION_LINK
See Also:
Constant Field Values

英文文档：

TELEPHONE_NUMBER 

static final String TELEPHONE_NUMBER
See Also:
Constant Field Values

英文文档：

USER 

static final String USER
See Also:
Constant Field Values

英文文档：

VERSIONABLE 

static final String VERSIONABLE
See Also:
Constant Field Values
Method Detail

public Object createObject(String interfaceName) throws JAXRException, InvalidRequestException, UnsupportedCapabilityException
创建信息模型接口的实例（工厂方法）。要创建 Organization，可按以下方式使用此方法： 
Organization org = (Organization) 
lifeCycleMgr.createObject(LifeCycleManager.ORGANIZATION);

功能级别：0
interfaceName javax.xml.registry.infomodel 包中某个接口的非限定名称
return 随后可强制转换为接口实例的 Object
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
ThrowsInvalidRequestException: 如果该接口不是 javax.xml.registry.infomodel 包中的接口
ThrowsUnsupportedCapabilityException: 如果客户端试图创建 JAXR 提供者的功能级别不支持的信息模型接口实例
英文文档：

createObject

Object createObject(String interfaceName)
                    throws JAXRException,
                           InvalidRequestException,
                           UnsupportedCapabilityException
Creates instances of information model interfaces (factory method). To create an Organization, use this method as follows: 
 Organization org = (Organization) 
    lifeCycleMgr.createObject(LifeCycleManager.ORGANIZATION);

Capability Level: 0

Parameters:
interfaceName - the unqualified name of an interface in the javax.xml.registry.infomodel package
Returns:
an Object that can then be cast to an instance of the interface
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException - if the interface is not an interface in the javax.xml.registry.infomodel package
UnsupportedCapabilityException - if the client attempts to create an instance of an infomodel interface that is not supported by the capability level of the JAXR provider

public Association createAssociation(RegistryObject targetObject, Concept associationType) throws JAXRException
使用指定参数创建一个 Association 实例。sourceObject 保留为 null，将在 Association 添加到 RegistryObject 时设置。

注意，对于 UDDI 提供者，只能在 Organization 之间创建 Association。

功能级别：0
targetObject 用于 Association 的目标 RegistryObject
associationType Association 的关联类型
return 创建的 Association 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createAssociation

Association createAssociation(RegistryObject targetObject,
                              Concept associationType)
                              throws JAXRException
Creates an Association instance using the specified parameters. The sourceObject is left null and will be set when the Association is added to a RegistryObject.

Note that for a UDDI provider an Association may only be created between Organizations.

Capability Level: 0

Parameters:
targetObject - the target RegistryObject for the association
associationType - the association type for the Association
Returns:
the Association instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Classification createClassification(ClassificationScheme scheme, String name, String value) throws JAXRException
创建一个类型为外部 Classification 的 Classification 实例，使用指定 String 名称和 String 值标识指定 ClassificationScheme 中的分类元素。

功能级别：0
scheme 将使用的 ClassificationScheme
name 分类元素的名称（一个 String）
value 分类元素的值
return 创建的 Classification 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createClassification

Classification createClassification(ClassificationScheme scheme,
                                    String name,
                                    String value)
                                    throws JAXRException
Creates a Classification instance for an external Classification using the specified String name and String value that identify a taxonomy element within the specified ClassificationScheme.

Capability Level: 0

Parameters:
scheme - the ClassificationScheme to be used
name - the name of the taxonomy element (a String)
value - the value of the taxonomy element
Returns:
the Classification instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Classification createClassification(ClassificationScheme scheme, InternationalString name, String value) throws JAXRException
创建一个类型为外部 Classification 的 Classification 实例，使用指定 InternationalString 名称和 String 值标识指定 ClassificationScheme 中的分类元素。

功能级别：0
scheme 将使用的 ClassificationScheme
name 分类元素的名称（一个 InternationalString）
value 分类元素的值
return 创建的 Classification 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createClassification

Classification createClassification(ClassificationScheme scheme,
                                    InternationalString name,
                                    String value)
                                    throws JAXRException
Creates a Classification instance for an external Classification using the specified InternationalString name and String value that identify a taxonomy element within the specified ClassificationScheme.

Capability Level: 0

Parameters:
scheme - the ClassificationScheme to be used
name - the name of the taxonomy element (an InternationalString)
value - the value of the taxonomy element
Returns:
the Classification instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Classification createClassification(Concept concept) throws JAXRException, InvalidRequestException
创建一个类型为内部 Classification 的 Classification 实例，使用指定的 Concept 标识内部 ClassificationScheme 中的分类元素。

功能级别：0
concept 标识分类元素的 Concept
return 创建的 Classification 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
ThrowsInvalidRequestException: 如果 Concept 不属于某个 ClassificationScheme
英文文档：

createClassification

Classification createClassification(Concept concept)
                                    throws JAXRException,
                                           InvalidRequestException
Creates a Classification instance for an internal Classification using the specified Concept that identifies a taxonomy element within an internal ClassificationScheme.

Capability Level: 0

Parameters:
concept - the Concept that identifies the taxonomy element
Returns:
the Classification instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException - if the Concept is not under a ClassificationScheme

public ClassificationScheme createClassificationScheme(String name, String description) throws JAXRException, InvalidRequestException
根据指定的 String 参数创建 ClassificationScheme。

功能级别：0
name ClassificationScheme 的名称（一个 String）
description ClassificationScheme 的描述（一个 String）
return 创建的 ClassificationScheme 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createClassificationScheme

ClassificationScheme createClassificationScheme(String name,
                                                String description)
                                                throws JAXRException,
                                                       InvalidRequestException
Creates a ClassificationScheme given the specified String parameters.

Capability Level: 0

Parameters:
name - the name of the ClassificationScheme (a String)
description - a description of the ClassificationScheme (a String)
Returns:
the ClassificationScheme instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException

public ClassificationScheme createClassificationScheme(InternationalString name, InternationalString description) throws JAXRException, InvalidRequestException
根据指定的 InternationalString 参数创建 ClassificationScheme。

功能级别：0
name ClassificationScheme 的名称（一个 InternationalString）
description ClassificationScheme 的描述（一个 InternationalString）
return 创建的 ClassificationScheme 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createClassificationScheme

ClassificationScheme createClassificationScheme(InternationalString name,
                                                InternationalString description)
                                                throws JAXRException,
                                                       InvalidRequestException
Creates a ClassificationScheme given the specified InternationalString parameters.

Capability Level: 0

Parameters:
name - the name of the ClassificationScheme (an InternationalString)
description - a description of the ClassificationScheme (an InternationalString)
Returns:
the ClassificationScheme instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException

public ClassificationScheme createClassificationScheme(Concept concept) throws JAXRException, InvalidRequestException
根据没有任何 ClassificationScheme 或父 Concept 的 Concept 创建 ClassificationScheme。

此方法是一个特殊情况下使用的方法，用于执行从 Concept 到 ClassificationScheme 的类型安全转换。

提供此方法是为了支持将 BusinessQueryManager findConcept 调用返回的 Concept 安全地强制转换为 ClassificationScheme。编程人员负责确保 Concept 在语义上确实是一个 ClassificationScheme。

此方法是必需的，因为在 UDDI 规范中，tModel 可能有多种用途，无法知道将 tModel 映射到 Concept 的时间以及将 tModel 映射到 ClassificationScheme 的时间。UDDI 规范将确认的任务留给编程人员，因此，此方法也这样做。

功能级别：0
concept 将使用的 Concept
return 创建的 ClassificationScheme 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
ThrowsInvalidRequestException: 如果 Concept 有一个父 Concept，或者属于某个 ClassificationScheme
英文文档：

createClassificationScheme

ClassificationScheme createClassificationScheme(Concept concept)
                                                throws JAXRException,
                                                       InvalidRequestException
Creates a ClassificationScheme from a Concept that has no ClassificationScheme or parent Concept.

This method is a special-case method to do a type-safe conversion from Concept to ClassificationScheme.

This method is provided to allow for Concepts returned by the BusinessQueryManager findConcepts call to be safely cast to ClassificationScheme. It is up to the programmer to make sure that the Concept is indeed semantically a ClassificationScheme.

This method is necessary because in the UDDI specification a tModel may serve multiple purposes, and there is no way to know when a tModel maps to a Concept and when it maps to a ClassificationScheme. The UDDI specification leaves the determination to the programmer, and consequently so does this method.

Capability Level: 0

Parameters:
concept - the Concept to be used
Returns:
the ClassificationScheme instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException - if the Concept has a parent Concept or is under a ClassificationScheme

public Concept createConcept(RegistryObject parent, String name, String value) throws JAXRException
使用指定的参数创建 Concept 实例，其中 name 是一个 String。

功能级别：0
parent 对父 ClassificationScheme 或 Concept 的引用
name Concept 的名称（一个 String）
value Concept 的值
return 创建的 Concept 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createConcept

Concept createConcept(RegistryObject parent,
                      String name,
                      String value)
                      throws JAXRException
Creates a Concept instance using the specified parameters, where the name is a String.

Capability Level: 0

Parameters:
parent - a reference either to a parent ClassificationScheme or to a Concept
name - the name of the concept (a String)
value - the value of the concept
Returns:
the Concept instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Concept createConcept(RegistryObject parent, InternationalString name, String value) throws JAXRException
使用指定的参数创建 Concept 实例，其中 name 是一个 InternationalString。

功能级别：0
parent 对父 ClassificationScheme 或 Concept 的引用
name Concept 的名称（一个 InternationalString）
value Concept 的值
return 创建的 Concept 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createConcept

Concept createConcept(RegistryObject parent,
                      InternationalString name,
                      String value)
                      throws JAXRException
Creates a Concept instance using the specified parameters, where the name is an InternationalString.

Capability Level: 0

Parameters:
parent - a reference either to a parent ClassificationScheme or to a Concept
name - the name of the concept (an InternationalString)
value - the value of the concept
Returns:
the Concept instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public EmailAddress createEmailAddress(String address) throws JAXRException
创建一个 EmailAddress 实例，使用 address 作为参数。

功能级别：0
address 电子邮件地址
return 创建的 EmailAddress 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createEmailAddress

EmailAddress createEmailAddress(String address)
                                throws JAXRException
Creates an EmailAddress instance using an address as the parameter.

Capability Level: 0

Parameters:
address - the email address
Returns:
the EmailAddress instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public EmailAddress createEmailAddress(String address, String type) throws JAXRException
创建一个 EmailAddress 实例，使用 address 和 type 作为参数。

功能级别：0
address 电子邮件地址
type 地址的类型
return 创建的 EmailAddress 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createEmailAddress

EmailAddress createEmailAddress(String address,
                                String type)
                                throws JAXRException
Creates an EmailAddress instance using both an address and a type as parameters.

Capability Level: 0

Parameters:
address - the email address
type - the type of the address
Returns:
the EmailAddress instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme, String name, String value) throws JAXRException
使用指定的参数创建 ExternalIdentifier 实例，其中 name 是一个 String。

功能级别：0
identificationScheme 使用的 ClassificationScheme
name 外部标识符的名称（一个 String）
value 外部标识符的值
return 创建的 ExternalIdentifier 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createExternalIdentifier

ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme,
                                            String name,
                                            String value)
                                            throws JAXRException
Creates an ExternalIdentifier instance using the specified parameters, where the name is a String.

Capability Level: 0

Parameters:
identificationScheme - the ClassificationScheme used
name - the name of the external identifier (a String)
value - the value of the external identifier
Returns:
the ExternalIdentifier instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme, InternationalString name, String value) throws JAXRException
使用指定的参数创建 ExternalIdentifier 实例，其中 name 是一个 InternationalString。

功能级别：0
identificationScheme 使用的 ClassificationScheme
name 外部标识符的名称（一个 InternationalString）
value 外部标识符的值
return 创建的 ExternalIdentifier 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createExternalIdentifier

ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme,
                                            InternationalString name,
                                            String value)
                                            throws JAXRException
Creates an ExternalIdentifier instance using the specified parameters, where the name is an InternationalString.

Capability Level: 0

Parameters:
identificationScheme - the ClassificationScheme used
name - the name of the external identifier (an InternationalString)
value - the value of the external identifier
Returns:
the ExternalIdentifier instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ExternalLink createExternalLink(String externalURI, String description) throws JAXRException
使用指定的参数创建 ExternalLink 实例，其中 description 是一个 String。

功能级别：0
externalURI 外部 URI
description 链接的描述（一个 String）
return 创建的 ExternalLink 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createExternalLink

ExternalLink createExternalLink(String externalURI,
                                String description)
                                throws JAXRException
Creates an ExternalLink instance using the specified parameters, where the description is a String.

Capability Level: 0

Parameters:
externalURI - the external URI
description - a description of the link (a String)
Returns:
the ExternalLink instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ExternalLink createExternalLink(String externalURI, InternationalString description) throws JAXRException
使用指定的参数创建 ExternalLink 实例，其中 description 是一个 InternationalString。

功能级别：0
externalURI 外部 URI
description 链接的描述（一个 InternationalString）
return 创建的 ExternalLink 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createExternalLink

ExternalLink createExternalLink(String externalURI,
                                InternationalString description)
                                throws JAXRException
Creates an ExternalLink instance using the specified parameters, where the description is an InternationalString.

Capability Level: 0

Parameters:
externalURI - the external URI
description - a description of the link (an InternationalString)
Returns:
the ExternalLink instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ExtrinsicObject createExtrinsicObject(DataHandler repositoryItem) throws JAXRException
使用指定的参数创建 ExtrinsicObject 实例。

功能级别：1
repositoryItem 存储库条目的 DataHandler。不得为 null。
return 创建的 ExtrinsicObject 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createExtrinsicObject

ExtrinsicObject createExtrinsicObject(DataHandler repositoryItem)
                                      throws JAXRException
Creates an ExtrinsicObject instance using the specified parameters.

Capability Level: 1

Parameters:
repositoryItem - the DataHandler for the repository item. Must not be null.
Returns:
the ExtrinsicObject instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public InternationalString createInternationalString() throws JAXRException
创建一个空的 InternationalString 实例。

功能级别：0
return 创建的 InternationalString 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createInternationalString

InternationalString createInternationalString()
                                              throws JAXRException
Creates an empty InternationalString instance.

Capability Level: 0

Returns:
the InternationalString instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public InternationalString createInternationalString(String s) throws JAXRException
使用 String 参数和默认 Locale 创建 InternationalString 实例。

功能级别：0
s 用于创建 InternationalString 的 String
return 创建的 InternationalString 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createInternationalString

InternationalString createInternationalString(String s)
                                              throws JAXRException
Creates an InternationalString instance using a String parameter and the default Locale.

Capability Level: 0

Parameters:
s - the String from which to create the InternationalString
Returns:
the InternationalString instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public InternationalString createInternationalString(java.util.Locale l, String s) throws JAXRException
使用指定 Locale 和 String 参数创建 InternationalString 实例。

功能级别：0
l 用于创建 InternationalString 的 Locale
s 用于创建 InternationalString 的 String
return 创建的 InternationalString 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createInternationalString

InternationalString createInternationalString(Locale l,
                                              String s)
                                              throws JAXRException
Creates an InternationalString instance using the specified Locale and String parameters.

Capability Level: 0

Parameters:
l - the Locale in which to create the InternationalString
s - the String from which to create the InternationalString
Returns:
the InternationalString instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Key createKey(String id) throws JAXRException
根据 ID 创建一个 Key 实例。

功能级别：0
id 用于创建 Key 的 ID 字符串
return 创建的 Key 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createKey

Key createKey(String id)
              throws JAXRException
Creates a Key instance from an ID.

Capability Level: 0

Parameters:
id - the ID string from which to create the Key
Returns:
the Key instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public LocalizedString createLocalizedString(java.util.Locale l, String s) throws JAXRException
使用指定 Locale 和 String 参数创建 LocalizedString 实例。

功能级别：0
l 用于创建 LocalizedString 的 Locale
s 用于创建 LocalizedString 的 String
return 创建的 LocalizedString 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createLocalizedString

LocalizedString createLocalizedString(Locale l,
                                      String s)
                                      throws JAXRException
Creates a LocalizedString instance using the specified Locale and String parameters.

Capability Level: 0

Parameters:
l - the Locale in which to create the LocalizedString
s - the String from which to create the LocalizedString
Returns:
the LocalizedString instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public LocalizedString createLocalizedString(java.util.Locale l, String s, String charSetName) throws JAXRException
使用指定的 Locale、String 和字符集参数创建 LocalizedString 实例。

功能级别：0
l 用于创建 LocalizedString 的 Locale
s 用于创建 LocalizedString 的 String
charSetName 将使用的字符集的名称
return 创建的 LocalizedString 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createLocalizedString

LocalizedString createLocalizedString(Locale l,
                                      String s,
                                      String charSetName)
                                      throws JAXRException
Creates a LocalizedString instance using the specified Locale, String, and character set parameters.

Capability Level: 0

Parameters:
l - the Locale in which to create the LocalizedString
s - the String from which to create the LocalizedString
charSetName - the name of the character set to use
Returns:
the LocalizedString instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Organization createOrganization(String name) throws JAXRException
使用指定的名称创建 Organization 实例，其中 name 是一个 String。

功能级别：0
name Organization 的名称
return 创建的 Organization 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createOrganization

Organization createOrganization(String name)
                                throws JAXRException
Creates an Organization instance using the specified name, where the name is a String.

Capability Level: 0

Parameters:
name - the name of the Organization
Returns:
the Organization instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Organization createOrganization(InternationalString name) throws JAXRException
使用指定的名称创建 Organization 实例，其中 name 是一个 InternationalString。

功能级别：0
name Organization 的名称
return 创建的 Organization 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createOrganization

Organization createOrganization(InternationalString name)
                                throws JAXRException
Creates an Organization instance using the specified name, where the name is an InternationalString.

Capability Level: 0

Parameters:
name - the name of the Organization
Returns:
the Organization instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public PersonName createPersonName(String firstName, String middleName, String lastName) throws JAXRException
使用指定的姓名创建 PersonName 实例。

功能级别：1
firstName 某个人的名
middleName 某个人的中间名
lastName 某个人的姓氏
return 创建的 PersonName 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createPersonName

PersonName createPersonName(String firstName,
                            String middleName,
                            String lastName)
                            throws JAXRException
Creates a PersonName instance using the specified first, middle, and last names.

Capability Level: 1

Parameters:
firstName - the person's first name
middleName - the person's middle name
lastName - the person's last name
Returns:
the PersonName instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public PersonName createPersonName(String fullName) throws JAXRException
使用指定的全名创建 PersonName 实例。

功能级别：0
fullName 某个人的全名
return 创建的 PersonName 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createPersonName

PersonName createPersonName(String fullName)
                            throws JAXRException
Creates a PersonName instance using the specified full name.

Capability Level: 0

Parameters:
fullName - the person's full name
Returns:
the PersonName instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public PostalAddress createPostalAddress(String streetNumber, String street, String city, String stateOrProvince, String country, String postalCode, String type) throws JAXRException
使用指定的参数创建 PostalAddress 实例。

功能级别：0
streetNumber 街道编号
street 街道名称
city 城市名称
stateOrProvince 州或省的名称
country 国家名称
postalCode 邮政编码（比如 US ZIP 编码）
type 地址的类型
return 创建的 PostalAddress 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createPostalAddress

PostalAddress createPostalAddress(String streetNumber,
                                  String street,
                                  String city,
                                  String stateOrProvince,
                                  String country,
                                  String postalCode,
                                  String type)
                                  throws JAXRException
Creates a PostalAddress instance using the specified parameters.

Capability Level: 0

Parameters:
streetNumber - the street number
street - the street name
city - the city name
stateOrProvince - the state or province name
country - the country name
postalCode - the postal code (such as a US ZIP code)
type - the type of the address
Returns:
the PostalAddress instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public RegistryPackage createRegistryPackage(String name) throws JAXRException
使用指定的名称创建 RegistryPackage 实例，其中 name 是一个 String。

功能级别：1
name 注册表包的名称（一个 String）
return 创建的 RegistryPackage 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createRegistryPackage

RegistryPackage createRegistryPackage(String name)
                                      throws JAXRException
Creates a RegistryPackage instance using the specified name, where the name is a String.

Capability Level: 1

Parameters:
name - the name of the registry package (a String)
Returns:
the RegistryPackage instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public RegistryPackage createRegistryPackage(InternationalString name) throws JAXRException
使用指定的名称创建 RegistryPackage 实例，其中 name 是一个 InternationalString。

功能级别：1
name 注册表包的名称（一个 InternationalString）
return 创建的 RegistryPackage 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createRegistryPackage

RegistryPackage createRegistryPackage(InternationalString name)
                                      throws JAXRException
Creates a RegistryPackage instance using the specified name, where the name is an InternationalString.

Capability Level: 1

Parameters:
name - the name of the registry package (an InternationalString)
Returns:
the RegistryPackage instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Service createService(String name) throws JAXRException
使用指定的名称创建 Service 实例，其中 name 是一个 String。

功能级别：0
name Service 的名称（一个 String）
return 创建的 Service 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createService

Service createService(String name)
                      throws JAXRException
Creates a Service instance using the specified name, where the name is a String.

Capability Level: 0

Parameters:
name - the name of the Service (a String)
Returns:
the Service instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Service createService(InternationalString name) throws JAXRException
使用指定的名称创建 Service 实例，其中 name 是一个 InternationalString。

功能级别：0
name Service 的名称（一个 InternationalString）
return 创建的 Service 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createService

Service createService(InternationalString name)
                      throws JAXRException
Creates a Service instance using the specified name, where the name is an InternationalString.

Capability Level: 0

Parameters:
name - the name of the Service (an InternationalString)
Returns:
the Service instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public ServiceBinding createServiceBinding() throws JAXRException
创建一个空 ServiceBinding 实例。

功能级别：0
return 创建的 ServiceBinding 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createServiceBinding

ServiceBinding createServiceBinding()
                                    throws JAXRException
Creates an empty ServiceBinding instance.

Capability Level: 0

Returns:
the ServiceBinding instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Slot createSlot(String name, String value, String slotType) throws JAXRException
使用指定的参数创建 Slot 实例，其中 value 是一个 String。

功能级别：0
name Slot 的名称
value 值（一个 String）
slotType Slot 类型
return 创建的 Slot 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createSlot

Slot createSlot(String name,
                String value,
                String slotType)
                throws JAXRException
Creates a Slot instance using the specified parameters, where the value is a String.

Capability Level: 0

Parameters:
name - the name of the Slot
value - the value (a String)
slotType - the slot type
Returns:
the Slot instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public Slot createSlot(String name, java.util.Collection<E> values, String slotType) throws JAXRException
使用指定的参数创建 Slot 实例，其中 value 是 String 所组成的 Collection。

功能级别：0
name Slot 的名称
value 值（String 所组成的 Collection）
slotType Slot 类型
return 创建的 Slot 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createSlot

Slot createSlot(String name,
                Collection values,
                String slotType)
                throws JAXRException
Creates a Slot instance using the specified parameters, where the value is a Collection of Strings.

Capability Level: 0

Parameters:
name - the name of the Slot
value - the value (a Collection of Strings)
slotType - the slot type
Returns:
the Slot instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public SpecificationLink createSpecificationLink() throws JAXRException
创建一个空 SpecificationLink 实例。

功能级别：0
return 创建的 SpecificationLink 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createSpecificationLink

SpecificationLink createSpecificationLink()
                                          throws JAXRException
Creates an empty SpecificationLink instance.

Capability Level: 0

Returns:
the SpecificationLink instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public TelephoneNumber createTelephoneNumber() throws JAXRException
创建一个空 TelephoneNumber 实例。

功能级别：0
return 创建的 TelephoneNumber 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createTelephoneNumber

TelephoneNumber createTelephoneNumber()
                                      throws JAXRException
Creates an empty TelephoneNumber instance.

Capability Level: 0

Returns:
the TelephoneNumber instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public User createUser() throws JAXRException
创建一个空 User 实例。

功能级别：0
return 创建的 User 实例
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

createUser

User createUser()
                throws JAXRException
Creates an empty User instance.

Capability Level: 0

Returns:
the User instance created
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse saveObjects(java.util.Collection<E> objects) throws JAXRException
将一个或多个 Object 保存到注册表。对象可以是 RegistryObject 子类实例。

如果注册表中没有该对象，则将在注册表中创建它。如果它已经存在于注册表中且被修改过，则将在注册表中更新（替换）其状态。

功能级别：0
objects 可能的异构 RegistryObject 实例所组成的 Collection
return 一个 BulkResponse，它包含以下对象的键所组成的 Collection：成功保存的那些对象；部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

saveObjects

BulkResponse saveObjects(Collection objects)
                         throws JAXRException
Saves one or more Objects to the registry. An object may be a RegistryObject subclass instance.

If an object is not in the registry, it is created in the registry. If it already exists in the registry and has been modified, then its state is updated (replaced) in the registry.

Capability Level: 0

Parameters:
objects - a potentially heterogeneous Collection of RegistryObject instances
Returns:
a BulkResponse containing the Collection of keys for those objects that were saved successfully and any SaveException that was encountered in case of partial commit
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse deprecateObjects(java.util.Collection<E> keys) throws JAXRException
废弃以前提交的一个或多个对象。废弃操作将对象标记为 "soon to be deleted"。废弃某个对象后，JAXR 提供者不得允许提交对该对象的任何新引用（例如，新的 Associations、Classifications 和 ExternalLinks）。如果客户端执行可导致对废弃对象的新引用的 API 调用，则 JAXR 提供者必定抛出 JAXRException 中的 java.lang.IllegalStateException。但是，对废弃对象的现有引用可以继续正常使用。

功能级别：1
keys 将废弃的对象的键所组成的 Collection
return 一个 BulkResponse，它包含成功废弃的那些对象的键所组成的 Collection，以及部分提交情况下遇到的任何 JAXRException
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

deprecateObjects

BulkResponse deprecateObjects(Collection keys)
                              throws JAXRException
Deprecates one or more previously submitted objects. Deprecation marks an object as "soon to be deleted". Once an object is deprecated, the JAXR provider must not allow any new references (e.g. new Associations, Classifications and ExternalLinks) to that object to be submitted. If a client makes an API call that results in a new reference to a deprecated object, the JAXR provider must throw a java.lang.IllegalStateException within a JAXRException. However, existing references to a deprecated object continue to function normally.

Capability Level: 1

Parameters:
keys - a Collection of keys for the objects to be deprecated
Returns:
a BulkResponse containing the Collection of keys for those objects that were deprecated successfully and any JAXRException that was encountered in case of partial commit
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse unDeprecateObjects(java.util.Collection<E> keys) throws JAXRException
取消以前废弃的一个或多个对象的废弃状态。如果某个对象以前没有废弃，这也不是一个错误，不会抛出任何异常。取消废弃某个对象后，JAXR 提供者必须再次允许提交对该对象的新引用（例如，新的 Associations、Classifications 和 ExternalLinks）。

功能级别：1
keys 将取消废弃的对象的键所组成的 Collection
return 一个 BulkResponse，它包含成功废弃的那些对象的键所组成的 Collection，以及部分提交情况下遇到的任何 JAXRException
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

unDeprecateObjects

BulkResponse unDeprecateObjects(Collection keys)
                                throws JAXRException
Undeprecates one or more previously deprecated objects. If an object was not previously deprecated, it is not an error, and no exception is thrown. Once an object is undeprecated, the JAXR provider must again allow new references (e.g. new Associations, Classifications and ExternalLinks) to that object to be submitted.

Capability Level: 1

Parameters:
keys - a Collection of keys for the objects to be undeprecated
Returns:
a BulkResponse containing the Collection of keys for those objects that were deprecated successfully and any JAXRException that was encountered in case of partial commit
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse deleteObjects(java.util.Collection<E> keys) throws JAXRException
使用对象键从注册表中删除以前提交的一个或多个对象。

功能级别：1
keys 将删除的对象的键所组成的 Collection
return 一个 BulkResponse，它包含成功删除的那些对象的键所组成的 Collection，以及部分提交情况下遇到的任何 DeleteException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

deleteObjects

BulkResponse deleteObjects(Collection keys)
                           throws JAXRException
Deletes one or more previously submitted objects from the registry using the object keys.

Capability Level: 1

Parameters:
keys - a Collection of keys for the objects to be deleted
Returns:
a BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit
Throws:
JAXRException - if the JAXR provider encounters an internal error

public BulkResponse deleteObjects(java.util.Collection<E> keys, String objectType) throws JAXRException
使用对象键和指定的 objectType 属性从注册表中删除以前提交的一个或多个对象。

功能级别：0
keys 将删除的对象的键所组成的 Collection
objectType 将删除的对象的 objectType 属性
return 一个 BulkResponse，它包含成功删除的那些对象的键所组成的 Collection，以及部分提交情况下遇到的任何 DeleteException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档：

deleteObjects

BulkResponse deleteObjects(Collection keys,
                           String objectType)
                           throws JAXRException
Deletes one or more previously submitted objects from the registry using the object keys and a specified objectType attribute.

Capability Level: 0

Parameters:
keys - a Collection of keys for the objects to be deleted
objectType - the objectType attribute for the objects to be deleted
Returns:
a BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit
Throws:
JAXRException - if the JAXR provider encounters an internal error

public RegistryService getRegistryService() throws JAXRException
返回创建此对象的父 RegistryService。

功能级别：0
return 父 RegistryService
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
associates <{javax.xml.registry.RegistryService}>
英文文档：

getRegistryService

RegistryService getRegistryService()
                                   throws JAXRException
Returns the parent RegistryService that created this object.

Capability Level: 0

Returns:
the parent RegistryService
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