WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cniSqlNavigatePath

Use esta função para executar a SQLPathExpression que você criou chamando as funções de utilitário cniSqlCreateReadOnlyPathExpression ou cniSqlCreateModifiablePathExpression, conforme definido pelo argumento sqlPathExpression.

Sintaxe

CciElement* cniSqlNavigatePath( 
	int*                  returnCode,
	CciSqlPathExpression* sqlPathExpression,
	CciMessage*           inputMessageRoot,
	CciMessage*           inputLocalEnvironment,
	CciMessage*           inputExceptionList,       
	CciMessage*           outputMessageRoot
	CciMessage*           outputLocalEnvironment,
	CciMessage*           outputExceptionList);

Parâmetros

returnCode (saída)
Uma entrada de ponteiro NULL significa que o nó definido pelo usuário não manipulará os erros. Quaisquer exceções lançadas durante a execução desta chamada serão lançadas novamente para o próximo nó de envio de dados no fluxo. Se a entrada não for NULL, a saída significará o status de êxito da chamada. Se uma exceção ocorrer durante a execução, *returnCode será definido como CCI_EXCEPTION na saída. Uma chamada para cciGetLastExceptionData fornecerá detalhes da exceção. Se um parâmetro sqlPathExpression inválido foi transmitido, returnCode será configurado como CCI_INV_SQL_EXPR_OBJECT. Se um valor CciMessage* inválido for transmitido, returnCode será configurado como CCI_INV_MESSAGE_OBJECT. Se o elemento não pôde ser navegado ou criado, returnCode será configurado como CCI_PATH_NOT_NAVIGABLE.
sqlPathExpression (entrada)
Especifica o objeto SQLPathExpression a ser executado como retornado pela função cniCreateReadOnlyPathExpression ou cniCreateModifyablePathExpression. Este parâmetro não pode ser NULL.
inputMessageRoot (entrada)
A mensagem representando a mensagem de entrada. Este parâmetro não pode ser NULL.
inputLocalEnvironment (entrada)
A mensagem representando o ambiente local de entrada. Este parâmetro não pode ser NULL.
inputExceptionList (entrada)
A mensagem representando a lista de exceções de entrada. Este parâmetro não pode ser NULL.
outputMessageRoot (entrada)
A mensagem representando a mensagem de saída. Este parâmetro pode ser NULL.
outputLocalEnvironment (entrada)
A mensagem representando o ambiente local de saída. Este parâmetro pode ser NULL.
outputExceptionList (entrada)
A mensagem representando a lista de exceções de saída. Este parâmetro pode ser NULL.

A tabela a seguir mostra o mapeamento entre os nomes de correlação aceitos na expressão de caminho ESQL e os dados acessados.

Nome de Correlação Dados Acessados
Ambiente A única árvore Ambiente para o fluxo. Esse elemento é determinado pelo broker e não é necessário especificá-lo através dessa API.
InputLocalEnvironment Parâmetro inputLocalEnvironment para cniSqlNavigatePath
OutputLocalEnvironment Parâmetro outputLocalEnvironment para cniSqlNavigatePath
InputRoot Parâmetro inputMessageRoot para cniSqlNavigatePath
InputBody Último filho de InputRoot
InputProperties InputRoot.Properties (InputRoot.Properties é o primeiro filho de InputRoot, chamado "Properties")
OutputRoot Parâmetro outputMessageRoot para cniSqlNavigatePath
InputExceptionList Parâmetro inputExceptionList para cniSqlNavigatePath
OutputExceptionList Parâmetro outputExceptionList para cniSqlNavigatePath
Database Origem de dados ODBC identificada pelo parâmetro dataSourceName para cniCreateReadOnlyPathExpression ou cniCreateModifyablePathExpression
InputDestinationList Sinônimo de InputLocalEnvironment que é compatível com versões anteriores
OutputDestinationList Sinônimo de OutputLocalEnvironment que é compatível com versões anteriores

Todas as outras regras sobre a navegabilidade e validade de caminhos reais estão definidas em Nomes de Correlação.

Valores de Retorno

Se o caminho for navegado com êxito, o endereço do elemento de sintaxe será retornado. Entretanto, se o caminho não for navegável, um valor igual a zero (CCI_NULL_ADDR) será retornado e o parâmetro returnCode indicará a razão para o erro.

Exemplo

Supondo que você tenha criado anteriormente uma SQLPathExpression (consulte o exemplo para cniSqlCreateReadOnlyPathExpression ou cniSqlCreateModifiablePathExpression), seria possível utilizar o seguinte código para navegar no elemento de destino.

 CciElement* targetElement = cniSqlNavigatePath(
                           NULL,
                          ((NODE_CONTEXT_ST *)context)->pathExpression,
                           message,
                           localEnvironment,
                           exceptionList,
                           NULL, /* não referenciar nenhuma árvore de saída*/
                           NULL,
                           NULL);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:23


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as08033_