public interface LifeCycleManager {
// Public Constants
public static final String ASSOCIATION;
// ="Association"
public static final String AUDITABLE_EVENT;
// ="AuditableEvent"
public static final String CLASSIFICATION;
// ="Classification"
public static final String CLASSIFICATION_SCHEME;
// ="ClassificationScheme"
public static final String CONCEPT;
// ="Concept"
public static final String EMAIL_ADDRESS;
// ="EmailAddress"
public static final String EXTERNAL_IDENTIFIER;
// ="ExternalIdentifier"
public static final String EXTERNAL_LINK;
// ="ExternalLink"
public static final String EXTRINSIC_OBJECT;
// ="ExtrinsicObject"
public static final String INTERNATIONAL_STRING;
// ="InternationalString"
public static final String KEY;
// ="Key"
public static final String LOCALIZED_STRING;
// ="LocalizedString"
public static final String ORGANIZATION;
// ="Organization"
public static final String PERSON_NAME;
// ="PersonName"
public static final String POSTAL_ADDRESS;
// ="PostalAddress"
public static final String REGISTRY_ENTRY;
// ="RegistryEntry"
public static final String REGISTRY_PACKAGE;
// ="RegistryPackage"
public static final String SERVICE;
// ="Service"
public static final String SERVICE_BINDING;
// ="ServiceBinding"
public static final String SLOT;
// ="Slot"
public static final String SPECIFICATION_LINK;
// ="SpecificationLink"
public static final String TELEPHONE_NUMBER;
// ="TelephoneNumber"
public static final String USER;
// ="User"
public static final String VERSIONABLE;
// ="Versionable"
// Public Instance Methods
public abstract javax.xml.registry.infomodel.Association createAssociation
(javax.xml.registry.infomodel.RegistryObject targetObject,
javax.xml.registry.infomodel.Concept associationType)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Classification createClassification
(javax.xml.registry.infomodel.Concept concept)
throws JAXRExceptionInvalidRequestException; // L0
public abstract javax.xml.registry.infomodel.Classification createClassification
(javax.xml.registry.infomodel.ClassificationScheme scheme,
javax.xml.registry.infomodel.InternationalString name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Classification createClassification
(javax.xml.registry.infomodel.ClassificationScheme scheme,
String name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ClassificationScheme createClassificationScheme
(javax.xml.registry.infomodel.Concept concept)
throws JAXRExceptionInvalidRequestException; // L0
public abstract javax.xml.registry.infomodel.ClassificationScheme createClassificationScheme
(javax.xml.registry.infomodel.InternationalString name,
javax.xml.registry.infomodel.InternationalString description)
throws JAXRExceptionInvalidRequestException; // L0
public abstract javax.xml.registry.infomodel.ClassificationScheme createClassificationScheme
(String name, String description)
throws JAXRExceptionInvalidRequestException; // L0
public abstract javax.xml.registry.infomodel.Concept createConcept
(javax.xml.registry.infomodel.RegistryObject parent,
String name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Concept createConcept
(javax.xml.registry.infomodel.RegistryObject parent,
javax.xml.registry.infomodel.InternationalString name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.EmailAddress createEmailAddress
(String address)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.EmailAddress createEmailAddress
(String address, String type)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ExternalIdentifier createExternalIdentifier
(javax.xml.registry.infomodel.ClassificationScheme identificationScheme,
javax.xml.registry.infomodel. InternationalString name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ExternalIdentifier createExternalIdentifier
(javax.xml.registry.infomodel.ClassificationScheme identificationScheme,
String name, String value)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ExternalLink createExternalLink(String externalURI,
javax.xml.registry.infomodel.InternationalString description)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ExternalLink createExternalLink(String externalURI,
String description)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ExtrinsicObject createExtrinsicObject
(javax.activation.DataHandler repositoryItem)
throws JAXRException; // L1
public abstract javax.xml.registry.infomodel.InternationalString createInternationalString( )
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.InternationalString createInternationalString(String s)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.InternationalString createInternationalString
(Locale l, String s)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Key createKey(String id)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.LocalizedString createLocalizedString
(Locale l, String s)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.LocalizedString createLocalizedString
(Locale l, String s, String charSetName)
throws JAXRException; // L0
public abstract Object createObject(String interfaceName)
throws JAXRExceptionInvalidRequestExceptionUnsupportedCapabilityException; // L0
public abstract javax.xml.registry.infomodel.Organization createOrganization
(javax.xml.registry.infomodel.InternationalString name)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Organization createOrganization(String name)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.PersonName createPersonName(String fullName)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.PersonName createPersonName
(String firstName, String middleName,
String lastName) throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.PostalAddress createPostalAddress(String streetNumber,
String street,
String city,String stateOrProvince,
String country, String postalCode,
String type) throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.RegistryPackage createRegistryPackage
(javax.xml.registry.infomodel.InternationalString name)
throws JAXRException; // L1
public abstract javax.xml.registry.infomodel.RegistryPackage createRegistryPackage
(String name)
throws JAXRException; // L1
public abstract javax.xml.registry.infomodel.Service createService (javax.xml.registry.infomodel.InternationalString name)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Service createService(String name)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.ServiceBinding createServiceBinding( )
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Slot createSlot
(String name,
Collection values, String slotType)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.Slot createSlot
(String name, String value,
String slotType)
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.SpecificationLink createSpecificationLink( )
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.TelephoneNumber createTelephoneNumber( )
throws JAXRException; // L0
public abstract javax.xml.registry.infomodel.User createUser( )
throws JAXRException; // L0
public abstract BulkResponse deleteObjects(Collection keys)
throws JAXRException; // L1
public abstract BulkResponse deleteObjects(Collection keys, String objectType)
throws JAXRException; // L0
public abstract BulkResponse deprecateObjects(Collection keys)
throws JAXRException; // L1
public abstract RegistryService getRegistryService( )
throws JAXRException; // L0
public abstract BulkResponse saveObjects(Collection objects)
throws JAXRException; // L0
public abstract BulkResponse unDeprecateObjects(Collection keys)
throws JAXRException; // L1
}
The LifeCycleManager interface provides the
methods necessary to create, update, remove, and deprecate objects in
the registry. JAXR clients that make use of these methods usually
need to authenticate to the registry by supplying valid credentials
using the setCredentials( ) method of
ConnectionFactory, and may be required to use a
secure transport, such as HTTPS.
The createXXX( ) methods allow you to create an
in-memory representation of a new object of a given type. In order to
build a set of related registry objects, you would use the
appropriate factory methods to create the objects and then link them
together using the methods that they provide for this purpose. None
of these operations affect the registry until the
saveObjects( ) method is called. This method
requires a Collection of
RegistryObjects that are to be saved. For each
object in this collection, a new registry entry is created if it did
not already exist, or an existing entry is updated to reflect the
state of the object supplied in the collection. In cases in which one
object points to another (such as an Organization
referring to a Service), the process of saving the
first object also creates or updates all of its dependents. The
BulkResponse returned by the saveObjects(
) method contains the keys for the objects that were saved.
Note that the RegistryObjects themselves are not
automatically updated with these keys. If an error occurs while
saving an object, a SaveException is included in
the BulkResponse to indicate the error. The
BusinessLifeCycleManager interface provides
additional methods that let you save objects by type.
The deleteObjects( ) method requires a
Collection containing the keys of registry objects
to be deleted. The BulkResponse returned from this
method contains the keys of those objects that were deleted and
possibly DeleteExceptions indicating deletion
failures. The BusinessLifeCycleManager interface
provides additional methods that let you delete objects by type.
The level 1 deprecateObjects( ) and
undeprecateObjects( ) methods allow a registry
client to change the deprecation status of one or more registry
objects given by their keys. An object that is deprecated may still
be used and referred to by other registry objects, but the creation
of new links to them from other objects in the registry results in a
JAXRException with a
java.lang.IllegalStateException as its root cause.
The LifeCycleManager interface also defines
constants that represent each of the types of registry object defined
in the javax.xml.registry.infomodel package. These
constants are required as arguments to some method calls, such as the
getRegistryObject( ) and
getRegistryObjects( ) methods in the
QueryManager interface.
