Top Description Fields Methods
javax.xml.registry

public Interface BusinessLifeCycleManager

extends LifeCycleManager
Imports
java.util.*, javax.xml.registry.infomodel.*

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

Inherited from javax.xml.registry.LifeCycleManager:
ASSOCIATIONAUDITABLE_EVENTCLASSIFICATIONCLASSIFICATION_SCHEMECONCEPTEMAIL_ADDRESSEXTERNAL_IDENTIFIEREXTERNAL_LINKEXTRINSIC_OBJECTINTERNATIONAL_STRINGKEYLOCALIZED_STRINGORGANIZATIONPERSON_NAMEPOSTAL_ADDRESSREGISTRY_ENTRYREGISTRY_PACKAGESERVICESERVICE_BINDINGSLOTSPECIFICATION_LINKTELEPHONE_NUMBERUSERVERSIONABLE

Method Summary

Modifier and TypeMethod and Description
public void
confirmAssociation(Association
the Association object to be confirmed
assoc
)

Confirms this Association by the User associated with the caller.

public BulkResponse

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
deleteAssociations
(Collection<E>
the Collection of keys for the Association objects to be deleted
associationKeys
)

Deletes the Associations corresponding to the specified Keys.

public BulkResponse

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
deleteClassificationSchemes
(Collection<E>
the Collection of keys for the ClassificationScheme objects to be deleted
schemeKeys
)

Deletes the ClassificationSchemes corresponding to the specified Keys.

public BulkResponse

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
deleteConcepts
(Collection<E>
the Collection of keys for the Concept objects to be deleted
conceptKeys
)

Deletes the Concepts corresponding to the specified Keys.

public BulkResponse

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
deleteOrganizations
(Collection<E>
the Collection of keys for the Organization objects to be deleted
organizationKeys
)

Deletes the organizations corresponding to the specified Keys.

public BulkResponse

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
deleteServiceBindings
(Collection<E>
the Collection of keys for the ServiceBinding objects to be deleted
bindingKeys
)

Deletes the ServiceBindings corresponding to the specified Keys.

public BulkResponse

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
deleteServices
(Collection<E>
the Collection of keys for the Service objects to be deleted
serviceKeys
)

Deletes the services corresponding to the specified Keys.

public BulkResponse

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
saveAssociations
(Collection<E>
the Collection of Association objects to be saved
associations
,
boolean
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.
replace
)

Saves the specified Association instances.

public BulkResponse

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
saveClassificationSchemes
(Collection<E>
the Collection of ClassificationScheme objects to be saved
schemes
)

Saves the specified ClassificationScheme instances.

public BulkResponse

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
saveConcepts
(Collection<E>
the Collection of Concept objects to be saved
concepts
)

Saves the specified Concepts.

public BulkResponse

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
saveOrganizations
(Collection<E>
the Collection of Organization objects to be saved
organizations
)

Saves the specified Organizations.

public BulkResponse

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
saveServiceBindings
(Collection<E>
the Collection of ServiceBinding objects to be saved
bindings
)

Saves the specified ServiceBindings.

public BulkResponse

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
saveServices
(Collection<E>
the Collection of Service objects to be saved
services
)

Saves the specified Services.

public void
unConfirmAssociation(Association
the Association object to be unconfirmed
assoc
)

Undoes a previous confirmation of this Association by the User associated with the caller.

Inherited from javax.xml.registry.LifeCycleManager:
createAssociationcreateClassificationcreateClassificationcreateClassificationcreateClassificationSchemecreateClassificationSchemecreateClassificationSchemecreateConceptcreateConceptcreateEmailAddresscreateEmailAddresscreateExternalIdentifiercreateExternalIdentifiercreateExternalLinkcreateExternalLinkcreateExtrinsicObjectcreateInternationalStringcreateInternationalStringcreateInternationalStringcreateKeycreateLocalizedStringcreateLocalizedStringcreateObjectcreateOrganizationcreateOrganizationcreatePersonNamecreatePersonNamecreatePostalAddresscreateRegistryPackagecreateRegistryPackagecreateServicecreateServicecreateServiceBindingcreateSlotcreateSlotcreateSpecificationLinkcreateTelephoneNumbercreateUserdeleteObjectsdeleteObjectsdeprecateObjectsgetRegistryServicesaveObjectsunDeprecateObjects

Method Detail

confirmAssociationback to summary
public 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:Association

the Association object to be confirmed

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
InvalidRequestException:
if the User is not the owner of the sourceObject or the targetObject
deleteAssociationsback to summary
public BulkResponse deleteAssociations(Collection<E> 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:Collection<E>

the Collection of keys for the Association objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
deleteClassificationSchemesback to summary
public BulkResponse deleteClassificationSchemes(Collection<E> 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:Collection<E>

the Collection of keys for the ClassificationScheme objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
deleteConceptsback to summary
public BulkResponse deleteConcepts(Collection<E> 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:Collection<E>

the Collection of keys for the Concept objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
deleteOrganizationsback to summary
public BulkResponse deleteOrganizations(Collection<E> 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:Collection<E>

the Collection of keys for the Organization objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
deleteServiceBindingsback to summary
public BulkResponse deleteServiceBindings(Collection<E> 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:Collection<E>

the Collection of keys for the ServiceBinding objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
deleteServicesback to summary
public BulkResponse deleteServices(Collection<E> 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:Collection<E>

the Collection of keys for the Service objects to be deleted

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveAssociationsback to summary
public BulkResponse saveAssociations(Collection<E> 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:Collection<E>

the Collection of Association objects to be saved

replace:boolean

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:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveClassificationSchemesback to summary
public BulkResponse saveClassificationSchemes(Collection<E> 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:Collection<E>

the Collection of ClassificationScheme objects to be saved

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveConceptsback to summary
public BulkResponse saveConcepts(Collection<E> 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:Collection<E>

the Collection of Concept objects to be saved

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveOrganizationsback to summary
public BulkResponse saveOrganizations(Collection<E> 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:Collection<E>

the Collection of Organization objects to be saved

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveServiceBindingsback to summary
public BulkResponse saveServiceBindings(Collection<E> 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:Collection<E>

the Collection of ServiceBinding objects to be saved

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
saveServicesback to summary
public BulkResponse saveServices(Collection<E> 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:Collection<E>

the Collection of Service objects to be saved

Returns:BulkResponse

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

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
unConfirmAssociationback to summary
public 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:Association

the Association object to be unconfirmed

Exceptions
JAXRException:
if the JAXR provider encounters an internal error
InvalidRequestException:
if the User is not the owner of the sourceObject or the targetObject