例: 汎用イベント・インターフェース

このインターフェースは、汎用監査イベントの処理に使用されます。このインターフェースを拡張して、 特定の監査イベントのグループ (セキュリティー・イベント・グループ、トランザクション・イベント・グループ、 またはその他のカスタム・グループなど) を処理する、他のインターフェースを定義することができます。 WebSphere® Application Server バージョン 7.0 では、セキュリティー・イベント・タイプのみサポートされます。

汎用イベント・インターフェース

特定の内部フォーマットを持つデータを処理するための、特定の実装を作成できます。 buildEvent() メソッドが呼び出されると、実装では、保管した内部情報を使用して特定の基本イベント・タイプが作成されます。 この情報が GenericEvent インスタンスに保管されると、GenericEvent インターフェースはイベントを処理するための汎用的な方法を提供します。

public interface GenericEvent {

 		/** * Property name used to specify the base event type to the 
		* {@link GenericEvent#buildEvent} method. 
	*/ 
public static final String BASE_EVENT_TYPE = GenericEvent.class.getName() + ".baseEventType"; 

/** 
* Returns the eventType of the event. The eventType distinguishes between these 
* related events. 
* The eventType depends on the particular implementation 
* of the GenericEvent. For example, the Security Event implmentation has 
* eventTypes such as SECURITY_AUTHN and SECURITY_AUTHZ. 
* @return eventType - the eventType of the event 
*/ 

public String getEventType(); 
/** 
* Returns the creationTime, the creation time of the event. 
* @return creationTime - the creation time of the event 
*/ public Date getCreationTime(); /** * Returns the version, the version of the event. 
* @return version - the version of the event 
*/ 

public String getVersion (Properties props) throws GenericEventConfigurationException; 
/** 
* Returns the globalInstanceId, which is a globally unique instance 
* identifier for the event. 
* @return globalInstanceId - a globally unique instance identifier for the event 
*/

public Long getGlobalInstanceId(); 
/** 
* Verifies whether the event is valid; which depends on the particular 
* implementation of the GenericEvent. If the event is not valid, an 
* GenericEventValidationException error occurs. 
*/

public void validate() throws GenericEventValidationException;
 /** 
* Returns the internally wrapped base event instance after 
* completing and validating the current instance of the GenericEvent. 
* An GenericEvent implementation can maintain its information 
* in any undisclosed internal format. The buildEvent() 
* method that specifies that a specific base event type be built 
* using the internal information. This allows GenericEvent implementations 
* to support multiple base event formats. Thus the GenericEvent implmentation 
* provides a layer of abstraction higher than the base event type. 
* @param properties The value of the property BASE_EVENT_TYPE 
* defines the type of the base event * @return the internally wrapped base event instance 
* @throws GenericEventConfigurationException if the base event type is invalid 
* or the JAR files to support that event type are not available. 
* @throws GenericEventCompletionException if event completion has failed. 
* @throws GenericEventValidationException if the validation has failed. This is 
* validation as is performed by the validate() method. 
*/

public Object buildEvent(Properties properties) 
				throws GenericEventConfigurationException, 
						GenericEventValidationException,
					  GenericEventCompletionException; 
/** 
* Returns the wrapped base event instance as a string after 
* completing and validating the current instance of the GenericEvent. 
* An GenericEvent implementation can maintain its information 
* in any undisclosed internal format. It is the buildEventString() 
* method that specifies that a specific base event type be built 
* using the internal information. This allows GenericEvent implementations 
* to support multiple base event formats. Thus the GenericEvent implmentation
* provides a layer of abstraction higher than the base event type. 
* @param properties The value of the property BASE_EVENT_TYPE 
* defines the type of the base event 
* @return the wrapped base event instance as a String 
* @throws GenericEventConfigurationException if the base event type is invalid 
* or the JAR files to support that event type are not available. 
* @throws GenericEventCompletionException if event completion has failed. 
* @throws GenericEventValidationException if the validation has failed. This is 
* validation as is performed by the validate() method. 
*/ 

public String buildEventString(Properties properties) 
				throws GenericEventConfigurationException, 
						GenericEventValidationException, 
						GenericEventCompletionException; 
}

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rsec_sa_event_interface
ファイル名:rsec_sa_event_interface.html