Crie um serviço de saída. Um serviço de saída fornece acesso, por meio
de uma ou mais portas de saída, para um serviço da Web que é hospedado
externamente. Um serviço de saída pode ser utilizado
por qualquer um de seus sistemas internos que podem acessar o barramento de integração
de serviço no qual ele está hospedado. Para disponibilizar um serviço hospedado externamente por meio de um barramento,
primeiro, associe-o a um destino de serviço, em seguida, configure um ou mais destinos de porta (um para cada tipo de
ligação, por exemplo, SOAP sobre HTTP ou SOAP sobre JMS) por meio do qual os pedidos e respostas de serviço
são transmitidos para o serviço externo. Você
obtém as definições de porta do WSDL, mas pode escolher quais deseja
criar.
Antes de Iniciar
Este tópico assume que você criou e instalou um repositório Service Data Objects (SDO) (usado para armazenar e atender as definições WSDL) em cada independente que executará uma finção de serviços da web do barramento de integração de serviços.
Para criar um serviço de saída, você deve conhecer o local do arquivo WSDL publicado externamente, que descreve o serviço. Esse arquivo WSDL está disponível em um endereço da web ou através de um registro de UDDI.
Se o arquivo WSDL para seu serviço
de saída estiver armazenado em um registro do UDDI, associe o serviço de saída
a uma referência de UDDI ao registro. Você seleciona a referência de UDDI de uma lista suspensa, portanto é necessário configurar a referência de UDDI antes de configurar um novo serviço de saída que o use.
Decida que método usar para configurar esses recursos. É possível criar um serviço de saída utilizando o console administrativo conforme descrito
nesta tarefa ou utilizando o
createSIBWSOutboundService command.
Nota: Se o barramento precisar transmitir mensagens através
de um servidor proxy de autenticação para recuperar documentos WSDL, você não poderá
utilizar o console administrativo para esta tarefa e deverá criar o novo
serviço de saída utilizando a ferramenta wsadmin. Para obter informações adicionais, consulte
a dica de resolução de problemas correspondente.
Sobre Esta Tarefa
Na seguinte figura, cada mensagem é transmitida a partir do serviço de saída
para o serviço de destino por meio de uma porta de saída. É criada uma porta de saída separada para cada ligação disponível. Os manipuladores JAX-RPC e as configurações WS-Security
podem ser aplicados nas portas.
Figura 1. Serviço de Saída
Os pedidos e respostas para um serviço de saída
são enviados por meio de qualquer ligação de transporte (por exemplo, SOAP sobre HTTP, SOAP sobre
JMS, ligação EJB) que esteja disponível para o serviço de destino e o barramento
de integração de serviço. Cada tipo de ligação disponível é representado por uma porta
de saída configurada em um destino de porta. Para obter informações adicionais, consulte Portas de Saída e Destinos de Portas.
É possível
controlar e monitorar o acesso ao serviço de destino das seguintes formas:
- É possível associar as listas de rotinas de
tratamento JAX-RPC às portas, para que as rotinas de tratamento possam
monitorar a atividade na porta e executar a ação adequada dependendo do
emissor e do conteúdo de cada mensagem transmitida pela porta.
- É possível definir o nível de segurança a ser aplicado a mensagens (a ligação do WS-Security). O nível de segurança pode ser definido de maneira independente para mensagens
de pedido e resposta.
Procedimento
- Inicie o administrative console.
- Na área de janela de navegação, clique em . É exibido o formulário
de coleta de serviços de saída.
- Clique em Nova. É exibido o Assistente
de Novo Serviço de Saída.
- Utilize o assistente para criar a nova configuração do serviço de saída,
concluindo as seguintes etapas. Para obter informações adicionais sobre as propriedades
configuradas com o assistente, consulte Configurações de
Serviços de Saída e Configurações
de Portas de Saída.
- Localize o WSDL do serviço de destino.
- Selecione o serviço a partir do WSDL.
Nota: - Esta opção será necessária no caso de haver mais de um serviço no WSDL. O campo é preenchido por padrão. Se houver apenas um serviço no WSDL, aceite o padrão.
- É necessário ter, pelo menos, uma porta definida no serviço selecionado.
- Selecione as portas que devem ser ativadas para este serviço.
Nota: Selecione pelo menos uma porta.
- Nomeie o serviço de saída, o destino do serviço e todos os destinos de porta.
Nota: - Os nomes padrão são gerados, mas é possível renomeá-los. Os nomes padrão são exclusivos dentro do barramento de integração de serviço atual. Todos os nomes de substituição que você escolher devem ser similarmente exclusivos. Se você digitar um nome que não é exclusivo, uma mensagem de erro será exibida.
- Se você tiver criado uma mediação de seleção de porta e implementado-a no barramento de integração de serviço, ela ficará disponível para seleção na lista de mediações. Se não desejar usar uma mediação de seleção de porta com esse serviço de saída, selecione nenhum na lista suspensa. Essa lista contém todas as mediações, incluindo mediações de seleção de porta, que estão atualmente implementadas para esse barramento de integração de serviço.
- A lista de portas disponíveis é um subconjunto de portas que estão descritas no arquivo WSDL. Você escolheu esse subconjunto na etapa anterior. Se você tiver selecionado mais de uma porta na etapa anterior, deverá definir também a porta padrão a ser utilizada a menos que ela seja especificada por uma mediação de seleção de porta.
- Atribua cada destino de porta e (opcionalmente) a mediação de seleção de
porta para um membro do barramento.
Nota: - Os membros do barramento são servidores de aplicativos ou clusters que são incluídos neste barramento.
- A opção para designar uma mediação de seleção de porta para um membro do barramento será exibida apenas se você tiver selecionado uma mediação na etapa anterior.
- Clique em Terminar.
Resultados
Se o processamento for concluído com êxito, a lista de serviços de saída para este barramento de integração de serviço será atualizada para incluir o novo serviço de saída. Caso contrário, uma mensagem de erro é exibida.
O que Fazer Depois
Como o serviço é hospedado externamente, também pode ser necessário
ativar
a autenticação do servidor proxy para cada porta para obter permissão para acessar
a Internet.
Se você desejar proteger o novo serviço de saída ou aplicar quaisquer
listas de rotinas de tratamento JAX-RPC às portas ou ativar a autenticação do servidor proxy para qualquer uma das portas,
utilize o console administrativo para modificar a configuração do serviço de saída.