Una descripción de elemento de datos ampliados es una
instancia de la clase
ExtendedDataElementDescription.ibm.events.catalog.PropertyDescription.
Por qué y cuándo realizar esta tarea
Para añadir una descripción de elemento de datos ampliados a una
definición de suceso, primero debe crear una nueva descripción de elemento de datos
ampliados y, a continuación, establecer los valores de sus campos.
Asimismo, puede añadir descripciones de elementos de datos ampliados
anidados (hijos), que describen los elementos de datos ampliados anidados.
A continuación, puede añadir la descripción de elemento de datos
ampliados a la definición de suceso.
Pasos para realizar esta tarea
- Para crear una nueva descripción de un elemento de datos ampliados,
cree una instancia de ExtendedDataElementDescription, especificando el nombre
y el tipo del elemento de datos ampliados.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription(nombre, tipo);
Los parámetros de este constructor son los siguientes:- nombre
- Nombre del elemento de datos ampliados. Debe ser el valor de la
propiedad name del elemento de datos ampliados que desea describir.
- tipo
- Tipo de datos del elemento de datos ampliados. Este debe ser
constante de tipo entero, una de las siguientes constantes que se definen en la clase
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
El objeto devuelto es un objeto
ExtendedDataElementDescription nuevo.
- Rellene los campos de la descripción de elemento de datos. La clase ExtendedDataElementDescription proporciona un método setter
para cada uno de los campos de la descripción de elemento de datos
ampliados. Consulte la documentación de la API Javadoc para obtener toda la información sobre estos métodos. Por ejemplo, para especificar que un elemento de datos ampliados
debe ocurrir una vez como mínimo, establecería la propiedad maxOccurs
en 4 mediante el método setMaxOccurs(int):
edeDesc.setMaxOccurs(4);
- Opcional: Para añadir una descripción de elementos
de datos ampliados hijo, utilice el método ExtendedDataElementDescription.addChild().
edeDesc.addChild(childEdeDesc);
El parámetro
childEdeDesc debe ser una descripción de elementos de datos ampliados.
- Añada la descripción de elemento de datos ampliados a la
definición de suceso mediante el método EventDefinition.addExtendedDataElementDescription().
definition.addExtendedDataElementDescription(edeDesc);
Si la definición de suceso ya incluye otra descripción de elementos de
datos ampliados con los mismos nombre y vía de acceso, se genera una
excepción DescriptionExistsException.
El siguiente fragmento de código crea una nueva descripción de
elementos de datos ampliados, la rellena con datos y la añade a una
definición de suceso.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription("age", TYPE_SHORT_VALUE);
edeDesc.setMinOccurs(1);
edeDesc.setMaxOccurs(1);
// la definición es una definición de suceso válida
definition.addExtendedDataElementDescription(edeDesc);