AuditableEvent (Java EE 5)

Java EE API


javax.xml.registry.infomodel Interface AuditableEvent

All Superinterfaces:
ExtensibleObject, RegistryObject

public interface AuditableEvent
extends RegistryObject

Implements: RegistryObject

AuditableEvent 实例对影响 RegistryObject 状态更改的事件进行长期记录。此类事件通常是客户端发起请求的结果。AuditableEvent 实例由注册表服务生成,用于记录此类事件。

此类事件常常影响 RegistryObject 生命周期中的更改。例如,客户端请求可以对 RegistryObject 执行 Create、Update、Deprecate 或 Delete 操作。对于不改变 RegistryObject 状态的请求,不会创建任何 AuditableEvent。具体来说,只读请求不会生成 AuditableEvent。在将 RegistryObject 归类、分配到某个 Package、与另一个 Object 关联时,不会为此生成任何 AuditableEvent。

RegistryObject 将与某个有序的 AuditableEvent 实例 Collection 关联,这些实例提供了该 Object 完整的审计轨迹。

英文文档:

AuditableEvent instances provide a long term record of events that effect a change of state in a RegistryObject. Such events are usually a result of a client initiated request. AuditableEvent instances are generated by the registry service to log such events.

Often such events effect a change in the life cycle of a RegistryObject. For example a client request could Create, Update, Deprecate or Delete a RegistryObject. No AuditableEvent is created for requests that do not alter the state of a RegistryObject. Specifically, read-only requests do not generate an AuditableEvent. No AuditableEvent is generated for a RegistryObject when it is classified, assigned to a Package or associated with another Object.

A RegistryObject is associated with an ordered Collection of AuditableEvent instances that provide a complete audit trail for that Object.

Author:
Farrukh S. Najmi
See Also:
RegistryObject

Field Summary
static int
static int
static int
static int
static int
static int
 
Method Summary
 int
 RegistryObject
 Timestamp
 User
 
Methods inherited from interface javax.xml.registry.infomodel.RegistryObject
 
Methods inherited from interface javax.xml.registry.infomodel.ExtensibleObject
 

Field Detail

英文文档:

EVENT_TYPE_CREATED

static final int EVENT_TYPE_CREATED
An event where a RegistryObject is created.

See Also:
Constant Field Values


英文文档:

EVENT_TYPE_DELETED

static final int EVENT_TYPE_DELETED
An event where a RegistryObject is deleted.

See Also:
Constant Field Values


英文文档:

EVENT_TYPE_DEPRECATED

static final int EVENT_TYPE_DEPRECATED
An event where a RegistryObject is deprecated.

See Also:
Constant Field Values


英文文档:

EVENT_TYPE_UPDATED

static final int EVENT_TYPE_UPDATED
An event where a RegistryObject is updated.

See Also:
Constant Field Values


英文文档:

EVENT_TYPE_VERSIONED

static final int EVENT_TYPE_VERSIONED
An event where a RegistryObject is versioned.

See Also:
Constant Field Values


英文文档:

EVENT_TYPE_UNDEPRECATED

static final int EVENT_TYPE_UNDEPRECATED
An event where a RegistryObject is undeprecated.

See Also:
Constant Field Values

Method Detail

public User getUser() throws JAXRException
获得与此对象关联的 User。

功能级别:1
return 发送请求生成此 AuditableEvent 的 User。不得为 null
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
label
requestor
supplierCardinality1
directed
associates <{User}>
英文文档:

getUser

User getUser()
             throws JAXRException
Gets the User associated with this object.

Capability Level: 1

Returns:
the User that sent the request that generated this this AuditableEvent. Must not be null
Throws:
JAXRException - If the JAXR provider encounters an internal error

public java.sql.Timestamp getTimestamp() throws JAXRException
获取表示此事件发生时间的 Timestamp。

功能级别:1
return 记录事件发生时间的时间戳
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

getTimestamp

Timestamp getTimestamp()
                       throws JAXRException
Gets the Timestamp for when this event occurred.

Capability Level: 1

Returns:
the timestamp that records the time the event occured
Throws:
JAXRException - If the JAXR provider encounters an internal error

public int getEventType() throws JAXRException
获取此事件的类型。

功能级别:1
return 此事件的类型
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
See also EVENT_TYPE_CREATED
英文文档:

getEventType

int getEventType()
                 throws JAXRException
Gets the type of this event.

Capability Level: 1

Returns:
the type of this event
Throws:
JAXRException - If the JAXR provider encounters an internal error
See Also:
EVENT_TYPE_CREATED

public RegistryObject getRegistryObject() throws JAXRException
获取与此 AuditableEvent 关联的 RegistryObject。

功能级别:1
return 作为此事件焦点的 RegistryObject
ThrowsJAXRException: 如果 JAXR 提供者遇到内部错误
英文文档:

getRegistryObject

RegistryObject getRegistryObject()
                                 throws JAXRException
Gets the RegistryObject associated with this AuditableEvent.

Capability Level: 1

Returns:
the RegistryObject that was the focus of this event
Throws:
JAXRException - If the JAXR provider encounters an internal error


Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!