Comando Java2WSDL para Aplicativos JAX-RPC

A ferramenta de linha de comandos Java2WSDL mapeia classes Java™ para um arquivo WSDL para aplicativos JAX-RPC (Java API for XML-based RPC).

[z/OS]A ferramenta de linha de comandos Java2WSDL não é suportada na plataformaz/OS. Esta funcionalidade é fornecida pelas ferramentas de montagem fornecidas com a versão z/OS do produto.

O comando Java2WSDL mapeia uma classe Java para um arquivo WSDL (Web Services Description Language) ao seguir a especificação JAX-RPC (Java API for XML-based Remote Procedure Call) 1.1.

O comando Java2WSDL aceita uma classe Java como entrada e produz um arquivo WSDL que representa a classe de entrada. Se existir um arquivo no local de saída, ele será sobrescrito. O arquivo WSDL que é gerado pelo comando Java2WSDL contém construções de esquema WSDL e XML que são automaticamente derivadas da classe de entrada. É possível substituir esses valores padrão por argumentos da linha de comandos.

O comando Java2WSDL é independente de protocolo; ao executar o comando Java2WSDL, você pode especificar opções de linha de comandos que geram ligações de protocolo SOAP e não SOAP no arquivo WSDL. Para cada ligação que pode ser gerada, o comando Java2WSDL possui um gerador de ligação para gerar o WSDL para essa ligação.

Sintaxe e Argumentos da Linha de Comandos

A sintaxe da linha de comandos é:
Java2WSDL [argument...] class

os seguintes argumentos de linha de comandos são suportados:

Argumentos Obrigatórios

  • Classe
    Representa o nome completo de uma das classes Java:
    • Interface remota EJB (JavaBeans) de sessão sem estado que estende a classe javax.ejb.EJBObject
    • Interface de nó de extremidade de serviço que estende a classe java.rmi.Remote
    • Beans Java
    O comando Java2WSDL localiza a classe na variável CLASSPATH.

