Gli eventi creati possono essere aggiunti al catalogo eventi.
Perché e quando eseguire questa attività
Una volta che viene creata una nuova definizione di evento e viene completata con le
descrizioni proprietà e elementi dati estesi, è possibile aggiungerla al catalogo eventi. Dopo essere stata aggiunta al catalogo eventi, una definizione di evento non può essere modificata ma può essere sostituita.
Nota: se la sicurezza di WebSphere è abilitata, l'ID utente applicazione deve essere associato al ruolo catalogAdministrator per aggiungere le definizioni di evento al catalogo eventi.
Passi per questa attività
Per aggiungere una definizione di evento al catalogo eventi, utilizzare il metodo
addEventDefinition. boolean result = eventCatalog.addEventDefinition(definition, replace)
I parametri di questo metodo sono i seguenti:
- definition
- La definizione di evento che si desidera aggiungere. Deve essere un'istanza valida di EventDefinition.
- replace
- Un valore booleano che indica se la definizione di evento specificata sostituisce una definizione
esistente che ha lo stesso nome.
Se il parametro replace è false,
il nome della definizione di evento specificata non deve corrispondere al nome di una definizione di evento esistente nel catalogo. Se invece corrisponde ad un nome esistente, viene generata un'eccezione EventDefinitionExistsException.
Se, invece, il parametro replace è true, la nuova
definizione di evento sostituisce qualsiasi definizione di evento esistente con lo stesso nome che si
trova già nel catalogo. Tuttavia, per mantenere la gerarchia di eredità, la nuova definizione di evento deve denominare lo stesso parent della definizione di evento precedente; altrimenti, verrà generata un'eccezione ParentNotValidException.
Risultato
Il valore booleano restituito indica se è stata sostituita una definizione di evento
esistente. Questo valore è true solo se replace è true
e se una definizione di evento con lo stesso nome è stata sostituita da una nuova definizione.
Quando si aggiunge una nuova definizione di evento al catalogo eventi, quest'ultimo invia un evento
al server degli eventi notificando agli event consumer che si è verificata questa modifica. Vedere
Notifica di modifica.
Nota: se
si tenta di aggiungere una definizione di evento che viola le regole di eredità, viene generata
un'eccezione InheritanceNotValidException e la definizione di evento non viene aggiunta al
catalogo. Ciò può verificarsi se una nuova definizione di evento ignora le descrizioni elementi dati
estesi o proprietà ereditate in modo non valido, o se la sostituzione di una definizione di evento
esistente fa sì che i discendenti ignorino le descrizioni ereditate in modo non valido.Per ulteriori informazioni, vedere
Eredità del catalogo eventi.