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á.
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.
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". |
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.
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.
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.