Configurando Mapeamentos da Porta Preferida do Cliente de Serviço da Web Usando o Scrip wsadmin

Um tipo de porta de cliente pode ser configurado com portas que têm diferentes qualidades de serviço. É possível utilizar a opção de linha de comandos WebServicesClientBindPreferredPort para especificar qual porta deseja utilizar.

Antes de Iniciar

Se você ainda não implementou o arquivo EAR (Enterprise Archive), precisará que ele esteja pronto ou já implementado no servidor de aplicativos.

Sobre Esta Tarefa

Para cada tipo de porta que é configurado, uma ou mais portas estão disponíveis que implementam esse tipo de porta. Quando um cliente de serviço da Web chama um método getPort, o mapeamento da porta preferida determina qual porta usar. Essa determinação ocorre quando mais de uma porta pode satisfazer a chamada de método getPort, como em uma chamada getPort que especifica o tipo de porta mas não a porta. Por exemplo, suponha que o cliente de serviço da Web esteja configurado para usar o Sistema de Mensagens Java (JMS) e uma implementação HTTP. Durante a instalação ou o gerenciamento, você pode utilizar o comando WebServicesClientBindPreferredPort para configurar a porta preferida do aplicativo para utilizar o transporte escolhido.

Para configurar o mapeamento da porta preferida com a ferramenta wsadmin, prossiga com as seguintes etapas:

Procedimento

  1. Ative um comando de script. Para obter informações adicionais, consulte as informações sobre como iniciar o cliente de script wsadmin.
  2. Configure os mapeamentos da porta preferida do cliente de serviço da Web.

    Para utilizar a porta listener existente em vez de utilizar ou criar uma nova especificação de ativação, determine se a versão do EJB JAR é inferior a 2.1. O sistema cria e utiliza automaticamente uma especificação de ativação quando você especifica a opção -usedefaultbindings para implementar um aplicativo. Se uma especificação de ativação existir, o sistema ignorará a porta listener e utilizará a especificação de ativação. Para implementar um aplicativo com uma versão do EJB JAR maior ou igual a 2.1 usando portas listener definidas em vez de uma nova especificação de ativação, configure a propriedade do sistema com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting para true no arquivo wsadmin.properties no diretório de propriedades do perfil de interesse.

    Use as opções install, installInteractive, edit ou editInteractive para configurar os mapeamentos da porta preferida do cliente de serviço da Web, como demonstra a sintaxe a seguir:

    • Utilizando Jython:
      AdminApp.install('app_name', '[-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{module_name EJB_name Web_service port_type 
      port_name]')
    • Utilizando Jacl:
      $AdminApp install nome_do_aplic {-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{module_name EJB_name Web_service port_type 
      port_name}}
    O exemplo mostra múltiplos módulos e terminais da URL, porque é possível editar múltiplos fragmentos de URL, em que:
    • app_name é o nome do aplicativo, por exemplo, MultiEjbJar.ear
    • EJB_name é o nome do módulo de enterprise bean que não é um módulo da Web, por exemplo, Exchange
    • module_name é o nome do módulo, por exemplo, ejbclientonly.jar
    • Web_service é o nome do serviço da Web, por exemplo, service/StockQuoteService
    • port_type é a informação de tipo de porta, por exemplo, {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote
    • port_name é o nome da porta, por exemplo, {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote

Resultados

Você configurou os mapeamentos da porta do cliente de serviço da Web com a ferramenta wsadmin.

Exemplo

O exemplo a seguir inclui as informações do aplicativo, módulo, serviço da Web, tipo de porta e porta conforme são escritas na linha de comandos:
$AdminApp install MultiEjbJar.ear {-WebServicesClientBindPreferredPort {{ejbclientonly.jar 
Exchange service/StockQuoteService {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote
{http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote}...}}

As informações sobre o tipo de porta que orientam a criação dos dados da opção WebServicesClientBindPreferredPort residem no arquivo WSDL do cliente. Como os mapeamentos de porta preferida válidos são restritos às portas que implementam a interface do tipo de porta, a validação exige o tipo de implementação de cada porta. O arquivo WSDL do cliente deve ser acessado para determinar as informações sobre o tipo e a implementação.

O nome do arquivo WSDL do cliente está no atributo ServiceRef do descritor de implementação do cliente de serviço da Web. Dependendo do tipo e da versão do módulo, o descritor de implementação do cliente está localizado em um dos seguintes arquivos: application-client.xml, web.xml ou ejb-jar.xml. Se estiver utilizando o J2EE 1.3, as informações do descritor de implementação do cliente estarão localizadas no arquivo webservices.xml.

O que Fazer Depois

Agora é possível concluir quaisquer outras configurações, iniciar ou reiniciar o aplicativo e verificar o comportamento esperado do serviço da Web.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_preferredportwsadmin
Nome do arquivo: txml_preferredportwsadmin.html