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
- Indique l'espace de nom WADL.
- -p package-name
- Indique le nom de pack 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 pack 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 pack 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
- Indique 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 *
- Indique les fichiers de liaison jaxb externes. Utilisez un indicateur -b pour chaque fichier de liaison.
- -catalog catalog-file-name
- Indique le fichier catalogue pour le mappage de l'élément ou du schéma wadl importé.
- -d output-directory
- Indique 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
- Utilise 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
- Utilise 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 encoding
- Indique codage de jeu de caractères à utiliser lorsque des sources Java sont générées.
- -h|-?|-help
- Affiche des informations détaillées sur les options.
- -version|-v
- Affiche la version de l'outil.
- -verbose|-V
- Indique que le générateur s'exécute e mode prolixe.
- -quiet|-q|-Q
- -quiet|-q|-Q
- wadl
- wadl-url