Adición de descripciones de elementos de datos ampliados a una definición de suceso

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

  1. 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.
  2. 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);
  3. 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.
  4. 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);

Condiciones de uso |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org)