Commande WADL2JAVA
L'outil de ligne de commande wadl2java traite un fichier WADL (Web Application Description Language) existant et génère les artefacts requis pour le développement d'applications de service Web de l'API Java™ API for RESTful Web Services (JAX-RS). L'outil de ligne de commande wadl2java prend en charge l'approche descendante pour le développement de services Web JAX-RS. Lorsque vous commencez avec un fichier WADL existant, utilisez l'outil de ligne de commande wadl2java pour générer les artefacts JAX-RS requis.
WADL (Web Application Description Language)
WADL est un langage de description centré sur les ressources qui est conçu pour faciliter la modélisation, la description et les tests des applications Web RESTful. Pour plus d'informations, voir Web Application Description Language.Syntaxe
La syntaxe de la commande est la suivante :
wadl2java --[options]
wadl2java -wadlns wadl-namespace -p package-name -sp [schema-namespace =]package-name -tMap schema-type=java-type * -repMap media-type=class-name * -resource resource-name -b binding-file-name * -catalog catalog-file-name -d output-directory -interface -impl -async methodNames * -generateEnums -inheritResourceParams -noTypes -noVoidForEmptyResponses -noAddressBinding -supportMultipleXmlReps -generateResponseIfHeadersSet -generateResponseForMethods methodNames * -async methodNames * -xjc xjc-argumentsv * -encoding encoding -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q wadl
Paramètres
Les valeurs suivantes sont disponibles pour les
valeurs options
de la commande
wadl2java :
- -wadlns wadl-namespace
- Indiquez l'espace de nom WADL.
- -p package-name
- Indique le nom de package Java à utiliser pour le code généré qui représente les éléments de ressource WADL.
- -sp [schema-namespace =]package-name
- Indique le nom de package Java à utiliser pour le code généré qui représente les éléments de syntaxe WADL. Vous pouvez également indiquer un espace de nom pour le mappage du nom de package Java.
- -tMap schema-type=java-type *
- Indique le mappage en option entre le paramètre WADL ou le type de schéma de représentation et le type Java personnalisé.
- -repMap media-type=class-name *
- Indique le mappage en option entre une représentation WADL sans attribut wadl:element et une classe Java.
- -resource resource-name
- Indiquez le nom de classe simple à utiliser pour le code généré qui représente une ressource WADL sans attribut d'ID.
- -b binding-file-name *
- Indiquez les fichiers de liaison jaxb externes. Utilisez un indicateur -b pour chaque fichier de liaison.
- -catalog catalog-file-name
- Indiquez le fichier catalogue pour le mappage de l'élément ou du schéma wadl importé.
- -d output-directory
- Indiquez le répertoire dans lequel est placé le code.
- -interface
- Indique que l'interface est générée.
- -impl
- Indique qu'une implémentation de service factice est générée.
- -async methodNames *
- Indique une liste séparée par des virgules des noms de méthode et des identificateurs e qui doivent prendre en charge les appels asynchrones suspendus.
- -generateEnums
- Indique que des classes de type Enum peuvent être générées pour représenter les paramètres avec plusieurs options.
- -inheritResourceParams
- Indique que des paramètres de niveau ressource (chemin ou matrice) peuvent être hérités par les ressources enfant.
- -noTypes
- Désactive la génération des types
- -noVoidForEmptyResponses
- Utilisez le type de retour JAX-RS Response pour les méthodes sans représentation de réponse.
- -noAddressBinding
- Indique que le générateur n'utilise peut-être pas le fichier de liaison jaxb d'adresse pour mapper wsa:EndpointReferenceType ou wsa:EndpointReference à javax.xml.ws.wsaddressing.W3CEndpointReference.
- -supportMultipleXmlReps
- Indique que si une a méthode contient plusieurs représentations XML de demande, une méthode distincte pour chaque représentation est générée. N'activez pas cette option lorsque du code JAX-RS côté serveur est généré. Méthode unique qui contient un élément javax.xml.transform. Le paramètre d'entrée source est généré par défaut dans ce cas.
- -generateResponseIfHeadersSet
- Utilisez le type de retour JAX-RS Response si l'élément WADL Response comporte des paramètres 'header'.
- -generateResponseForMethods methodNames *
- Indique une liste séparée par des virgules des noms de méthode ou des identificateurs dont le type de retour JAXRS Response doit être généré.
- -async methodNames *
- Indique une liste séparée par des virgules des noms de méthode et des identificateurs e qui doivent prendre en charge les appels asynchrones suspendus.
- -xjc xjc-argumentsv *
- Indique une liste séparée par des virgules des arguments qui sont transmis directement à XJC lorsque la liaison de données JAXB est utilisée. Cette option entraîne le chargement par XJC de plug-ins supplémentaires qui augmentent la génération de code. Par exemple, pour charger le plug-in toString(ts) qui ajoute une méthode toString() à tous les types générés, il faudrait utiliser les arguments suivants : -xjc-Xts A list of available XJC plug-ins can be obtained by using -xjc-X.
- -encoding encodage
- Indique le codage de jeu de caractères à utiliser lorsque des sources Java sont générées.
- -h|-?|-help
- Affichage des informations détaillées sur les options.
- -version|-v
- Affichage de la version de l'outil.
- -verbose|-V
- Indique que le générateur s'exécute en mode prolixe.
- -quiet|-q|-Q
- -quiet|-q|-Q
- wadl
- wadl-url