Commande Java2WSDL destinée aux applications JAX-RPC

L'outil de ligne de commande Java2WSDL mappe les classes Java™ vers un fichier WSDL pour les applications JAX-RPC (Java API for XML-based RPC).

[z/OS]L'outil de ligne de commande Java2WSDL n'est pas pris en charge sur la plateforme z/OS. Cette fonctionnalité est fournie par les outils d'assemblage fournis avec la version z/OS du produit.

La commande Java2WSDL mappe une classe Java vers un fichier WSDL (Web Services Description Language) en suivant l'API Java pour la spécification JAX-RPC 1.1 (Java API for XML-based Remote Procedure Call).

La commande Java2WSDL accepte une classe Java comme entrée et génère un fichier WSDL représentant la classe d'entrée. Si un fichier existant se trouve dans l'emplacement de sortie, il est remplacé. Le fichier WSDL généré par la commande Java2WSDL contient des constructions de schéma WSDL et XML qui sont dérivées automatiquement de la classe d'entrée. Vous pouvez remplacer ces valeurs par défaut par des arguments de ligne de commande.

La commande Java2WSDL est indépendante de tout protocole. Lorsque vous l'exécutez, vous pouvez spécifier des options de ligne de commande qui génèrent des liaisons SOAP et non SOAP dans le fichier WSDL. La commande Java2WSDL est associée à un générateur de liaisons pour générer le fichier WSDL correspondant à chaque liaison qui peut être générée.

Syntaxe et arguments de ligne de commande

La syntaxe de ligne de commande est la suivante :
Java2WSDL [argument...] classe

Les arguments de ligne de commande suivants sont pris en charge :

Arguments requis

  • class
    Représente le nom qualifié complet d'une des classes Java suivantes :
    • Interface distante de la session EJB (Enterprise JavaBeans) sans état qui étend la classe javax.ejb.EJBObject
    • Interface SEI qui étend la classe java.rmi.Remote
    • Beans Java
    La commande Java2WSDL recherche la classe dans CLASSPATH.

