Trabalhando com arquivo de propriedades de fragmento de URL do terminal da Web em serviço

É possível usar arquivos de propriedade para gerenciar ou alterar fragmentos de URL de terminal para serviços da Web acessados por HTTP, SOAP e Sistema de Mensagens Java™ (JMS) ou diretamente como enterprise beans. Os fragmentos de URL são usados para formar endereços completos de terminal de serviços da Web incluídos nos arquivos Web Services Description Language (WSDL).

Antes de Iniciar

Os fragmentos de URL são metadados opcionais para aplicativos de serviços da Web. É possível usar o console administrativo ou os arquivos de propriedades para configurar e gerenciar os fragmentos de URL. Antes que seja possível consultar os fragmentos de URL, você deve primeiro configurá-los usando o console administrativo ou o comando applyConfigProperties. Depois de configurar inicialmente os fragmentos de URL usando o console administrativo ou os arquivos de propriedades, será possível modificar o fragmento de URL de terminal de serviços da Web usando os arquivos de propriedades ou o console administrativo.

Para aprender sobre o uso do console administrativo para configurar os fragmentos de URL, consulte as informações sobre configuração de URL de terminal para ligações HTTP ou as informações de configuração de URL de terminal para ligações JMS.

Sobre Esta Tarefa

A Versão 8.0 e posterior suporta o uso de arquivos de propriedades para gerenciar fragmentos de URL do terminar para serviços da web acessados por meio de HTTP, SOAP e Java Message Service (JMS) ou diretamente como enterprise beans.

É possível especificar uma parte da URL de terminal para usar em cada módulo de serviço da Web. A parte especificada será usada para criar a URL de terminal real ao publicar um arquivo WSDL. Em um arquivo WSDL publicado, a URL que define o endereço do terminal de destino está localizada no atributo do local do elemento soap:address da porta. Esta página aplica-se a ambos os serviços da Web Java API for XML-Based Web Services (JAX-WS) e Java API for XML-based RPC (JAX-RPC).

As propriedades do fragmento da URL de terminal de serviço da Web são extensões para o arquivo de propriedade do aplicativo. Ao usar o comando extractConfigProperties para obter um arquivo de propriedades para um aplicativo, também serão obtidos os fragmentos de URL de terminal junto com outras propriedades do aplicativo. Use os comandos applyConfigProperties, validateConfigProperties e deleteConfigProperties; conforme descrito no procedimento, para atualizar, validar e excluir os fragmentos de URL de terminal em um aplicativo de serviço da Web.

Procedimento

  1. Extraia o arquivo de propriedades.
    Por exemplo, para extrair as propriedades para o aplicativo, sampleApplication, use o comando extractConfigProperties.
    AdminTask.extractConfigProperties(['-propertiesFileName', 'myProperties.props', '-configData', 'Deployment=sampleApplication' ])
    Se os fragmentos de URL de terminal de serviços da Web foram configurados previamente, o sistema extrairá os arquivos de propriedades e o resultado conterá uma seção para os fragmentos de URL de terminal, como exibe o exemplo a seguir:
    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Propriedades
    http=http://myhostname:80
    module=TestApp.jar
  2. Crie uma nova instância do arquivo de propriedades.
    Se você modificar as propriedades existentes do fragmento de URL ou criar novas propriedades, use o seguinte comando para aplicar as propriedades do fragmento de URL. Este comando cria ou atualiza o arquivo de metadados correspondente no aplicativo especificado. Neste exemplo, o parâmetro -reportFileName opcional é usado para especificar a produção de um relatório a partir do comando.
    AdminTask.applyConfigProperties('[-propertiesFileName myProperties.props -reportFileName report.txt ]')
  3. Valide o arquivo de propriedades.
    O comando validateConfigProperties valida os nomes e valores da propriedade no arquivo de propriedades. Se todos os nomes e valores forem válidos, o resultante do comando é verdade. Caso contrário, o comando retorna um valor falso; por exemplo:
    AdminTask.validateConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName', 
    'report.txt']) 
  4. Exclua o arquivo de propriedades.

    Quando um comando deleteConfigProperties é chamado, ele exclui todas as propriedades que estão especificadas no arquivo de propriedades. Se estiver iniciando com um arquivo de propriedades extraído anteriormente, remova todas as seções no arquivo de propriedades, exceto as seções nas quais deseja aplicar o comando deleteConfigProperties. Por exemplo, se deseja excluir um Mapa de Prefixo de URL, remova todas as seções do arquivo de propriedades extraído exceto a seção de mapa URLPrefix e possivelmente a seção de variáveis de ambiente, se estiver usando variáveis.

    O comando deleteConfigProperties exclui as propriedades especificadas no arquivo de propriedades; por exemplo:
    AdminTask.deleteConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
     'report.txt']) 

    O arquivo myProperties.txt a seguir é um exemplo de um arquivo de propriedades que pode ser usado para executar uma exclusão do mapa de Prefixo da URL http para o módulo TestApp.jar:

    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Propriedades
    http=http://myhostname:80
    module=TestApp.jar
    
    #
    #
    EnvironmentVariablesSection
    #
    #
    #Variáveis de Ambiente
    applicationName=TestApp
    cellName=XYZNode01Cell
    serverName=server1
    nodeName=XYZNode01

Resultados

É possível usar os arquivos de propriedades de serviço da Web para consultar, configurar e gerenciar os fragmentos de URL de terminal de serviço da Web para diferentes protocolos.


Í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_wbs_endptURL_prop
Nome do arquivo: txml_wbs_endptURL_prop.html