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

Salida del nodo RegistryLookup

Utilice el nodo RegistryLookup para recuperar cualquier tipo de entidad almacenada en WebSphere Service Registry and Repository (WSRR). Las entidades que coincidan con los criterios de búsqueda especificados se almacenarán en el entorno local. El mensaje de entrada no se modificará.

Este tema contiene las siguientes secciones:

Establecimiento de la propiedad Política de profundidad

La propiedad Política de profundidad del nodo RegistryLookup especifica cuántos datos se van a devolver para cada entidad coincidente. En la siguiente tabla se muestran los valores válidos.
Valor de la propiedad Política de profundidad Valor de alteración temporal del entorno local Datos devueltos
Devolver sólo coincidentes (Profundidad = 0) MatchOnly Solamente las entidades coincidentes
Devolver sólo coincidentes, mostrando relaciones inmediatas (sólo para compatibilidad) MatchShowRel Las entidades coincidentes y consultas adicionales
Devolver coincidentes y entidades relacionadas inmediatamente (Profundidad = 1) MatchPlusImmediate Las entidades coincidentes y las entidades hijo relacionadas inmediatas
Devolver coincidentes y todas las entidades relacionadas (Profundidad = -1) MatchPlusAll Las entidades coincidentes y todas las entidades hijo relacionadas

Utilice MatchShowRel para compatibilidad con versiones de WebSphere Message Broker anteriores a la versión 6.1.0.4. La salida del entorno local de MatchShowRel aparece en el ejemplo 1 y sigue el formato que se había utilizado en las versiones anteriores. No obstante, la opción MatchShowRel está en desusos, y sólo se proporciona para la compatibilidad con versiones anteriores. No utilice MatchShowRel si está creando un flujo de mensajes nuevo y piense en realizar una migración de los flujos de mensajes para utilizar una de las demás opciones.

Utilice la opción MatchOnly para recuperar solamente las entidades individuales que coincidían con los criterios de búsqueda. Esta opción es eficiente, sin embargo, la salida de entorno local no contiene información sobre las entidades relacionadas con las entidades coincidentes.

Utilice la opción MatchPlusImmediate para recuperar entidades que coincidían con los criterios de búsqueda y las entidades hijo relacionadas. Esta opción ofrece un compromiso útil que le permite acceder a las relaciones inmediatas de las entidades coincidentes aunque se sigue restringiendo la cantidad total de datos recuperados.

Utilice una de las opciones MatchOnly o MatchPlusImmediate cuando migre un flujo de mensajes que utiliza la opción en desuso MatchShowRel. Si su flujo de mensajes original ha utilizado la información de relación en las entidades coincidentes, utilice la opción MatchPlusImmediate. Consulte el apartado Migración de un flujo de mensajes que utiliza la opción MatchShowRel.

Utilice la opción MatchPlusAll para recuperar las entidades coincidentes con los criterios de búsqueda y todas las entidades hijo relacionadas. Utilice esta opción solamente si el flujo de mensajes necesita acceso a más relaciones además de la relación inmediata de las entidades coincidentes, porque recupera una bastantes más datos que la opción MatchPlusImmediate, consulte Árbol de salida del entorno local.

Árbol de salida del entorno local

El árbol de salida del entorno local tiene un formato distinto cuando se emplea la opción en desuso MatchShowRel de la propiedad Política de profundidad. En la tabla siguiente se describen las diferencias en el formato del árbol de salida del entorno local.

Opciones MatchOnly, MatchPlusImmediate y MatchPlusAll Opción MatchShowRel
El elemento de la carpeta ServiceRegistry pertenece al compilador XMLNSC. No hay ningún analizador poseedor del elemento de carpeta ServiceRegistry y cada elemento Entidad pertenece al analizador XMLNS
El árbol ServiceRegistry no utiliza espacios de nombres innecesarios. Los espacios de nombres se conectan a todos los elementos de carpeta UserDefined, lo que significa que la vía de acceso especificada debe declarar y utilizar el espacio de nombres relevante para acceder a los campos de estas carpetas.
El árbol ServiceRegistry se ha optimizado gracias al uso del analizador XMLNSC. El árbol de salida contiene una cantidad de declaraciones XML, pcdata y elementos de espacio en blanco que no tienen ningún significado empresarial.
En WSRR, los datos binarios se representan como GenericDocument con un atributo content. El atributo content se representa en el entorno local como tipo XMLNSC Attribute+base64Binary, (0x03000160). Puede acceder a los datos binarios decodificados directamente como Entity.content. Sin embargo, debido al tipo de elemento XMLNSC especial, los datos se codifican directamente como base64 si se ha serializado el árbol. El contenido binario se representa como una serie de caracteres codificados como base64 en el atributo content. El flujo de mensajes debe invocar un método Java™ para descodificar el valor si son necesarios los datos binarios originales.
Las entidades recuperadas no se modifican para añadir propiedades de usuario. Las entidades coincidentes aparecen en el entorno local con una propiedad de usuario denominada WSRREncoding. Esta propiedad no tiene ningún significado específico para el proceso de flujos de mensajes. Si hay una propiedad de usuario denominada WSRREncoding que se ha definido para la entidad, se utilizará el valor definido, de lo contrario, se añadirá la propiedad WSRREncoding con value="DEFAULT".
Las opciones MatchPlusImmediate yMatchPlusAll ofrecen un gráfico de entidades que se devuelven cuando WSRR ejecuta la consulta. Cada entidad del gráfico puede hacer referencia a otras entidades. Hay dos tipos de relación que no se pueden expresar directamente en un árbol jerárquico:
  • Referencias cíclicas - un gráfico puede contener una entidad de la que puede seguir las relaciones que llegan de nueve a la misma entidad.
  • Varias referencias - un gráfico puede contener una entidad a la cual hacen referencia diversas entidades.