Argumentos Importantes

  • -location location

    Fornece o local publicado da URL (Localizador Uniforme de Recursos) do serviço. Se essas informações não forem fornecidas, um aviso será emitido indicando que o local publicado final ainda não está determinado. O local de serviço é normalmente substituído quando o serviço da Web for implementado.

    O nome depois da última barra invertida é o nome da porta de serviço, a menos que o nome seja substituído pelo argumento -servicePortName. O valor especificado é atribuído ao atributo da localização do endereço da porta do serviço. Vários endereços de nó de extremidade podem ser especificados. É recomendável usar a opção -location apenas se um único tipo de ligação for necessário. Se forem solicitados vários tipos de ligação, as propriedades de local específicas da ligação de protocolo serão transmitidas sobre a linha de comandos que utiliza o sinalizador -x.

    [AIX Solaris HP-UX Linux Windows][z/OS]O exemplo a seguir ilustra como produzir ligações SOAP em HTTP e SOAP em JMS (Java Message Service) :
    java2wsdl -bindingTypes http, jms \
    		-x http.location=http://your.server.name:9080/StockQuoteService/services/StockQuote \
    		-x jms.location= \
    	jms:/queue?destination=jms/MyQueue&connectionFactory=jms/MyCF&targetService=StockQuote	
    Utilize a opção -location para determinar a qual porta o valor da opção -location se aplica, exigindo que as URLs dos terminais sejam especificadas por meio dos valores de propriedades específicos da ligação.
  • -output wsdl-uri

    Indica o caminho e o nome do arquivo WSDL de saída. Se não for especificado, o arquivo class.wsdl padrão será gravado no diretório atual.

  • -input wsdl-uri

    Especifica o arquivo WSDL de entrada utilizado para construir um arquivo WSDL de saída. As informações de um arquivo WSDL existente são especificadas nesta opção e são utilizadas com a classe Java de entrada para gerar a saída.

  • -bindingTypes
    Especifica que a lista de tipos de ligações é gravada no arquivo WSDL de saída. Cada gerador de ligação no comando Java2WSDL suporta tipos de ligação específicos. Os valores de tipo de ligação válidos são http (SOAP sobre HTTP), jms (SOAP sobre JMS) e ejb (chamada EJB local ou remota). Por exemplo, o comando a seguir pode ser utilizado para gerar ligações SOAP sobre HTTP, EJB para a Service Endpoint Interface my.pkg.MySEI e para a classe de implementação my.pkg.MyEJBClass:
    java2wsdl -bindingTypes http, ejb -implClass my.pkg.MyEJBClass my.pkg.MySEI
    O seguinte comando é um exemplo de uso da opção -bindingTypes para gerar ligações SOAP sobre HTTP e SOAP sobre JMS:
    java2wsdl -bindingTypes http, jms -implClass my.pkg.MyEJBClass my.pkg.MySEI
  • -style RPC | DOCUMENT

    Especifica o estilo WSDL a ser utilizado no arquivo WSDL gerado. Para obter informações adicionais, consulte informações sobre Mapeando entre a linguagem Java, WSDL e XML para aplicativos JAX-RPC. Esse argumento é utilizado com o argumento -use.

    Se RPC for especificado com -use ENCODED, um arquivo WSDL style=rpc/use=encoded será gerado. Se RPC for especificado com a opção -use LITERAL, um arquivo WSDL style=rpc/use=literal será gerado. Se DOCUMENT for especificado com a opção -use LITERAL, um arquivo WSDL style=document/use=literal será gerado.

  • -use LITERAL | ENCODED

    Especifica quais combinações de estilo e utilização são geradas no arquivo WSDL quando utilizado com o argumento -style. As combinações são rpc e encoded, rpc e literal, ou doc e literal. Essa definição aplica-se a todas as ligações SOAP. Para obter informações adicionais, consulte informações sobre Mapeando entre a linguagem Java, WSDL e XML para aplicativos JAX-RPC.

  • -transport http | jms

    Gera ligações SOAP para HTTP (padrão) ou JMS. Se JMS for especificado, os caracteres jms serão anexados ao nome do arquivo WSDL para impedir que um arquivo WSDL existente seja sobrescrito para outro transporte. A opção de transporte pode ser especificada apenas uma vez.

    Esta opção não é recomendada. A opção -bindingTypes substitui a opção -transport, para que você possa gerar ligações que não sejam específicas de SOAP.

  • -portTypeName name

    Especifica o nome a ser utilizado para o elemento portType. Se não for especificado, o nome da ligação será o nome do tipo de porta.

  • -bindingName name

    Especifica o nome a ser utilizado para o elemento de ligação. Se não for especificado, o nome da ligação será o nome do tipo de porta.

  • -serviceElementName name

    Especifica o nome do elemento de serviço.

  • -servicePortName name

    Especifica o nome do serviço. Se não especificado, o nome do serviço será derivado do argumento -location.

  • -namespace targetNamespace

    Indica o espaço de nomes de destino para o arquivo WSDL sendo gerado. Para obter informações adicionais sobre o algoritmo usado para obter o espaço de nomes padrão, consulte informações sobre Mapeando entre a linguagem Java, WSDL e XML para aplicativos JAX-RPC.

  • -PkgtoNS package namespace

    Especifica o mapeamento de um pacote Java para um espaço de nomes. Se um pacote não tiver um espaço de nomes, o comando Java2WSDL gerará um nome de espaço de nomes. É possível repetir o argumento -PkgtoNS para especificar mapeamentos para vários pacotes.

  • -extraClasses classes

    Especifica outras classes que são representadas no arquivo WSDL.

  • -implClass impl-class

    O comando Java2WSDL utiliza nomes do parâmetro method para construir os nomes das partes da mensagem do arquivo WSDL. O comando obtém automaticamente os nomes de mensagens das informações de depuração na classe. Se a classe for compilada sem informações de depuração ou se a classe for uma interface, os nomes dos parâmetros method não estarão disponíveis. Nesse caso, você pode usar o argumento -implClass para fornecer uma classe alternativa a partir da qual obter os nomes dos parâmetros method. O impl-class não precisa implementar a classe se ela for uma interface, mas deve implementar os mesmos métodos como a classe.

  • -verbose

    Exibe mensagens com verbose.

  • -help

    Exibe a mensagem de ajuda.

  • -helpX

    Exibe a mensagem de ajuda para opções estendidas e para várias opções que são suportadas por geradores de ligações.

