Previous section   Next section
RegistryEntry javax.xml.registry.infomodel

JAXR 1.0; JWSDP 1.0, J2EE 1.4
public interface RegistryEntry extends RegistryObject, Versionable {
// Public Constants
    public static final int STABILITY_DYNAMIC;
               //=0
    public static final int STABILITY_DYNAMIC_COMPATIBLE;
               //=1
    public static final int STABILITY_STATIC;
               //=2
    public static final int STATUS_APPROVED;
               //=1
    public static final int STATUS_DEPRECATED;
               //=2
    public static final int STATUS_SUBMITTED;
               //=0
    public static final int STATUS_WITHDRAWN;
               //=3
// Public Instance Methods
    public abstract java.util.Date getExpiration(  )
       throws javax.xml.registry.JAXRException;             //L1
    public abstract int getStability(  )
       throws javax.xml.registry.JAXRException;             //L1
    public abstract int getStatus(  )
       throws javax.xml.registry.JAXRException;             //L1
    public abstract void setExpiration(java.util.Date expiration)
       throws javax.xml.registry.JAXRException;             //L1
    public abstract void setStability(int stability)
       throws javax.xml.registry.JAXRException;             //L1
}

RegistryEntry is an interface that acts as a base for objects within the registry that require metadata beyond that provided by RegistryObject, of which it is an extension. The following additional attributes are provided:

Versioning

ExtensibleObject implements the Versionable interface, which allows a RegistryEntry to have major, minor, and user version numbers. See the description of the Versionable interface later in this chapter for further details.

Stability

The getStability( ) and setStability( ) methods manipulate a value that indicates whether the registry object is permitted to change. If this attribute has the value STABILITY_STATIC, no changes can occur. The value STABILITY_DYNAMIC means that a change of any type may occur, whereas STABILITY_DYNAMIC_COMPATIBLE means that changes can be made, but will be backward-compatible with previous versions of the object. The validity of the stability attribute may be bounded by an expiration date, available from the getExpiration( ) method. If this is not null, then the object is free to change arbitrarily after the returned Date.

Status

The getStatus( ) and setStatus( ) methods retrieve and set the attribute that gives the state of the object within its overall lifecycle. There are several defined values for this attribute, although it is only possible for clients using the JAXR API to move an object to STATE_SUBMITTED or STATE_DEPRECATED. The other values might still be seen, however, since they could be set as a result of administrative action by the registry operator or by a client using a more capable API.

Although there are objects derived from RegistryEntry in the registry API that are available to clients of both level 0 and level 1 providers, the attributes themselves are supported only in level 1 registries and therefore are not available to level 0 clients.

Implementations

ClassificationScheme, ExtrinsicObject, RegistryPackage, javax.xml.registry.infomodel.Service


  Previous section   Next section