La representación de estas relaciones en el árbol de salida del entorno local se describe a continuación.
El gráfico WSRR se representa en el árbol de salida del entorno local tal como se indica:
  • Las entidades coincidentes que se devuelven en el gráfico WSRR se representan como elementos Entidad como el primer hijo de LocalEnvironment.ServiceRegistry. Las propiedades de las entidades coincidentes se representan como elementos hijo.
  • Una entidad coincidente puede contener referencias a otras entidades. Si se establece MatchPlusImmediate, estas referencias se representan como elementos hijos de la entidad coincidente. Si se establece MatchPlusAll, se aplica la misma regla de forma recursiva a los hijos.
  • Referencias cíclicas - si una entidad hace referencia a otra entidad que es una de las anteriores en el gráfico WSRR, la entidad a la que se hace referencia se representa como un elemento EntityRef. Un elemento EntityRef no representa directamente la entidad de destino pero proporciona información para identificarla. De este modo se evita la posibilidad de entrar en bucles cíclicos cuando se navegue por el árbol.

    El diagrama siguiente muestra las referencias de la entidad D1 en el gráfico con las entidades C1 y A que son antiguas; por lo tanto, la entidad D1 del árbol de mensajes contiene elementos EntityRef para A y C1.

    Gráfico que muestra referencias cíclicas, que se describen en el texto del gráfico.
  • Varias referencias - si hay una entidad en el gráfico SDO de WSRR a la que se hace referencia en más de una entidad, se representa como un elemento de entidad independiente en el árbol de mensajes cada vez que se hace referencia a tal entidad. El elemento entidad se clona junto con las entidades a las que hace referencia.

    En el diagrama siguiente se muestra que la entidad X1 del gráfico se representa mediante las entidades Y1 y Y2, por lo que la entidad X1 y la entidad W1 a las que hace referencia se modelan dos veces en el árbol de mensajes.

    Gráfico que muestra diversas referencias

Migración de un flujo de mensajes que utiliza la opción MatchShowRel

Cuando se migra un flujo de mensajes existente que utiliza la opción MatchShowRel en desuso de la propiedad Política de profundidad, el árbol de salida del entorno local tendrá un formato distinto. En la tabla anterior se describen las diferencias en los tres formatos de salida del entorno local, y se indica qué es necesario modificar en el flujo de mensajes para acceder a los datos en el formato actualizado; consulte Árbol de salida del entorno local.

Ejemplos

En los ejemplos siguientes se muestra la salida típica del nodo RegistryLookup:
  • El ejemplo 1 muestra la salida completa del nodo RegistryLookup en dos casos para una consulta que devuelve dos versiones de una entidad de concepto. En ambos casos, la propiedad Política de coincidencia se establece en Todas. En el primer caso, la propiedad Política de profundidad se ha establecido en Devolver coincidentes y entidades relacionadas inmediatamente (Profundidad = 1) y en el segundo caso, la propiedad Política de profundidad se ha establecido en Devolver sólo coincidentes, mostrando relaciones inmediatas (sólo para compatibilidad). En este ejemplo también se muestra un ESQL de ejemplo para leer elementos de la salida. Consulte el apartado Salida del nodo RegistryLookup: ejemplo 1
  • En el ejemplo 2 se muestra la estructura de la salida del nodo RegistryLookup para todos los valores posibles de la propiedad Política de profundidad para una consulta en una entidad de concepto que tenga un número de relaciones de usuario en otras entidades de concepto. Consulte el apartado Salida del nodo RegistryLookup: ejemplo 2
  • En el ejemplo 3 se muestra la estructura de la salida del nodo RegistryLookup para una consulta en una entidad que tiene relaciones de metadatos y relaciones definidos por el usuario, utilizando un valor de la propiedad Política de profundidad de Devolver coincidentes y todas las entidades relacionadas (Profundidad = -1). Consulte el apartado Salida del nodo RegistryLookup: ejemplo 3.
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:58:50


Tema de conceptoTema de concepto | Versión 8.0.0.5 | ac56330_