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

Grupo cniSearchElementInNamespace

Utilice este grupo de funciones para buscar un elemento que coincida con los criterios especificados.

La búsqueda se inicia en el elemento de sintaxis especificado en el argumento de elemento y cada una de las cuatro funciones proporciona una búsqueda en una dirección diferente del árbol:
  1. cniSearchFirstChildInNamespace realiza la búsqueda de los elementos hijo inmediatos del elemento de inicio a partir del primer hijo, hasta que se encuentra una coincidencia o hasta que se alcanza el final de la cadena de elementos hijo.
  2. cniSearchLastChildInNamespace realiza la búsqueda de los elementos hijo inmediatos del elemento de inicio a partir del último hijo, hasta que se encuentra una coincidencia o hasta que se alcanza el final de la cadena de elementos hijo.
  3. cniSearchNextSiblingInNamespace realiza la búsqueda del elemento de inicio a los hermanos siguientes, hasta que se encuentra una coincidencia o hasta que se alcanza el final de la cadena de hermanos.
  4. cniSearchPreviousSiblingInNamespace realiza la búsqueda del elemento de inicio a los hermanos anteriores, hasta que se encuentra una coincidencia o hasta que se alcanza el inicio de la cadena de hermanos.

Utilice esta función cuando busque un mensaje que pertenezca a un dominio preparado para espacios de nombres.

Sintaxis

void cniSearchFirstChildInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchLastChildInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchNextSiblingInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchPreviousSiblingInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	CciElementType type,
	const CciChar* nameSpace,
	const CciChar* name)		

Parámetros

returnCode
Código de retorno de la función (salida). La especificación de un puntero NULL significa que el nodo no desea tratar los errores. Si la entrada no es NULL, la salida significa el estado de éxito de la llamada. Todas las excepciones generadas durante la ejecución de esta llamada se vuelven a generar en el nodo ascendente siguiente del flujo. Llame a cciGetLastExceptionData para obtener información detallada de la excepción.
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Dirección del objeto de elemento de sintaxis desde el que se inicia la búsqueda (entrada).
mode
Modalidad de búsqueda que se debe utilizar (entrada). Este parámetro indica qué combinación de espacio de nombres de elemento, nombre de elemento y tipo de elemento se debe buscar. Los valores posibles son:
  • CCI_COMPARE_MODE_SPACE
  • CCI_COMPARE_MODE_SPACE_FULL_TYPE
  • CCI_COMPARE_MODE_SPACE_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPACE_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME
  • CCI_COMPARE_MODE_SPACE_NAME_FULL_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NULL
Cuando la modalidad de comparación no implica una coincidencia en el espacio de nombres, se busca en todos los espacios de nombres. Este comportamiento es diferente del comportamiento del grupo cniSearchElement, en el que sólo se busca en el espacio de nombres de serie de caracteres vacía. Cuando especifique una de las modalidades válidas, establezca el parámetro nameSpace en la serie de caracteres vacía.
type
El tipo de elemento que se debe buscar (entrada). Utilice este parámetro sólo si la modalidad de búsqueda implica una coincidencia en el tipo.
nameSpace
El espacio de nombres en el que se debe buscar (entrada). Utilice este parámetro sólo si la modalidad de búsqueda implica una coincidencia en el espacio de nombres.
name
El nombre que se debe buscar (entrada). Utilice este parámetro sólo si la modalidad de búsqueda implica una coincidencia en el nombre.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

 mode=CCI_COMPARE_MODE_SPACE ;
 ...

   if (forward) {
      firstChild = cniSearchFirstChildInNamespace(&rc, element, mode, space, 0,0);
    }else{
      firstChild = cniSearchLastChildInNamespace(&rc, element, mode, space, 0,0);

    }

    if (firstChild) {
      depth++;
      traceElement(firstChild,forward,space);
      depth--;
    }
    currentElement = firstChild;
    do{

      if (forward) {
        nextSibling = cniSearchNextSiblingInNamespace(&rc, currentElement,mode,space,0,0);
      }else{
        nextSibling = cniSearchPreviousSiblingInNamespace(&rc, currentElement,mode,space,0,0);
      }
      if (nextSibling) {
        traceElement(nextSibling,forward,space);
        currentElement=nextSibling;
      }

    }while (nextSibling) ;
    
  }
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 17:00:23


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