WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

MbsElement

La clase MbsElement representa un solo elemento analizado en un mensaje (u otro árbol lógico).

La clase MbsElement proporciona los métodos de API que se muestran en la tabla siguiente (los parámetros entre corchetes son opcionales):

Método Descripción
Constructor() Crea una instancia de un nuevo objeto MbsElement.
object getValue() Devuelve el valor del elemento actual.
void setValue(object $value) Establece el valor del elemento actual.
int getType() Devuelve el tipo específico del elemento actual. Para obtener una lista completa de valores de tipo, consulte Constantes PHP para valores de tipo.
void setType(int $type) Establece el tipo específico del elemento actual. Para obtener una lista completa de valores de tipo, consulte Constantes PHP para valores de tipo.
object xpath(string $expression [, array $namespace]) Evalúa la expresión XPath con el elemento actual como nodo de contexto. Devuelve el resultado como serie, doble, booleano o un conjunto de nodos, como matriz de objetos MbsElement. El parámetro opcional namespace es una matriz asociativa con prefijos de espacio de nombres como claves, y URIs de espacio de nombres como valores.
string getName() Devuelve el nombre del elemento actual.
void setName(string $name) Establece el nombre del elemento actual.
string getNamespace() Devuelve el URI de espacio de nombres del elemento actual.
void setNamespace($namespace) Establece el URI de espacio de nombres del elemento actual.
MbsElement getParent() Devuelve el padre del elemento actual.
MbsElement getChild(string $name [, int $occurrence]) Devuelve el primer hijo del elemento actual, cuyo nombre lo proporciona el primer parámetro. Puede devolverse la aparición nth de ese hijo especificando un segundo parámetro opcional.
array getChildren([string $namespace]) Devuelve todos los elementos hijo n del elemento actual como un matriz de MbsElements. Si se especifica el parámetro namespace, la matriz contiene sólo los elementos hijo con ese URI de espacio de nombres.
MbsElement getFirstChild() Devuelve el primer hijo del elemento actual.
MbsElement getLastChild() Devuelve el último hijo del elemento actual.
MbsElement getNextSibling() Devuelve el hermano siguiente del elemento actual.
MbsElement getPreviousSibling() Devuelve el hermano anterior del elemento actual.
MbsElement getAttribute(string $name) Devuelve el atributo del elemento actual proporcionado por el parámetro name.
MbsElement addAttribute(string $name, object $value [, string $namespace]) Añade un atributo al elemento actual.
MbsElement addElement(string $name, object $value [, string $namespace [, int $type [, int $position]]]) Crea un elemento como último hijo (por omisión) del elemento actual. El parámetro opcional type es el tipo específico de analizador del nodo nuevo (que toma el valor predeterminado del tipo de elemento XML para los analizadores XML). El parámetro opcional position puede ser uno de los valores siguientes:
  • MB_FIRST_CHILD
  • MB_LAST_CHILD
  • MB_NEXT_SIBLING
  • MB_PREVIOUS_SIBLING
MbsElement detach() Separa el elemento actual del árbol.
void detachAllChildren() Separa todos los elementos hijo del elemento actual.
string asBitstream([array $options]) Serializa el árbol de elementos para generar una corriente de bits. Cuando se utiliza el analizador MRM (y otros analizadores), la matriz options debe contener las siguientes parejas clave/valor:
array ('set' => '<MessageSet>', 
'type' => '<MessageType>',
'format' => '<MessageFormat>',
'encoding' => '<encoding>',
'ccsid' => '<ccsid>')
void addElementFromBitstream(string $bitstream [, array $options]) Crea un árbol de elementos a partir de la corriente de bits proporcionada. Si no se proporciona options, la corriente de bits se analiza utilizando el analizador del elemento actual y se adjunta como su último hijo (en este caso no se crea ningún elemento de dominio). Si se proporciona options, debe contener la pareja clave/valor 'domain' => '<parserDomain>' más cualquiera de las opciones adicionales del analizador MRM (consulte asBitstream()). En este caso, se crea un elemento de analizador en la cabeza del nuevo subárbol y se adjunta como el último hijo del elemento actual.
Puede crear elementos en PHP para crear subárboles. El ejemplo siguiente muestra una función PHP que genera la parte de devoluciones de un árbol de salida:
function transformItem($input) {
      $item = new MbsElement;
      $item->Desc = $input->Description;
      $item->Cost = $input->Price->getValue() * 1.6;
      $item->Qty = $input->Quantity;

      return $item;
   }
Puede copiar este subárbol en un mensaje de salida utilizando el código siguiente:
$output_assembly->XMLNSC->doc->item = transformItem($input_sub_tree);
donde $input_sub_tree hace referencia a una parte del mensaje de entrada.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:59:02


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac69022_