BusinessLifeCycleManager (Java EE 5)

Java EE API


javax.xml.registry Interface BusinessLifeCycleManager

All Superinterfaces:
LifeCycleManager

public interface BusinessLifeCycleManager
extends LifeCycleManager

Implements: LifeCycleManager

BusinessLifeCycleManager 接口是通过 Registry Service 公开的,它将 Registry 的生命周期管理功能作为业务级 API 的一部分实现。注意,这里不提供验证信息,因为 Connection 接口代表客户端保持该状态和上下文。
英文文档:

The BusinessLifeCycleManager interface, which is exposed by the Registry Service, implements the life cycle management functionality of the Registry as part of a business level API. Note that there is no authentication information provided, because the Connection interface keeps that state and context on behalf of the client.

Author:
Farrukh S. Najmi
See Also:
LifeCycleManager

Field Summary
 
Fields inherited from interface javax.xml.registry.LifeCycleManager
 
Method Summary
 void
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 BulkResponse
 void
 
Methods inherited from interface javax.xml.registry.LifeCycleManager
 

Method Detail

public BulkResponse saveOrganizations(java.util.Collection<E> organizations) throws JAXRException
保存指定的 Organization。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
organizations 将保存的 Organization 对象所组成的 Collection
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveOrganizations

BulkResponse saveOrganizations(Collection organizations)
                               throws JAXRException
Saves the specified Organizations.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
organizations - the Collection of Organization objects to be saved
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 saveServices(java.util.Collection<E> services) throws JAXRException
保存指定的 Service。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
services 将保存的 Service 对象所组成的 Collection
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveServices

BulkResponse saveServices(Collection services)
                          throws JAXRException
Saves the specified Services.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
services - the Collection of Service objects to be saved
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 saveServiceBindings(java.util.Collection<E> bindings) throws JAXRException
保存指定的 ServiceBinding。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
bindings 将保存的 ServiceBinding 对象所组成的 Collection
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveServiceBindings

BulkResponse saveServiceBindings(Collection bindings)
                                 throws JAXRException
Saves the specified ServiceBindings.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
bindings - the Collection of ServiceBinding objects to be saved
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 saveConcepts(java.util.Collection<E> concepts) throws JAXRException
保存指定的 Concept。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
concepts 将保存的 Concept 对象所组成的 Collection
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveConcepts

BulkResponse saveConcepts(Collection concepts)
                          throws JAXRException
Saves the specified Concepts.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
concepts - the Collection of Concept objects to be saved
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 saveClassificationSchemes(java.util.Collection<E> schemes) throws JAXRException
保存指定的 ClassificationScheme 实例。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
schemes 将保存的 ClassificationScheme 对象所组成的 Collection
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveClassificationSchemes

BulkResponse saveClassificationSchemes(Collection schemes)
                                       throws JAXRException
Saves the specified ClassificationScheme instances.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
schemes - the Collection of ClassificationScheme objects to be saved
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 saveAssociations(java.util.Collection<E> associations, boolean replace) throws JAXRException
保存指定的 Association 实例。

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

允许部分提交。处理过程将在遇到第一个 SaveException 时停止。

功能级别:0
associations 将保存的 Association 对象所组成的 Collection
replace 如果设置为 true,则使用指定的关联替换调用者拥有的所有现有关联。如果设置为 false,则保存指定的关联,同时保留没有被此调用更新的所有现有关联。
return 一个 BulkResponse,它包含以下对象的键所组成的 Collection:成功保存的那些对象;部分提交情况下遇到的任何 SaveException。
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

saveAssociations

BulkResponse saveAssociations(Collection associations,
                              boolean replace)
                              throws JAXRException
Saves the specified Association instances.

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

Partial commits are allowed. Processing stops on first SaveException encountered.

Capability Level: 0

Parameters:
associations - the Collection of Association objects to be saved
replace - If set to true, the specified associations replace any existing associations owned by the caller. If set to false, the specified associations are saved, while any existing associations not being updated by this call are preserved.
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 deleteOrganizations(java.util.Collection<E> organizationKeys) throws JAXRException
删除对应于指定 Key 的组织。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteOrganizations

BulkResponse deleteOrganizations(Collection organizationKeys)
                                 throws JAXRException
Deletes the organizations corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
organizationKeys - the Collection of keys for the Organization 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 deleteServices(java.util.Collection<E> serviceKeys) throws JAXRException
删除对应于指定 Key 的服务。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteServices

BulkResponse deleteServices(Collection serviceKeys)
                            throws JAXRException
Deletes the services corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
serviceKeys - the Collection of keys for the Service 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 deleteServiceBindings(java.util.Collection<E> bindingKeys) throws JAXRException
删除对应于指定 Key 的 ServiceBinding。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteServiceBindings

