Um listener de nó de extremidade é o ponto (endereço) no qual as mensagens para um serviço
de entrada são recebidas. Os listeners do terminal fornecidos
com o WebSphere Application Server suportam ligações
SOAP sobre HTTP e SOAP sobre JMS.
Sobre Esta Tarefa
Os listeners terminais são um terminal físico que recebe solicitações
de serviço de entrada. Um serviço de entrada descreve um destino do barramento como um serviço da web lógico. Uma porta de entrada associa um serviço de entrada
(lógico) a um listener terminal para fornecer um terminal (físico) em que o
serviço possa ser chamado. Portanto, você deverá ter
definido um listener terminal antes de poder criar uma porta de entrada.
Um pedido chega em um listener de nó de extremidade. Ele é transmitido para uma porta de entrada,
na qual a segurança do ponto e as listas de rotinas de tratamento JAX-RPC podem ser aplicadas, em seguida,
é enviado para o destino do serviço. As respostas seguem o mesmo caminho
no sentido inverso.
A configuração de um novo listener terminal para ser usado com um serviço de entrada é um processo de duas etapas:
- Configure o listener para um servidor de aplicativos ou cluster específico (conforme descrito nesta tarefa).
- Configure um serviço de entrada no mesmo barramento para usar o listener (conforme descrito
na tarefa Disponibilizando um Serviço Hospedado Internamente como um Serviço da Web).
Para utilizar o console administrativo para configurar um listener de nó de extremidade,
conclua as seguintes etapas:
Procedimento
- Inicie o administrative console.
- Na área de janela de navegação, clique em um dos seguintes caminhos:
É exibido o formulário de coleta de listeners de nó de extremidade.
- Clique em Nova. É exibido o assistente de Novo Listener
de Nó de Extremidade.
- Utilize o assistente para criar a nova configuração do listener
do terminal, concluindo as seguintes etapas. Para obter informações adicionais sobre as propriedades
configuradas com o assistente, consulte Listeners de terminal [Configurações]. Você talvez deseje usar o valores fornecidos em Valores de Exemplo para Configuração do Listener de Terminal.
- Selecione o nome do listener e o tipo de ligação.
- Nome do listener do terminal
- Digite o nome de sua escolha pelo qual o listener terminal é conhecido. Por exemplo: wsgwsoaphttp; wsgwsoaphttp2; SOAPJMSChannel1; SOAPJMSChannel2.
- Tipo de Ligação
- Selecione o tipo de ligação que este listener de nó de extremidade suporta.
Para um listener terminal SOAP sobre HTTP ou SOAP sobre HTTPS, selecione SOAP/HTTP ou SOAP/HTTPS.
Para o listener terminal SOAP sobre JMS selecione SOAP/JMS.
- Opcional: Defina as configurações do JMS.
Este painel
será exibido apenas se selecionar SOAP/JMS no painel anterior.
É possível escolher implementar o aplicativo do listener terminal para usar uma especificação de ativação ou uma porta do listener.
As portas listener estão estabilizadas. Para obter mais informações, leia o artigo sobre recursos estabilizados. Sempre que possível, escolha implementar o aplicativo do listener terminal para usar uma especificação de ativação.
É possível usar apenas especificações de ativação com o provedor de sistemas de mensagens padrão; ou usar especificações de ativação ou portas do listener com o provedor de sistemas de mensagens WebSphere MQ.
Selecione nas listas drop-down a porta listener ou a especificação de ativação e connection factory de
fila que você configurou anteriormente, conforme descrito em Configurando Recursos JMS para o SOAP Síncrono sobre o Listener do Nó de Extremidade JMS.
- Configure as URLs necessárias. Configure endereços da web para a raiz do aplicativo e a raiz de atendimento de WSDL. É possível selecionar
endereços pré-configurados com base nos hosts virtuais conhecidos ou criar novos valores.
- Raiz de URL
- Selecione ou digite o endereço no qual os clientes externos acessam o terminal do listener de terminal. A raiz da URL é a raiz de contexto do aplicativo listener terminal e fornece a raiz do endereço da Web que é utilizado para construir os endereços de terminal dentro de arquivos WSDL para direcionar solicitantes a esse listener terminal.
- Um servidor HTTP pode ser usado com um servidor de aplicativos independente.
Como alternativa, se o listener terminal for usado por clientes externos para acessar um cluster que fornece alta disponibilidade ou gerenciamento de carga de trabalho, o cluster normalmente usará um servidor HTTP configurado adequadamente (ou um servidor proxy do WebSphere) operando como um IP sprayer. Em qualquer um dos casos, se os clientes externos acessarem
o listener terminal por meio de um servidor HTTP ou cluster de servidores, usando a porta padrão 80, especifique o nome do servidor HTTP e não
o número de porta. Por exemplo (para o listener 1 do terminal SOAP sobre HTTP):
http://www.yourcompany.com/wsgwsoaphttp1
Para um
servidor de aplicativos independente, seu listener de terminal normalmente
é configurado para clientes que se conectam diretamente a um servidor de aplicativos
individual.
Se o listener terminal for usado por clientes externos para acessar um cluster, o listener poderá ser configurado para que os clientes se conectem diretamente a um servidor de aplicativos individual no cluster, conforme mostrado no exemplo a seguir, mas isso pode restringir os recursos de alta disponibilidade ou de gerenciamento de carga de trabalho do cluster. Entretanto, se permitir que clientes externos se conectem diretamente ao servidor de aplicativos (por exemplo, por ser um servidor independente ou por estar em um ambiente de desenvolvimento ou de teste), então especifique o nome do host e o número da porta do servidor de aplicativos. Por exemplo (para o listener 1 do terminal SOAP sobre HTTP):http://your.server.name:9080/wsgwsoaphttp1
em que o número
da porta (especificado como 9080 nesse exemplo) corresponde ao valor da porta WC_defaultHost para o servidor de aplicativos de interesse.
- WSDL que Atende a Raiz de URL HTTP
- Digite a raiz do endereço da web dos arquivos WSDL dos serviços de entrada que estão disponíveis nesse listener terminal. Este endereço é composto pela raiz do endereço HTTP no qual clientes externos acessam seu
aplicativo de listener terminal, seguido por /sibws. Isso
representa a URL que é usada quando publicar a URL do WSDL em um registro
UDDI.
O host e o nome da porta especificados para a raiz da URL HTTP
servidor do WSDL normalmente correspondem àqueles especificados para
a raiz da URL.
Se clientes externos acessarem o listerner do terminal através de um servidor HTTP ou cluster de servidores, normalmente usando a porta padrão 80, essa raiz de URL inclui o nome do servidor HTTP e nenhum número de porta. Por exemplo:
http://www.yourcompany.com/sibws
No entanto,
se você permitir que clientes externos conectem-se diretamente ao seu servidor de aplicativos
(por exemplo, em um ambiente de desenvolvimento ou de teste), esta raiz de URL incluirá
o nome do host e o número da porta do servidor de aplicativos. Exemplo:
http://your.server.name:9080/sibws
Nota: A raiz da URL HTTP que atende o WSDL só é usada internamente por outros componentes do WebSphere Application Server (principalmente o registro UDDI da IBM). Para todos os demais usuários, você acessa o arquivo WSDL por meio do nó de extremidade do listener de nó de extremidade para o serviço de entrada. Para obter os detalhes do local para um determinado arquivo WSDL do serviço de entrada, publique o arquivo WSDL em um arquivo compactado conforme descrito em Modificando uma Configuração de Serviços de Entrada Existente, em seguida, consulte o local dentro do arquivo WSDL exportado.
- Selecione os barramentos de integração de serviços aos quais o novo listener terminal deve ser conectado. Apenas os barramentos dos quais o servidor de aplicativos ou cluster é membro estarão disponíveis para seleção.
- Clique em Terminar.
Resultados
Se o processamento for concluído com êxito; a lista de listeners
do terminal será atualizada para incluir o novo listener do terminal. Caso contrário, uma mensagem de erro é exibida.
O que Fazer Depois
Agora você está pronto para selecionar este listener do terminal para utilização com um
serviço de entrada, conforme descrito em
Disponibilizando um Serviço Hospedado Internamente como um Serviço da Web.