El servicio de mensajería web se compone de un archivo JAR (JavaTM archive) de tiempo de ejecución que se coloca en el directorio de instalación de WebSphere® Application Server y de una biblioteca designada para que se inserte en un módulo Web existente o nuevo como un archivo JAR de programa de utilidad. En esta sección se ofrecen instrucciones breves sobre cómo habilitar el servicio de mensajería web y cómo desarrollar una aplicación habilitada para mensajería web. En esta sección se incluyen enlaces a secciones más detalladas. .
Linux y UNIX: /opt/WebSphere/AppServer |
---|
Windows:
c:\WebSphere\AppServer |
Linux y UNIX:
/opt/WebSphere/AppServer/optionalLibraries/webmsg_applib.jar.
|
---|
Windows:
c:\WebSphere\AppServer\optionalLibraries\webmsg_applib.jar.
|
Debe habilitar el servicio de mensajería web para que se ejecute una aplicación habilitada para mensajería web. Consulte las instrucciones de Habilitación del servicio de mensajería web para obtener más información.
Una aplicación de mensajería web debe tener configurado un bus de integración de servicios con un espacio de temas definido para ejecutarlo. Para que funcione una aplicación de mensajería web, como mínimo debe proporcionarse el nombre de bus en un archivo de configuración de mensajería web.
Dojo Toolkit proporciona soporte de cliente para el servicio de mensajería web. La forma más fácil es incluir Dojo Toolkit en un módulo Web. Si Dojo Toolkit no se incluye en un módulo Web (servido de forma estática mediante el servidor Web, por ejemplo), debe conocer la ubicación del identificador universal de recursos (URI) del archivo dojo.js para cargar Dojo Toolkit en los archivos de presentación de módulo Web.
El mejor lugar para insertar la biblioteca de programa de utilidad de mensajería web es en el directorio WEB-INF/lib de un módulo Web como una biblioteca de programa de utilidad. Copie el archivo webmsg_applib.jar localizado en el paso 1 en el directorio WEB-INF/lib del módulo Web. Puede utilizar la biblioteca de programa de utilidad de mensajería web en el mismo módulo Web que Dojo Toolkit o en otro módulo Web. El punto de interacción clave es el URI de comunicación del protocolo Bayeux. Para obtener más información, consulte los pasos de instalación.
<servlet> <description/> <display-name> WebMsgServlet </display-name> <servlet-name>WebMsgServlet</servlet-name> <servlet-class> com.ibm.websphere.webmsg.servlet.WebMsgServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>WebMsgServlet</servlet-name> <url-pattern>/webmsgServlet</url-pattern> </servlet-mapping> |
El servicio de mensajería web lee los parámetros de configuración
de un archivo de configuración para manejar las peticiones de mensajería web entrantes. Cree un archivo de configuración de mensajería web, webmsg.json, en el
directorio WEB-INF (mismo directorio que el archivo web.xml) como se muestra en el
siguiente ejemplo. El archivo webmsg.json se especifica como un objeto JSON (correlación)
donde cada clave coincide con un nombre de servlet existente correlacionado con el servlet
de mensajería web. En la sección Visión general de la
configuración encontrará información sobre todas las opciones de configuración
posibles.
{ "WebMsgServlet": { "busName": "thebus", "destination": "Default.Topic.Space", "clientCanPublish": true, "longPollTimeout": 30 } } |
Ahora se ha completado toda la configuración del lado del servidor, excepto la
instalación de la aplicación. La tarea que queda es crear la lógica del lado del cliente
utilizando las funciones de Dojo Toolkit. A continuación, se proporciona un ejemplo de prueba sencillo. Observe cómo coincide el parámetro del URI de inicialización con la correlación de
servlets de mensajería web.
<html> <head> <title>cometd client/server test page</title> <script type="text/javascript" src="dojo/dojo.js" djConfig="isDebug: true, parseOnLoad: true, debugAtAllCosts: false"></script> <script type="text/javascript"> dojo.require("dojox.cometd"); dojo.addOnLoad(function(){ dojox.cometd.init("webmsgServlet") dojox.cometd.subscribe("/testtopic", window, "display"); } ); function display(msg) { alert("Message " + msg.data.test); } </script> <div align="left"> <button Id="publishButton" onclick="dojox.cometd.publish('/testtopic', {test: 'Data'});"> <span style="font-size:small">PUBLISH</span> </button> </div> </head> <body></body> </html> |
Ensamble, instale y pruebe la aplicación mediante el uso de procedimientos de ensamblaje, instalación y prueba de aplicaciones Web estándar.