Befehl WADL2JAVA
Das Befehlszeilentool wadl2java verarbeitet eine vorhandene WADL-Datei (Web Application Description Language) und generiert die erforderlichen Artefakte für die Entwicklung von JAX-WS-Web-Service-Anwendungen (Java™ API for RESTful Web Services). Das Befehlszeilentool wadl2java unterstützt den Top-down-Ansatz für die Entwicklung von JAX-RS-Web-Services. Wenn Sie mit einer vorhandenen WADL-Datei beginnen, verwenden Sie das Befehlszeilentool "wadl2java", um die erforderlichen JAX-RS-Artefakte zu generieren.
Web Application Description Language (WADL)
WADL ist eine ressourcenzentrierte Beschreibungssprache, die entworfen wurde, um die Modellierung, die Beschreibung und das Testen von REST-konformen Webanwendungen zu vereinfachen. Weitere Informationen finden Sie auf der Website Web Application Description Language.Syntax
Die Befehlssyntax lautet:
wadl2java --[Optionen]
wadl2java -wadlns WADL-Namespace -p Paketname -sp
[Schema-Namespace =]Paketname -tMap Schematyp=Javatyp * -repMap Medientyp=Klassenname * -resource
Ressourcenname -b Bindungsdateiname * -catalog Katalogdateiname -d
Ausgabeverzeichnis -interface -impl -async Methodennamen * -generateEnums -inheritResourceParams
-noTypes -noVoidForEmptyResponses -noAddressBinding -supportMultipleXmlReps -generateResponseIfHeadersSet -generateResponseForMethods
Methodennamen * -async Methodennamen * -xjc xjc-argumentsv * -encoding
Codierung -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q wadl
Parameter
Für den Befehl
wadl2java können die folgenden
Optionswerte angegeben werden:
- -wadlns WADL-Namespace
- Gibt den WADL-Namespace an.
- -p Paketname
- Gibt den Java-Paketnamen für den generierten Code an, der die WADL-Ressourcenelemente darstellt.
- -sp [Schema-Namespace =]Paketname
- Gibt den Java-Paketnamen für den generierten Code an, der die WADL-Grammatikelemente darstellt. Geben Sie optional eine Zuordnung zwischen Namespace und Java-Paketnamen an.
- -tMap Schematyp=Java-Typ *
- Gibt eine optionale Zuordnung zwischen dem WADL-Parameter oder Darstellungsschematyp und dem angepassten Java-Typ an.
- -repMap Medientyp=Klassenname *
- Gibt die optionale Zuordnung zwischen einer WADL-Darstellung ohne wadl:element-Attribut und der Java-Klasse an.
- -resource Ressourcenname
- Gibt den einfachen Klassennamen für den generierten Code an, der eine WADL-Ressource ohne das Attribut "id" darstellt.
- -b Bindungsdateiname *
- Gibt externe JAXB-Bindungsdateien an. Verwenden Sie für jede Bindungsdatei ein -b-Flag.
- -catalog Katalogdateiname
- Gibt die Katalogdatei an, die der importierten WADL oder dem importierten Schema zugeordnet werden soll.
- -d Ausgabeverzeichnis
- Gibt das Verzeichnis an, in das der Code gestellt wird .
- -interface
- Gibt die Schnittstelle an, die generiert wird.
- -impl
- Gibt an, dass eine Pseudoserviceimplementierung generiert wird.
- -async Methodennamen *
- Gibt eine Liste mit durch Kommas getrennten Namen oder IDs von Methoden an, die ausgesetzte asynchrone Aufrufe unterstützen müssen.
- -generateEnums
- Gibt an, dass Enum-Klassen zur Darstellung von Parametern mit mehreren Optionen generiert werden können.
- -inheritResourceParams
- Gibt an, dass Parameter auf Ressourcenebene (Pfad oder Matrix) von untergeordneten Ressourcen übernommen werden können.
- -noTypes
- Inaktiviert die Generierung von Typen.
- -noVoidForEmptyResponses
- Verwendet den Rückgabetyp "JAX RS Response" für Methoden ohne Antwortdarstellung.
- -noAddressBinding
- Gibt an, dass der Generator die JAXB-Adressenbindungsdatei nicht verwenden darf, um "wsa:EndpointReferenceType" oder "wsa:EndpointReference" zu "javax.xml.ws.wsaddressing.W3CEndpointReference" zuzuordnen.
- -supportMultipleXmlReps
- Gibt an, dass bei Methoden mit mehreren XML-Anforderungsdarstellungen für jede dieser Darstellungen eine separate Methode generiert wird. Aktivieren Sie diese Option nicht, wenn serverseitiger JAX-RS-Code generiert wird. Eine einzelne Methode, die "javax.xml.transform" enthält. Der Eingabeparameter wird in solchen Fällen standardmäßig generiert.
- -generateResponseIfHeadersSet
- Verwendet den Rückgabetyp "JAX RS Response", wenn das Element "WADL Response" über "header"-Parameter verfügt.
- -generateResponseForMethods Methodennamen *
- Gibt eine Liste mit durch Kommas getrennten Namen oder IDs von Methoden an, für die der Rückgabetyp "JAX RS Response" generiert werden muss.
- -async Methodennamen *
- Gibt eine Liste mit durch Kommas getrennten Namen oder IDs von Methoden an, die ausgesetzte asynchrone Aufrufe unterstützen müssen.
- -xjc XJC-Argumente *
- Gibt eine Liste mit durch Kommas getrennten Argumenten an, die direkt an XJC übergeben werden, wenn die JAXB-Datenbindung verwendet wird. Diese Option bewirkt, dass XJC zusätzliche Plug-ins lädt, die die Codegenerierung erweitern. Zum Laden des Plug-ins "toString(ts)", das zu allen generierten Typen eine Methode "toString()" hinzufügt, müssten beispielsweise die folgenden Argumente verwendet werden: "-xjc-Xts". Mit "-xjc-X" kann eine Liste der verfügbaren XJC-Plug-ins abgerufen werden.
- -encoding Codierung
- Gibt die Zeichensatzcodierung an, die verwendet werden soll, wenn Java-Quellen generiert werden.
- -h|-?|-help
- Zeigt ausführliche Informationen zu Optionen an.
- -version|-v
- Zeigt die Version des Tools an.
- -verbose|-V
- Gibt an, dass der Generator im ausführlichen Modus ausgeführt wird.
- -quiet|-q|-Q
- -quiet|-q|-Q
- wadl
- WADL-URL