Una descripción de elemento de datos ampliados es una instancia de la
clase ExtendedDataElementDescription.
Por qué y cuándo se efectúa 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. También puede
añadir descripciones de elementos de datos ampliados anidados (hijos), que describen
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 elemento de datos ampliados, cree una
instancia de ExtendedDataElementDescription y especifique 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
- El nombre del elemento de datos ampliados. Debe ser el valor de la propiedad
name del elemento de datos ampliados que desea describir.
- tipo
- El tipo de datos del elemento de datos ampliados. Debe ser uno de los siguientes
valores enteros constantes definidos por 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 nuevo objeto
ExtendedDataElementDescription.
- Llene los campos de la descripción del elemento de datos ampliados. La clase ExtendedDataElementDescription proporciona un método setter para cada uno de los campos en una descripción de elemento de datos
ampliados. Consulte la documentación de la API Javadoc para obtener información
completa sobre estos métodos. Por ejemplo, para especificar que un
elemento de datos ampliados debe aparecer al menos una vez, debería establecer la
propiedad maxOccurs en 4 utilizando el método
setMaxOccurs(int):
edeDesc.setMaxOccurs(4);
- Opcional: Para añadir una descripción de elemento de datos
ampliados hijo, utilice el método ExtendedDataElementDescription.addChild().
edeDesc.addChild(childEdeDesc);
El
parámetro childEdeDesc debe ser una descripción de elemento de datos
ampliados válida.
- Añada la descripción de elemento de datos ampliados a la definición de
suceso utilizando el método EventDefinition.addExtendedDataElementDescription().
definition.addExtendedDataElementDescription(edeDesc);
Si
la definición de suceso ya incluye otra descripción de elemento de datos ampliados
con el mismo nombre y la misma vía de acceso, se emitirá una excepción DescriptionExistsException.
Ejemplo
El fragmento de código siguiente crea una nueva descripción de elemento de
datos ampliados, la llena de datos y la añade a la 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);