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

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


  Previous section   Next section