Métodos para um nó .NETInput

Os métodos que podem ser implementados em um nó .NETInput dependem se você está usando fluxos de mensagens no estilo de evento ou pesquisa.

A API para o nó .NETInput é chamada de API do Conector. Essa API está no namespace IBM.Broker.Plugin.Connector.

Inicializar
O método Inicializar é chamado quando um fluxo de mensagens que contém o nó .NETInput é implementado em um servidor de integração (grupo de execução). Se uma exceção for lançada de Initialize, ela recuperará a implementação do fluxo.

Start
Use o método Iniciar para criar quaisquer conexões necessárias para o sistema final a partir da qual o nó .NETInput recupera os dados. Este método é chamado após o método Inicializar, quando um fluxo de mensagens que contenham o nó .NETInput é implementado com êxito.

Se o método Iniciar emitir uma exceção, ele não influenciará o resultado da implementação do fluxo de mensagens. Tal exceção relatará um erro ao log do sistema e o método Iniciar é chamado novamente após uma breve espera.

Conectores do Evento

Diagrama de uma entrada do aplicativo MSMQ em um nó .NETInput.

Se você estiver usando o estilo orientado do nó .NETInput, então você deve registrar um delegado definido pelo usuário com o aplicativo que é a origem dos eventos, que a unidade o nó .NETInput . Se você usar o estilo acionado por eventos e não registrar uma delegação no método Start, então, não será possível para o nó .NETInput propagar dados para os encadeamentos de fluxo de mensagens. O métodos Delegar Usuário é responsável por criar objetos NBEvent e passando-os para o método DeliverEvent fornecido no NBEventConnector de classe. O método DeliverEvent coloca os dados em uma fila na memória, o que os encadeamentos do fluxo de mensagens de acesso para transmitir os dados no objeto NBEvent .

ReadData

Conectores de Sondagem Orientada

Diagrama do nó .NETInput em uma configuração de exemplo MSMQ, envia ReadData() de volta para a fila do MSMQ.

Se você estiver usando o estilo de chamada seletiva do nó .NETInput, você deve implementar o método ReadData no NBPollingConnector de classe-base. O método ReadData é chamado pelo código interno do broker; portanto, um desenvolvedor de nó .NETInput apenas implementa o método, não sendo responsável por fornecer o código que de fato chama o método. Portanto, o .NETInput não é responsável por implementar lógica de sondagem recursiva, e portanto, não é necessário ou adequado para o código de um loop ou utilize um método Sleep como parte do ReadData.

O broker executa o método ReadData automaticamente após o fluxo de mensagens terminar a implementação, quando o método Start retorna sem uma exceção.

O método ReadData é responsável por ter dados da origem de dados, se disponíveis, e retorna uma instância do objeto NBPollingResult . Se os dados estiverem disponíveis, o objeto NBPollingResult retornado será um NBByteArrayPollingResult integrado, que cria a mensagem de saída diretamente da matriz de bytes, ou uma subclasse definida pelo usuário, da qual se pode criar a árvore de mensagens manualmente.

Consulte o diagrama a seguir para um exemplo de uso do polling com o método ReadData .

Diagrama de um encadeamento de fluxo para um estilo de polling do nó .NETInput, com intervalos de espera.

Se não houver dados disponíveis, o desenvolvedor do nó retorna uma NBTimeoutPollingResult. Quando o método ReadData tiver terminado de aguardar a transmissão na duração de tempo limite (T1), use o construtor de argumento único para NBTimeoutPollingResult. Se a origem de dados não permitir uma espera cronometrada, use o construtor de dois argumentos para retornar um valor de tempo limite de volta ao broker. Neste caso, o broker aguardará para esse intervalo de tempo limite (T2) antes de chamar ReadData novamente. Esse uso do método permite que um desenvolvedor do nó .NETInput controle a duração do intervalo entre pesquisas (T2).

Por exemplo, você pode implementar um estilo de lote de operação, solicitando que o método ReadData seja chamado apenas uma vez por hora, ou uma vez por dia.

Finish
O método Finish é chamado quando o nó .NETInput que está usando o conector deve parar de receber dados. Quando remover um fluxo de mensagens que contenha um nó .NETInput implementado para um servidor de integração, o método Concluir é chamado antes do método Finalizar. Se o Concluir método emite uma exceção, o erro é relatado ao log do sistema, e o conector será colocado no estado parado. Este método é um bom local para fechar conexões, alças, ou semelhantes.

Encerrar
O método Finalizar é chamado quando uma fluxo de mensagens que contém o nó .NETInput é removido de um servidor de integração. Esse método sempre fornece uma maneira de o código ser encerrado corretamente, se você não quer fazer nada antes de remover um fluxo de mensagens implementado que contém um nó .NETInput.

Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:08:51


Tópico de ReferênciaTópico de Referência | IBM Integration Bus Versão 9.0.0.0 | bc34237_