Exemple : Interface Base Generic Emitter
L'interface Base Generic Emitter définit le mode d'émission des événements d'audit. D'autres interfaces permettent d'étendre cette interface et traiter des regroupements d'événements d'audit spécifiques, tels que des événements de sécurité, de transaction ou autres regroupements personnalisés. Cette interface permet de créer une implémentation personnalisée de l'émetteur.
Interface Base Generic Emitter
/**
* Cette interface est dédiée à l'émetteur d'événements. Les sources d'événement utilisent
* cette interface pour envoyer des événements à un service d'événements.
*
*/
public interface BaseGenericEmitter {
/**
* Envoie un événement à l'implémentation GenericEmitter configurée.
*
* @param event Evénement à envoyer au service d'événements.
* Cette valeur ne peut pas être NULL.
* @return ID d'instance global de l'événement qui a été créé.
* @exception GenericEmitterException Si une erreur se produit pendant le traitement de l'émetteur.
* @exception IllegalArgumentException Si le paramètre d'événement a une valeur NULL.
*/
public String sendEvent(GenericEvent event) throws
GenericEventException;
/** * Envoie un tableau d'événements à l'implémentation GenericEmitter configurée.
* @param events Tableau d'événements à envoyer au service d'événements.
* Cette valeur ne peut pas être NULL.
* @return ID d'instance global des événements qui a été créés.
* @exception GenericEmitterException Si une erreur se produit pendant le traitement de l'émetteur.
* @exception IllegalArgumentException Si le paramètre d'événement a une valeur NULL.
*/
public String[] sendEvents(GenericEvent events[]) throws
GenericEventException;
/**
* Amène l'émetteur à libérer toutes les ressources appartenant à cet
* objet et ses objets dépendants.
* Les appels ultérieurs de cette méthode sont sans effet.
*
* @throws GenericEmitterException Si l'émetteur ne libère pas les
* ressources suspendues.
*
* @throws GenericEventException Si toute autre erreur s'est produite pendant la publication des ressources.
*/
public void close() throws
GenericEventException;
}