BulkResponse deleteServiceBindings(Collection bindingKeys)
                                   throws JAXRException
Deletes the ServiceBindings corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
bindingKeys - the Collection of keys for the ServiceBinding 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 deleteConcepts(java.util.Collection<E> conceptKeys) throws JAXRException
删除对应于指定 Key 的 Concept。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteConcepts

BulkResponse deleteConcepts(Collection conceptKeys)
                            throws JAXRException
Deletes the Concepts corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
conceptKeys - the Collection of keys for the Concept 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 deleteClassificationSchemes(java.util.Collection<E> schemeKeys) throws JAXRException
删除对应于指定 Key 的 ClassificationScheme。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteClassificationSchemes

BulkResponse deleteClassificationSchemes(Collection schemeKeys)
                                         throws JAXRException
Deletes the ClassificationSchemes corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
schemeKeys - the Collection of keys for the ClassificationScheme 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 deleteAssociations(java.util.Collection<E> associationKeys) throws JAXRException
删除对应于指定 Key 的 Association。

允许部分提交。处理过程将在遇到第一个 DeleteException 时停止。

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

deleteAssociations

BulkResponse deleteAssociations(Collection associationKeys)
                                throws JAXRException
Deletes the Associations corresponding to the specified Keys.

Partial commits are allowed. Processing stops on first DeleteException encountered.

Capability Level: 0

Parameters:
associationKeys - the Collection of keys for the Association 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 void confirmAssociation(Association assoc) throws JAXRException, InvalidRequestException
与调用者关联的 User 确认此 Association。在此 Association 中,User 必须是 sourceObject 或 targetObject 的所有者。

  • 如果 Association 是内部的,则此方法不执行任何操作并返回。
  • 如果 Association 是外部的,并且已经经过确认(isConfirmed 返回 true),则此方法不执行任何操作并返回。
  • 如果 Association 是外部的,并且未经确认,则此方法将确认与调用者关联的 User 的关联。

确认外部 Association 的细节是特定于注册表的。对于 UDDI 和 ebXML 注册表,特定于注册表的详细信息在 JAXR 规范中描述。

功能级别:0
assoc 将确认的 Association 对象
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
ThrowsInvalidRequestException: 如果 User 不是 sourceObject 或 targetObject 的所有者
英文文档:

confirmAssociation

void confirmAssociation(Association assoc)
                        throws JAXRException,
                               InvalidRequestException
Confirms this Association by the User associated with the caller. The User must be the owner of the sourceObject or the targetObject in this association.

  • If the Association is intramural, this method does nothing and returns.
  • If the Association is extramural and already confirmed (isConfirmed returns true), this method does nothing and returns.
  • If the Association is extramural and not already confirmed, this method confirms the association for the User associated with the caller.

The details of confirming an extramural Association are registry-specific. For UDDI and ebXML registries, the registry-specific details are described in the JAXR specification.

Capability Level: 0

Parameters:
assoc - the Association object to be confirmed
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException - if the User is not the owner of the sourceObject or the targetObject

public void unConfirmAssociation(Association assoc) throws JAXRException, InvalidRequestException
与调用者关联的 User 取消此 Association 以前的确认。在此 Association 中,User 必须是 sourceObject 或 targetObject 的所有者。

  • 如果 Association 是内部的,则此方法不执行任何操作并返回。
  • 如果 Association 是外部的,并且已经经过确认(isConfirmed 返回 true),则此方法将针对请求者取消确认。
  • 如果 Association 是外部的,并且未经确认,则此方法不执行任何操作并返回。

取消外部 Association 的确认的细节是特定于注册表的。对于 UDDI 和 ebXML 注册表,特定于注册表的详细信息在 JAXR 规范中描述。

功能级别:0
assoc 将取消确认的 Association 对象
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
ThrowsInvalidRequestException: 如果 User 不是 sourceObject 或 targetObject 的所有者
英文文档:

unConfirmAssociation

void unConfirmAssociation(Association assoc)
                          throws JAXRException,
                                 InvalidRequestException
Undoes a previous confirmation of this Association by the User associated with the caller. The User must be the owner of the sourceObject or the targetObject in this association.

  • If the Association is intramural, this method does nothing and returns.
  • If the Association is extramural and already confirmed (isConfirmed returns true), this method unconfirms it for the requestor.
  • If the Association is extramural and not already confirmed, this method does nothing and returns.

The details of unconfirming an extramural Association are registry-specific. For UDDI and ebXML registries, the registry-specific details are described in the JAXR specification.

Capability Level: 0

Parameters:
assoc - the Association object to be unconfirmed
Throws:
JAXRException - if the JAXR provider encounters an internal error
InvalidRequestException - if the User is not the owner of the sourceObject or the targetObject


Submit a bug or feature

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

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

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