Métodos para un nodo .NETInput

Los métodos que puede implementar en un nodo .NETInput dependen de si utiliza flujos de mensajes de estilo de sucesos o sondeo.

La API del nodo .NETInput se denomina API de conector. Esta API se encuentra en el espacio de nombres IBM.Broker.Plugin.Connector.

Initialize
El método Initialize se invoca cuando un flujo de mensajes que contiene el nodo .NETInput se despliega en un servidor de integración (grupo de ejecución). Si se genera una excepción desde Inicializar, se retrotraerá el despliegue del flujo.

Start
Utilice el método Start para crear las conexiones que sean necesarias con el sistema final desde el cual el nodo .NETInput recupera datos. Este método se invoca después del método Initialize, cuando un flujo de mensajes que contiene el nodo .NETInput se despliega satisfactoriamente.

Si el método Start genera una excepción, entonces no influye en el resultado del despliegue del flujo de mensajes. Esta excepción notifica un error en el registro del sistema y el método Start se invoca de nuevo tras un rato de espera.

Conectores de sucesos

Diagrama de una entrada de aplicación MSMQ en un nodo .NETInput.

Si utiliza el tipo de nodo .NETInput conducido por sucesos, debe registrar un delegado definido por un usuario con la aplicación que es origen de los sucesos, que conducen el nodo .NETInput. Si utiliza el tipo de suceso conducido por menús y no registra un delegado en el método Start, entonces no hay forma de que el nodo .NETInput propague datos a las hebras flujo de mensajes. El método User Delegate es responsable de crear objetos NBEvent y pasarlos al método DeliverEvent proporcionado en la clase NBEventConnector. El método DeliverEvent pone datos en una cola de la memoria, a las que las hebras de flujo de mensajes acceden para pasar los datos en el objeto NBEvent.

ReadData

Conectores conducidos por sondeo

El diagrama del nodo .NETInput en una configuración MSMQ de ejemplo, que envía ReadData() de nuevo a la cola MSMQ.

Si utiliza el tipo de sondeo del nodo .NETInput, debe implementar el método ReadData de la clase base NBPollingConnector. El método ReadData lo invoca el código interno del intermediario, por lo tanto un desarrollador de nodo .NETInput implementa el método únicamente y no es responsable de proporcionar código que realmente llame al método. Por lo tanto, .NETInput no es responsable de implementar ninguna lógica de sondeo recurrente y por lo tanto, no es necesario ni apropiado codificar un bucle o utilizar un método Sleep como parte de ReadData.

El intermediario ejecuta el método ReadData automáticamente después de que el flujo de mensajes finalice el despliegue, cuando el método Start se devuelve sin ninguna excepción.

El método ReadData es responsable de tomar datos del origen de los datos, si está disponible, y devuelve una instancia del objeto NBPollingResult. Si hay datos disponibles, el objeto NBPollingResult devuelto es un NBByteArrayPollingResult incorporado, que crea el mensaje de salida directamente desde la matriz de bytes o una subclase definida por el usuario, a partir de la que se podrá crear el árbol de mensajes manualmente.

Consulte el diagrama siguiente para obtener un ejemplo de utilización de sondeo con el método ReadData.

Diagrama de una hebra de flujo para un nodo .NETInput de tipo de sondeo, con intervalos de espera.

Si no hay datos disponibles, el desarrollador de nodo devuelve un NBTimeoutPollingResult. Cuando el método ReadData ha finalizado la espera durante el tiempo de espera pasado (T1), utilice el constructor de un solo argumento para NBTimeoutPollingResult. Si el origen de datos no permite un tiempo de espera, utilice el constructor de dos argumentos para devolver un valor de tiempo de espera de nuevo al intermediario. En este caso, el intermediario espera durante este intervalo de tiempo de espera (T2) antes de llamar a ReadData de nuevo. Este uso del método permite que un desarrollador del nodo .NETInput controle la duración del intervalo entre sondeos (T2).

Por ejemplo, puede implementar un tipo de operación por lotes, solicitando que el método ReadData sólo se llame una vez por hora, o una vez al día.

Finish
El método Finish se invoca cuando el nodo .NETInput que utiliza el conector debe dejar de recibir datos. Cuando se elimina un flujo de mensajes que contiene un nodo .NETInput que se despliega en un servidor de integración, el método Finish se invoca antes que el método Terminate. Si el método Finish genera una excepción, entonces el error se notifica al registro del sistema y el conector se coloca en estado detenido. Este método es un buen lugar para cerrar las conexiones o controladores o similares.

Terminate
El método Terminate se invoca cuando un flujo de mensajes que contiene el nodo .NETInput se elimina de un servidor de integración. Este método siempre proporciona un modo para que el código finalice correctamente si desea realizar alguna acción antes de eliminar un flujo de mensajes desplegado que contiene un nodo .NETInput.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

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

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:53:11


Tema de referenciaTema de referencia | IBM Integration Bus Versión 9.0.0.0 | bc34237_