Ejemplo: Interfaz de suceso genérico

Esta interfaz se utiliza para procesar sucesos de auditoría genéricos. Pueden definirse otras interfaces que amplíen esta interfaz para procesar grupos de sucesos de auditoría específicos, como sucesos de seguridad, sucesos de transacción y otros grupos personalizados. En WebSphere Application Server versión 7.0, solo se soportan sucesos de tipos de seguridad.

Interfaz de suceso genérico

Se pueden desarrollar implementaciones específicas para manejar los datos en un formato interno particular. Cuando se llama al método buildEvent(), la implementación debe construir el tipo de suceso base especificado utilizando la información interna que tiene almacenada. Una vez se ha almacenado la información en una instancia de GenericEvent, la interfaz GenericEvent proporciona un medio genérico para manejar el suceso.

public interface GenericEvent {

 		/** * Nombre de propiedad utilizado para especificar el tipo de suceso base al 
		* método {@link GenericEvent#buildEvent}. 
	*/ 
public static final String BASE_EVENT_TYPE = GenericEvent.class.getName() + ".baseEventType"; 

/** 
* Devuelve el eventType del suceso. El eventType distingue entre estos 
* sucesos relacionados. 
* El eventType depende de la implementación concreta 
* de GenericEvent. Por ejemplo, la implementación de suceso de seguridad tiene 
* eventTypes como SECURITY_AUTHN y SECURITY_AUTHZ. 
* @return eventType - eventType del suceso 
*/ 

public String getEventType(); 
/** 
* Devuelve creationTime, la hora de creación del suceso. 
* @return creationTime - hora de creación del suceso 
*/ public Date getCreationTime(); /** * Devuelve la versión del suceso. 
* @return version - versión del suceso 
*/ 

public String getVersion (Properties props) throws GenericEventConfigurationException; 
/** 
* Devuelve globalInstanceId, que es un identificador de instancia exclusivo 
* globalmente para el suceso. 
* @return globalInstanceId - identificador de instancia exclusivo globalmente del suceso 
*/

public Long getGlobalInstanceId(); 
/** 
* Verifica si el suceso es válido; lo que depende de la implementación 
* concreta de GenericEvent. Si el suceso no es válido, se produce 
* un error GenericEventValidationException. 
*/

public void validate() throws GenericEventValidationException;
 /** 
* Devuelve la instancia de suceso base internamente envuelta después de 
* completar y validar la instancia actual de GenericEvent. 
* Una implementación de GenericEvent puede mantener su información 
* en cualquier formato interno cerrado. El método buildEvent() 
* que especifica que se construya un tipo de suceso base específico 
* utilizando la información interna. Esto permite que las implementaciones de GenericEvent 
* puedan soportar múltiples formatos de sucesos base. Así, la implementación de GenericEvent 
* proporciona una capa de abstracción superior a la del tipo de suceso base. 
* @param properties El valor de la propiedad BASE_EVENT_TYPE 
* define el tipo del suceso base
* @return la instancia de suceso base envuelta internamente 
* @throws GenericEventConfigurationException si el tipo de suceso base no es válido 
* o los archivos JAR que deben soportar el tipo de suceso no están disponibles. 
* @throws GenericEventCompletionException si la finalización del suceso ha fallado. 
* @throws GenericEventValidationException si la validación ha fallado. Se trata de la 
* validación tal como la realiza el método validate(). 
*/

public Object buildEvent(Properties properties) 
				throws GenericEventConfigurationException, 
						GenericEventValidationException,
					  GenericEventCompletionException; 
/** 
* Devuelve la instancia de suceso base envuelta como una serie después de 
* completar y validar la instancia actual de GenericEvent. 
* Una implementación de GenericEvent puede mantener su información 
* en cualquier formato interno cerrado. Es el método buildEventString() 
* que especifica que se construya un tipo de suceso base específico 
* utilizando la información interna. Esto permite que las implementaciones de GenericEvent 
* puedan soportar múltiples formatos de sucesos base. Así, la implementación de GenericEvent
* proporciona una capa de abstracción superior a la del tipo de suceso base. 
* @param properties El valor de la propiedad BASE_EVENT_TYPE 
* define el tipo del suceso base 
* @return la instancia de suceso base envuelta como String 
* @throws GenericEventConfigurationException si el tipo de suceso base no es válido 
* o los archivos JAR que deben soportar el tipo de suceso no están disponibles. 
* @throws GenericEventCompletionException si la finalización del suceso ha fallado. 
* @throws GenericEventValidationException si la validación ha fallado. Se trata de la 
* validación tal como la realiza el método validate(). 
*/ 

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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rsec_sa_event_interface
File name: rsec_sa_event_interface.html