O serviço de sistema de mensagens da Web consiste de um arquivo JavaTM archive (JAR) de tempo de execução, que é colocado no diretório de instalação do WebSphere® Application Server, e de uma biblioteca designada para ser inserida em um módulo da Web novo ou existente como um arquivo JAR utilitário. Essa seção fornece instruções breves sobre como ativar o serviço de sistemas de mensagens da Web e o desenvolvimento de um aplicativo ativado por sistema de mensagens da Web. Incluídos nesta seção estão links para seções mais detalhadas. .
Linux e UNIX: /opt/WebSphere/AppServer |
---|
Windows:
c:\WebSphere\AppServer |
Linux and UNIX:
/opt/WebSphere/AppServer/optionalLibraries/webmsg_applib.jar.
|
---|
Windows:
c:\WebSphere\AppServer\optionalLibraries\webmsg_applib.jar.
|
Você deve ativar o serviço de sistema de mensagens da Web para um aplicativo ativado pelo sistema de mensagens da Web ser executado. Consulte as instruções de Ativação do Serviço de Sistema de Mensagens da Web para obter informações adicionais.
Um aplicativo de sistema de mensagens da Web deve ter um barramento de integração de serviços configurado com um espaço de tópico para execução. No mínimo, o nome do barramento deve ser fornecido em um arquivo de configuração do sistema de mensagens da Web para que um aplicativo de sistema de mensagens da Web funcione.
O Dojo Toolkit fornece suporte a clientes para o serviço de sistema de mensagens da Web. A maneira mais fácil é incluir o Dojo Toolkit em um módulo da Web. Se o Dojo Toolkit não estiver incluído em um módulo da Web (atendido de forma estática através do servidor da Web, por exemplo), o local da URI (Uniform Resource Identifier) do arquivo dojo.js deverá ser conhecido para carregar o Dojo Toolkit em qualquer arquivo de apresentação do módulo da Web.
O melhor local para inserir a biblioteca do utilitário de sistema de mensagens da Web é em um diretório WEB-INF/lib do módulo da Web como uma biblioteca do utilitário. Copie o arquivo webmsg_applib.jar localizado na etapa 1 para o diretório WEB-INF/lib do módulo da Web. É possível utilizar a biblioteca do utilitário de sistema de mensagens da Web no mesmo módulo da Web que o Dojo Toolkit ou em um módulo da Web diferente. O ponto de interação chave é a URI de comunicação do protocolo Bayeux. Consulte as etapas de instalação para obter informações adicionais.
<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> |
O serviço de sistema de mensagens da
Web lê os parâmetros de configuração a partir de um arquivo de configuração para
manipular pedidos de sistema de mensagens da Web recebidos. Crie um arquivo de configuração do sistema de mensagens da Web, webmsg.json, no diretório WEB-INF (mesmo diretório do arquivo web.xml) semelhante ao exemplo a seguir. O arquivo webmsg.json é especificado como um Objeto (mapa) de JSON com cada chave correspondendo a um nome de servlet existente mapeado para o servlet do sistema de mensagens da Web. A seção Visão Geral da Configuração fornece informações sobre todas as possíveis opções de configuração.
{ "WebMsgServlet": { "busName": "thebus", "destination": "Default.Topic.Space", "clientCanPublish": true, "longPollTimeout": 30 } } |
Toda a configuração do lado do servidor agora está concluída, exceto para instalar o aplicativo.
A tarefa restante é criar a lógica do lado do cliente utilizando as funções do Dojo Toolkit. Um exemplo de teste simples é fornecido aqui. Observe como o parâmetro da URI de inicialização corresponde ao mapeamento de servlet do sistema de mensagens da 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> |
Monte, instale e teste o aplicativo usando os procedimentos de montagem, instalação e de teste de aplicativo da Web padrão.