public interface AuditableEvent extends RegistryObject {
// Public Constants
public static final int EVENT_TYPE_CREATED;
//=0
public static final int EVENT_TYPE_DELETED;
//=1
public static final int EVENT_TYPE_DEPRECATED;
//=2
public static final int EVENT_TYPE_UNDEPRECATED;
//=5
public static final int EVENT_TYPE_UPDATED;
//=3
public static final int EVENT_TYPE_VERSIONED;
//=4
// Public Instance Methods
public abstract int getEventType( ) throws javax.xml.registry.JAXRException; //L1
public abstract RegistryObject getRegistryObject(
) throws javax.xml.registry.JAXRException;
public abstract java.sql.Timestamp getTimestamp( ) throws javax.xml.registry.JAXRException; //L1
public abstract User getUser( ) throws javax.xml.registry.JAXRException; //L1
}
Level 1 registries support the use of an audit trail that records
changes made to objects in the registry. Each
RegistryObject has its own audit trail that is
composed of AuditableEvents. To retrieve the audit
trail for a particular RegistryObject, use the
getAuditTrail( ) method. The audit trail is
managed by the registry itself; therefore, there is no API that
allows client programs to explicitly create or remove entries.
The getEventType( ) method returns a value that
indicates the type of event that the
AuditableEvent represents. The JAXR API provides
for auditing of object creation, deletion, deprecation,
undeprecation, versioning, and updates. The
getRegistryObject( ) method returns a reference to
the object that the event relates to, while the
getTimestamp( ) method gets the time at which the
event occurred, in the form of a
java.sql.Timestamp object. The getUser(
) method returns the User object for the
user that causes the event to be generated. Since registry updates
require authentication, it is always possible to record the identity
of any user that causes a registry object to be modified.