Configuração do Serviço de Sistema de Mensagens da Web

O serviço de sistema de mensagens da Web lê as informações de configuração a partir do arquivo, webmsg.json, localizado em um diretório WebContent/WEB-INF do módulo da Web do aplicativo JavaTM Platform, Enterprise Edition (Java EE). Essas informações são lidas no início e na parada do aplicativo para inicializar o serviço de sistema de mensagens da Web com as informações de configuração. Esse arquivo reside ao lado do arquivo web.xml de um módulo da Web e o local desse arquivo não pode ser alterado. O arquivo webmsg.json é especificado no formato JavaScriptTM Object Notation (JSON), cujo conteúdo do arquivo deve representar especificamente um objeto JSON. Um objeto JSON é uma coleção de pares de chave/valor. Consulte o seguinte exemplo do arquivo de configuração do sistema de mensagens da Web:

{
   "WebMsgServlet":
      {
         "busName": "thebus",
 	 "destination": "Default.Topic.Space",
         "clientCanPublish": false,
         "longPollTimeout": 30
      }
}
      

Cada chave no objeto JSON especifica um nome de servlet existente no mesmo módulo da Web no qual o arquivo webmsg.json é especificado. O valor de cada chave é outro objeto JSON em que são especificadas as opções de configuração do sistema de mensagens da Web. Os pedidos de entrada do sistema de mensagens da Web são determinados pelos mapeamentos do servlet especificado. Esses pedidos que chegam são processados com as opções de configuração especificadas. O exemplo a seguir é um snippet de um arquivo web.xml que contém o servlet WebMsgServlet e os mapeamentos de servlet associados:

<servlet>
     <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>/stockServlet</url-pattern>
</servlet-mapping>
      

No exemplo anterior, o servlet WebMsgServlet está mapeado para /stockServlet. Todo pedido de entrada do sistema de mensagens da Web mapeado para /stockServlet é processado com os parâmetros de configuração no exemplo anterior de webmsg.json. Nesse caso, os pedidos do sistema de mensagens da Web utilizam o barramento de integração de serviços; thebus, o espaço de tópico padrão Default.Topic.Space, o tempo limite de sondagem longa Bayeux é 30, e os clientes de sistema de mensagens da Web não podem publicar mensagens no servidor.

A maioria das configurações só precisa criar um servlet e a entrada de configuração webmsg.json relacionada. Há momentos em que várias definições devem ser criadas em um único módulo da Web. Os exemplos incluem a conexão com diferentes barramentos de integração de serviço, especificando um destino padrão diferente ou separando os clientes por tempo limite de sondagem longa Bayeux. Para separar os pedidos que chegam com base nos parâmetros de configuração, uma nova definição de servlet mapeada para com.ibm.websphere.webmsg.servlet.WebMsgServlet e um novo mapeamento de servlet devem ser criados. Por último, crie uma nova entrada no webmsg.json com os parâmetros de configuração desejados. Essa entrada deve ter uma chave mapeada para o servlet recém-criado.

Subseções de Configuração

As seguintes subseções descrevem detalhadamente todas as opções de configuração possíveis do sistema de mensagens da Web.



Termos de Uso | Feedback