Arguments importants

  • -location emplacement

    Indique l'emplacement publié ou l'URL (Uniform Resource Locator) du service. Si cette information n'est pas indiquée, un message d'avertissement indique que l'emplacement publié final n'est pas encore déterminé. L'emplacement du service est en général remplacé lors du déploiement du service Web.

    Le nom figurant après la dernière barre oblique inversée est celui du port de service, à moins que ce nom ne soit remplacé par l'argument -servicePortName. La valeur spécifiée est affectée à l'attribut de l'emplacement de l'adresse du port de service. Vous pouvez spécifier plusieurs adresses de point final. Utilisez l'option -location uniquement si un seul type de liaison est nécessaire. Si plusieurs types de liaison sont requis, les propriétés liées à l'emplacement propre à chaque liaison sont transmises à l'aide de l'option -x définie sur la ligne de commande.

    [AIX Solaris HP-UX Linux Windows][z/OS]L'exemple suivant illustre comment générer des liaisons SOAP sur HTTP et SOAP sur 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	
    Utilisez l'option -location pour déterminer le port auquel s'applique la valeur de cette option. Les adresses URL de noeud final doivent être spécifiées à l'aide des valeurs des propriétés propres à chaque liaison.
  • -output wsdl-uri

    Indique le chemin d'accès et le nom du fichier WSDL de sortie. Si cet argument n'est pas spécifié, le fichier par défaut, class.wsdl, est écrit dans le répertoire en cours.

  • -input wsdl-uri

    Indique le fichier WSDL d'entrée utilisé pour construire un fichier WSDL de sortie. Les informations émanant d'un fichier WSDL existant, dont le nom est spécifié dans cette option, sont utilisées avec la classe Java d'entrée pour générer la sortie.

  • -bindingTypes
    Spécifie la liste des types de liaison devant figurer dans le fichier WSDL de sortie. Chaque générateur de liaisons de la commande Java2WSDL prend en charge des types de liaison particuliers. Les types de liaison admis sont http (SOAP sur HTTP), jms (SOAP sur JMS) et ejb (appel EJB local ou distant). Par exemple, la commande suivante permet de générer des liaisons EJB SOAP sur HTTP pour l'interface SEI (Service Endpoint Interface) my.pkg.MySEI et la classe d'implémentation my.pkg.MyEJBClass :
    java2wsdl -bindingTypes http, ejb -implClass my.pkg.MyEJBClass my.pkg.MySEI
    La commande suivante est un exemple d'utilisation de l'option -bindingTypes pour la génération de liaisons SOAP sur HTTP et SOAP sur JMS :
    java2wsdl -bindingTypes http, jms -implClass my.pkg.MyEJBClass my.pkg.MySEI
  • -style RPC | DOCUMENT

    Indique le style WSDL à utiliser dans le fichier WSDL généré. Pour obtenir plus d'informations, voir les informations relatives au mappage entre le langage Java, WSDL et XML pour les JAX-RPC. Cet argument est utilisé avec l'argument -use.

    Si RPC est spécifié avec -use ENCODED, un fichier WSDL style=rpc/use=encoded est généré. Si RPC est spécifié avec l'option -use LITERAL, un fichier WSDL style=rpc/use=literal est généré. Si DOCUMENT est spécifié avec l'option -use LITERAL, un fichier WSDL style=document/use=literal est généré.

  • -use LITERAL | ENCODED

    Indique quelles combinaisons de style et d'utilisation sont générées dans le fichier WSDL lorsqu'il est utilisé avec l'argument -style. Les combinaisons sont rpc et encoded, rpc et literal, ou doc et literal. Ce paramètre s'applique à toutes les liaisons SOAP. Pour obtenir plus d'informations, voir les informations relatives au mappage entre le langage Java, WSDL et XML pour les JAX-RPC.

  • -transport http | jms

    Génère des liaisons SOAP pour HTTP (par défaut) ou JMS. Si JMS est spécifié, les caractères jms sont ajoutés au nom du fichier WSDL pour empêcher le remplacement d'un fichier WSDL existant pour un autre transport. L'option transport ne peut être spécifiée qu'une seule fois.

    Cette option est toutefois obsolète. L'option -bindingTypes remplace l'option -transport et permet de générer des liaisons qui ne sont pas spécifiques du protocole SOAP.

  • -portTypeName nom

    Indique le nom à utiliser pour l'élément portType. S'il n'est pas spécifié, le nom de liaison correspond au nom du type de port.

  • -bindingName nom

    Indique le nom à utiliser pour l'élément de liaison. S'il n'est pas spécifié, le nom de liaison correspond au nom du type de port.

  • -serviceElementName nom

    Indique le nom de l'élément service.

  • -servicePortName nom

    Indique le nom du service. S'il n'est pas spécifié, le nom du service est dérivé de l'argument -location.

  • -namespace EspaceNomCible

    Indique l'espace de nom cible pour le fichier WSDL en cours de génération. Pour plus de détails sur l'algorithme utilisé pour obtenir l'espace de nom par défaut, voir les informations relatives au mappage entre le langage Java, WSDL et XML pour les applications JAX-RPC.

  • -PkgtoNS espace de nom du package

    Indique le mappage d'un package Java vers un espace de nom. Si aucun espace de nom n'est associé au package, la commande Java2WSDL génère un nom d'espace de nom. Cet argument peut être répété pour spécifier des mappages vers plusieurs packages.

  • -extraClasses classes

    Spécifie d'autres classes qui sont représentées dans le fichier WSDL.

  • -implClass impl-class

    La commande Java2WSDL utilise les noms de paramètres de méthode pour construire les noms des parties de message du fichier WSDL. La commande obtient automatiquement les noms de message à partir des informations de débogage de la classe. Si la classe a été compilée sans informations de débogage, ou si la classe est une interface, les noms de paramètres de méthode ne sont pas disponibles. Dans ce cas, vous pouvez utiliser l'argument -implClass pour fournir une autre classe à partir de laquelle vous pourrez obtenir des noms de paramètres de méthode. La classe impl-class n'a pas besoin d'implémenter cette autre classe si celle-ci est une interface, mais elle doit implémenter les mêmes méthodes qu'elle.

  • -verbose

    Affiche des messages verbose.

  • -help

    Affiche le message d'aide.

  • -helpX

    Affiche le message d'aide pour les options étendues et pour différentes options prises en charge par des générateurs de liaisons.

