LifeCycleManager

   
LifeCycleManager javax.xml.registry

JAXR 1.0; JWSDP 1.0, J2EE 1.4
 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 RegistryObject s 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 RegistryObject s 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 DeleteException s 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.

Implementations

BusinessLifeCycleManager

Returned By

javax.xml.registry.infomodel.RegistryObject.getLifeCycleManager( )


   


Java Web Services in a Nutshell
Java Web Services in a Nutshell
ISBN: 0596003994
EAN: 2147483647
Year: 2003
Pages: 257
Authors: Kim Topley

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net