Una descrizione elementi dati estesi è un'istanza della classe ExtendedDataElementDescription.
Perché e quando eseguire questa attività
Per aggiungere una descrizione elementi dati estesi a una
definizione di evento, è necessario creare prima una descrizione elementi dati estesi e impostare quindi i
valori dei relativi campi. È, inoltre, possibile aggiungere le descrizioni elementi dati estesi
nidificati (child), che descrivono tali elementi. È, quindi, possibile aggiungere la descrizione
elementi dati estesi alla definizione di evento.
Passi per questa attività
- Per creare una nuova descrizione elementi dati estesi, creare un'istanza di ExtendedDataElementDescription, specificando il nome ed il tipo dell'elemento dati estesi.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription(name, type);
I parametri di questo
costruttore sono i seguenti:- name
- Il nome dell'elemento dati estesi. Deve essere il valore della proprietà name dell'elemento dati estesi che si desidera descrivere.
- type
- Il tipo di dati dell'elemento dati estesi. Deve essere una delle seguenti costanti intere
definite dalla classe org.eclipse.hyades.logging.events.cbe.ExtendedDataElement:
- TYPE_BOOLEAN_ARRAY_VALUE
- TYPE_BOOLEAN_VALUE
- TYPE_BYTE_ARRAY_VALUE
- TYPE_BYTE_ARRAY
- TYPE_DATE_TIME_ARRAY_VALUE
- TYPE_DATE_TIME_VALUE
- TYPE_DOUBLE_ARRAY_VALUE
- TYPE_DOUBLE_VALUE
- TYPE_FLOAT_ARRAY_VALUE
- TYPE_FLOAT_VALUE
- TYPE_HEX_BINARY_VALUE
- TYPE_INT_ARRAY_VALUE
- TYPE_INT_VALUE
- TYPE_LONG_ARRAY_VALUE
- TYPE_LONG_VALUE
- TYPE_NO_VALUE_VALUE
- TYPE_SHORT_ARRAY_VALUE
- TYPE_SHORT_VALUE
- TYPE_STRING_ARRAY_VALUE
- TYPE_STRING_VALUE
L'oggetto restituito è un nuovo oggetto ExtendedDataElementDescription.
- Completare i campi della descrizione elementi dati estesi. La classe ExtendedDataElementDescription fornisce un metodo setter per ciascuno dei campi
contenuti in una descrizione elementi dati estesi. Fare riferimento alla documentazione API Javadoc per le informazioni complete su questi metodi. Ad esempio, per specificare che un elemento dati estesi deve verificarsi almeno una volta, si imposta la proprietà maxOccurs su 4 utilizzando il metodo setMaxOccurs(int):
edeDesc.setMaxOccurs(4);
- Opzionale: per aggiungere una descrizione elementi dati estesi, utilizzare il
metodo ExtendedDataElementDescription.addChild().
edeDesc.addChild(childEdeDesc);
Il parametro childEdeDesc deve essere una descrizione elementi dati estesi valida.
- Aggiungere la descrizione elementi dati estesi alla definizione di evento utilizzando il
metodo EventDefinition.addExtendedDataElementDescription().
definition.addExtendedDataElementDescription(edeDesc);
Se la
definizione di evento comprende già un'altra descrizione elementi dati estesi con lo stesso nome e
percorso, viene generata un'eccezione DescriptionExistsException.
Esempio
Il seguente frammento di codice crea una nuova descrizione elementi dati estesi, la completa
con i dati e l'aggiunge a una definizione di evento.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription("age", TYPE_SHORT_VALUE);
edeDesc.setMinOccurs(1);
edeDesc.setMaxOccurs(1);
// la definizione è una definizione di evento valida
definition.addExtendedDataElementDescription(edeDesc);