Autres arguments

  • -wrapped booléen

    Indique si le fichier WSDL doit être généré en fonction des règles encapsulées. Cette option n'est valide que si l'utilisation (use) est littérale. La valeur par défaut de l'option est true.

  • -stopClasses parent [, parent]

    La commande Java2WSDL recherche des classes héritées et des interfaces pour construire la liste des méthodes pour des opérations de fichier WSDL si l'argument -all est spécifié.

    La commande Java2WSDL recherche les classes et les interfaces héritées lors de la génération d'éléments complexTypes étendus. La recherche s'arrête lorsqu'une classe ou une interface est trouvée dans un package commençant par java ou javax. L'argument -stopClasses peut être utilisé pour définir des classes supplémentaires entraînant l'arrêt de la recherche.

  • -methods argument

    Indique la liste des noms de méthodes de l'interface SEI qui doivent être exposées dans le fichier WSDL de sortie. Ces noms sont séparés par des espaces ou des virgules.

  • -soapAction
    Les arguments valides sont les suivants :
    • DEFAULT

      Définit la zone soapAction en fonction des informations de déploiement.

    • NONE

      Définit la zone soapAction à "".

    • OPERATION

      Définit la zone soapAction par le nom de l'opération.

  • -outputImpl impl-wsdl

    Indique si vous voulez émettre une interface et un fichier WSDL d'implémentation.

  • -locationImport location-uri

    Indique l'emplacement du fichier WSDL d'interface si vous utilisez l'argument -outputImpl.

  • -namespaceImpl espace_nom

    Indique l'espace de nom cible du fichier WSDL d'implémentation, si vous utilisez l'argument -outputImpl.

  • -MIMEStyle <style>

    Définit le type MIME (Multipurpose Internet Mail Extensions) pour mapper l'élément de liaison vers wsi:swaRef (Web Services-Interoperability (WS-I) SOAP with attachments reference).

    <style> peut avoir l'une des valeurs suivantes :
    • WSDL11 (valeur par défaut) : Mappe exclusivement des types MIME vers des normes WSDL 1.1. Si le type MIME ne peut pas être mappé vers des normes WSDL 1.1, la commande échoue.
    • AXIS : Mappe les types MIME vers des normes AXIS. Par exemple, image devient axis:image.
    • swaRef : Mappe les types MIME vers des normes WSDL 1.1 avec les restrictions suivantes :
      • DataHandler devient l'élément wsi:swaRef au lieu d'une application et un flux d'octets.
      • Si le mappage est illégal via WSDL 1.1, mappez vers l'élément wsi:swaRef.
  • -propertiesFile argument
    Définit des options existantes, comme -extraClasses, avec un fichier de propriétés en remplacement d'une ligne de commande. L'exemple suivant illustre l'utilisation de cet argument :
    extraClasses=com.ibm.Class1, com.sun.Class2,org.apache.Class3
  • -voidReturn
    Les arguments valides sont les suivants :
    • ONEWAY

      Les méthodes qui ne renvoient rien sont unidirectionnelles. Il s'agit de la valeur par défaut pour un transport JMS.

    • TWOWAY

      Les méthodes qui ne renvoient rien sont bidirectionnelles. Il s'agit de la valeur par défaut pour un transport HTTP.

  • -debug

    Affiche des messages de débogage.

  • -property ou -x
    Vous pouvez utiliser l'option -x pour transmettre des options de ligne de commande à divers générateurs de liaisons. Utilisez l'option -x plusieurs fois sur la ligne de commande pour spécifier un ensemble de valeurs de propriété à transmettre à chaque méthode de générateur de liaisons appelée par la commande Java2WSDL. Vous pouvez aussi utiliser l'option -x une seule fois pour spécifier plusieurs propriétés en les séparant par une virgule. Exemple :
    java2wsdl -x prop1=value1 -x prop2=value2
    équivaut à :
    java2wsdl -x prop1=value1,prop2=value2
    L'option -x est souple et permet de spécifier chaque option de ligne de commande pour chaque générateur de liaisons individuellement, si nécessaire. La valeur définie avec l'option -x remplace celle spécifiée par l'option de ligne de commande équivalente, si les deux sont spécifiées.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_java2wsdl
Nom du fichier : rwbs_java2wsdl.html