Outros Argumentos

  • -wrapped boolean

    Especifica se o arquivo WSDL deve ser gerado de acordo com as regras agrupadas. Essa opção é válida se use for apenas literal. O valor padrão da opção é true.

  • -stopClasses parent [, parent]

    O comando Java2WSDL procura classes e interfaces herdadas para construir a lista de métodos para as operações do arquivo WSDL se o argumento -all for especificado.

    O comando Java2WSDL pesquisa as classes e interfaces herdadas ao gerar complexTypes estendidos. A procura pára quando uma classe ou uma interface é localizada em um pacote que começa com java ou javax. É possível usar o argumento -stopClasses para definir classes adicionais que fazem com que a procura pare.

  • -methods argument

    Especifica uma lista de nomes de métodos da Service Endpoint Interface que devem ser expostos no arquivo WSDL de saída. A lista é separada por espaços ou vírgulas.

  • -soapAction
    Os argumentos válidos são:
    • DEFAULT

      Define o campo soapAction de acordo com informações de implementação.

    • NENHUM

      Define o campo soapAction com aspas duplas ("").

    • OPERATION

      Define o campo soapAction com o nome da operação.

  • -outputImpl impl-wsdl

    Especifica se você deseja um arquivo WSDL de interface e implementação emitido.

  • -locationImport location-uri

    Especifica a localização do arquivo WSDL da interface se você usar o argumento -outputImpl.

  • -namespaceImpl namespace

    Especifica o espaço de nomes de destino para o arquivo WSDL de implementação, se você usar o argumento -outputImpl.

  • -MIMEStyle <style>

    Especifica o tipo MIME (Multipurpose Internet Mail Extensions) utilizado para mapear para o WS-I (Web Services-Interoperability) SOAP com referência de anexos (wsi:swaRef) do elemento de ligação.

    <style> pode ser um dos seguintes:
    • WSDL11 (padrão): Mapeia exclusivamente tipos MIME utilizando padrões WSDL 1.1. Se o tipo MIME não puder ser mapeado para padrões WSDL 1.1, o comando falhará.
    • AXIS: Mapeia tipos MIME utilizando padrões AXIS, por exemplo, a imagem torna-se axis:image.
    • swaRef: Mapeia tipos MIME utilizando padrões WSDL 1.1 com dois avisos:
      • O DataHandler mapeia para o elemento wsi:swaRef ao invés de mapear para um aplicativo e fluxo de octeto
      • Se o mapeamento for inválido por meio do WSDL 1.1, mapeie para o elemento wsi:swaRef
  • -propertiesFile argument
    Define opções existentes, como -extraClasses, com um arquivo de propriedades ao invés de fazê-lo com uma linha de comandos. O exemplo a seguir ilustra o uso desse argumento:
    extraClasses=com.ibm.Class1, com.sun.Class2,org.apache.Class3
  • -voidReturn
    Os argumentos válidos são:
    • ONEWAY

      Métodos com retornos nulos são unidirecionais. Esse argumento é o padrão para um transporte JMS.

    • TWOWAY

      Métodos com retornos nulos são bidirecionais. Esse argumento é o padrão para um transporte HTTP.

  • -debug

    Exibe as mensagens de depuração.

  • -property ou -x
    É possível usar a opção -x para transmitir opções de linha de comandos a diversos geradores de ligação. Utilize a opção -x várias vezes na linha de comandos para especificar um conjunto de valores de propriedades para transmitir a cada método gerador de ligação chamado pelo comando Java2WSDL. Você também pode usar uma única opção -x para especificar as várias propriedades, separando-as com uma vírgula, por exemplo:
    java2wsdl -x prop1=value1 -x prop2=value2
    é equivalente a:
    java2wsdl -x prop1=value1,prop2=value2
    A opção -x fornece a flexibilidade para especificar cada opção de linha de comandos para cada gerador de ligação individualmente, se necessário. O valor especificado na opção -x substitui o valor que é especificado na opção de linha de comandos equivalente se ambos forem especificados.

Ícone que indica o tipo de tópico Tópico de Referência



Í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=rwbs_java2wsdl
Nome do arquivo: rwbs_java2wsdl.html