Beispiel: Schnittstelle für generische Ereignisse

Diese Schnittstelle wird für die Verarbeitung generischer Prüfereignisse verwendet. Es können andere Schnittstellen definiert werden, die diese Schnittstelle erweitern, um bestimmte Gruppierungen von Prüfereignissen zu verarbeiten, wie z. B. Sicherheitsereignisse, Transaktionsereignisse oder andere angepasste Gruppierungen. In WebSphere Application Server Version 7.0 werden nur sicherheitsbezogene Ereignisse unterstützt.

Schnittstelle für generische Ereignisse

Es können bestimmte Implementierungen für die Bearbeitung der Daten in einem bestimmten internen Format entwickelt werden. Wenn die Methode "buildEvent()" aufgerufen wird, muss die Implementierung den angegebenen Basisereignistyp unter Verwendung der gespeicherten internen Informationen erstellen. Nachdem die Informationen in einer GenericEvent-Instanz gespeichert wurden, ist die GenericEvent-Schnittstelle eine generische Methode für die Behandlung des Ereignisses.

public interface GenericEvent {

 		/** * Eigenschaftsname, der verwendet wird, um den Basisereignistyp in der Methode
	* {@link GenericEvent#buildEvent} anzugeben.
	*/ 
public static final String BASE_EVENT_TYPE = GenericEvent.class.getName() + ".baseEventType"; 

/** 
* Gibt den eventType-Wert des Ereignisses zurück. Anhand des eventType-Werts können die zugehörigen
* Ereignisse unterschieden werden.
* Der eventType-Wert richtet sich nach der jeweiligen Implementierung
* von GenericEvent. Die Implementierung für Sicherheitsereignisse enthält
* beispielsweise eventTypes-Werte wie SECURITY_AUTHN und SECURITY_AUTHZ.
* @return eventType - Der eventType-Wert des Ereignisses.
*/ 

public String getEventType(); 
/** 
* Gibt den creationTime-Wert, die Erstellungszeit des Ereignisses,  zurück.
* @return creationTime - Die Erstellungszeit des Ereignisses.
*/ public Date getCreationTime(); /** * Gibt die Version des Ereignisses zurück.
* @return version - Die Version des Ereignisses.
*/ 

public String getVersion (Properties props) throws GenericEventConfigurationException; 
/** 
* Gibt den globalInstanceId-Wert zurück, d. h. eine global eindeutige Instanzkennung
* für das Ereignis.
* @return globalInstanceId - Eine global eindeutige Instanzkennung für das Ereignis.
*/

public Long getGlobalInstanceId(); 
/** 
* Prüft, ob das Ereignis gültig ist, was sich nach der jeweiligen Implementierung
* von GenericEvent richtet. Wenn das Ereignis nicht gültig ist, tritt ein Fehler
* vom Typ "GenericEventValidationException" auf.
*/

public void validate() throws GenericEventValidationException;
 /** 
* Gibt die intern eingeschlossene Basiseeignisinstanz zurück, nachdem
* die aktuelle Instanz von GenericEvent ausgeführt und validiert wurde.
* Eine GenericEvent-Implementierung kann ihre Informationen in jedem
* nicht veröffentlichten internen Format verwalten. Die Methode "buildEvent()",
* die angibt, dass ein bestimmter Basisereignistyp unter Verwendung der
* internen Informationen erstellt wird. Auf diese Weise können GenericEvent-Implementierungen
* mehrere Basisereignistypen unterstützen. Somit bietet die GenericEvent-Implementierung
* eine höhere Abstraktionsstufe als der Basisereignistyp.
* @param properties Der Wert der Eigenschaft BASE_EVENT_TYPE
* definiert den Typ des Basisereignisses.
* @return - Die intern eingeschlossene Basisereignisinstanz.
* @throws GenericEventConfigurationException - Ausnahme, die ausgelöst wird,
* wenn der Basisereignistyp ungültig ist oder die JAR-Dateien für die
* Unterstützung des Ereignistyps nicht verfügbar sind.
* @throws GenericEventCompletionException - Ausnahme, die ausgelöst wird, wenn
* die Ereignisausführung fehlschlägt.
* @throws GenericEventValidationException - Ausnahme, die ausgelöst wird, wenn die
* Validierung fehlschlägt, d. h. die Validierung, die von der Methode
* "validate()" vorgenommen wird.
*/

public Object buildEvent(Properties properties) 
				throws GenericEventConfigurationException, 
						GenericEventValidationException,
					  GenericEventCompletionException; 
/** 
* Gibt die eingeschlossene Basisereignisinstanz als Zeichenfolge zurück, nachdem
* die aktuelle Instanz von GenericEvent ausgeführt und validiert wurde.
* Eine GenericEvent-Implementierung kann ihre Informationen in jedem
* nicht veröffentlichten internen Format verwalten. Es handelt sich um
* die Methode "buildEventString()", die angibt, dass ein bestimmter
* Basisereignistyp unter Verwendung der internen Informationen erstellt
* wird. Auf diese Weise können GenericEvent-Implementierungen
* mehrere Basisereignistypen unterstützen. Somit bietet die GenericEvent-Implementierung
* eine höhere Abstraktionsstufe als der Basisereignistyp.
* @param properties Der Wert der Eigenschaft BASE_EVENT_TYPE
* definiert den Typ des Basisereignisses.
* @return - Die eingeschlossene Basisereignisinstanz als Zeichenfolge.
* @throws GenericEventConfigurationException - Ausnahme, die ausgelöst wird,
* wenn der Basisereignistyp ungültig ist oder die JAR-Dateien für die
* Unterstützung des Ereignistyps nicht verfügbar sind.
* @throws GenericEventCompletionException - Ausnahme, die ausgelöst wird, wenn
* die Ereignisausführung fehlschlägt.
* @throws GenericEventValidationException - Ausnahme, die ausgelöst wird, wenn die
* Validierung fehlschlägt, d. h. die Validierung, die von der Methode
* "validate()" vorgenommen wird.
*/ 

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

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rsec_sa_event_interface
Dateiname:rsec_sa_event_interface.html