|
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