Inicio rápido del servicio de mensajería web

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. .


Paso 1. Instale el servicio de mensajería web.

El servicio de mensajería web debe estar instalado para ejecutar una aplicación habilitada para mensajería web. Consulte las instrucciones de instalación de IBM® WebSphere Application Server Feature Pack for Web 2.0 y Mobile para obtener más información.

Paso 2. Localice la biblioteca de programa de utilidad.

Localice la biblioteca de programa de utilidad del servicio de mensajería Web que se ha proporcionado con esta documentación. 

Paso 3. Habilite el servicio de mensajería web

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.

  1. Inicie sesión en la consola administrativa de WebSphere Application Server.
  2. Vaya a Servidores->Servidores de aplicaciones
  3. Seleccione el servidor de aplicaciones actual.
  4. Expanda Valores de contenedor Web y seleccione Cadenas de transporte de contenedor Web.
  5. Seleccione Cadena de transporte WCInboundDefault o seleccione la cadena de transporte correspondiente al host virtual que seleccionará durante la instalación de la aplicación.
  6. Seleccione Canal de entrada de contenedor Web (WCC 2).
  7. Seleccione Propiedades personalizadas.
  8. Pulse Nuevo.
  9. Especifique webmsgenabled para la propiedad de nombre y true para el valor.
  10. Pulse Aplicar.
  11. Pulse Guardar para guardar la información de repositorio.
  12. Puede reiniciar el servidor de aplicaciones ahora o esperar hasta después del paso Configuración del bus de integración de servicios.

Paso 4. Configure un bus de integración de servicio.

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.

Paso 5. Inserte Dojo Toolkit en el módulo 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.

Paso 6. Incorpore la biblioteca de programa de utilidad de mensajería Web en el 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.

Paso 7. Determine el URI de comunicación del servicio de mensajería Web y correlacione el servlet de mensajería Web con el URI.

El parámetro de correlación de servlets "/webmsgServlet" define el URI de comunicación entre el cliente Bayeux de Dojo y el servicio de mensajería web. En el lado del servidor, debe crearse una correlación de servlets que coincida con el parámetro de inicialización dojox.cometd.init. La correlación de servlets se correlaciona con la clase de servlet com.ibm.websphere.webmsg.servlet.WebMsgServlet. Este servlet se proporciona en la biblioteca del programa de utilidad de mensajería web. A continuación, se muestra un ejemplo de archivo web.xml. Consulte Desarrollo de una aplicación habilitada para mensajería web para obtener más informació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>
 

      
En el paso 9, el cliente cometd de Dojo Toolkit utiliza el URI definido anteriormente para la inicialización. En el paso 9 y en un ejemplo se utiliza una sentencia de inicialización sencilla en un archivo de presentación, que se muestra a continuación a efectos de comparación:   dojox.cometd.init( "webmsgServlet");

Paso 8. Cree un archivo de configuración de mensajería web.

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
      }
}
      

Paso 9. Cree la aplicación cliente.

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>
      

Paso 10. Instale y ejecute la aplicación.

Ensamble, instale y pruebe la aplicación mediante el uso de procedimientos de ensamblaje, instalación y prueba de aplicaciones Web estándar.



Condiciones de uso | Comentarios