Mandato WADL2JAVA
La herramienta de línea de mandatos wadl2java procesa un archivo WADL (Web Application Description Language) existente y genera los artefactos necesarios para el desarrollo de aplicaciones de servicios web JAX-RS (Java™ API for RESTful Web Services). La herramienta de línea de mandatos wadl2java da soporte al enfoque descendente para desarrollar servicios web JAX-RS. Cuando comience con un archivo WADL existente, utilice la herramienta de línea de mandatos wadl2java para generar los artefactos JAX-RS necesarios.
WADL (Web Application Description Language)
WADL es un lenguaje de descripción centralizada de recursos diseñado para facilitar el modelado, la descripción y la prueba de aplicaciones web RESTful. Para obtener más información, consulte Web Application Description Language.Sintaxis
La sintaxis del mandato es la siguiente:
wadl2java --[opciones]
wadl2java -wadlns espacio_nombres-wadl -p nombre-paquete -sp
[espacio_nombres-esquema =]nombre-paquete -tMap tipo-esquema=tipo-java * -repMap
tipo-soporte=nombre-clase
* -resource nombre-recurso -b nombre-archivo-enlace * -catalog
nombre-archivo-catálogo -d
directorio-salida -interface -impl -async nombresMétodo * -generateEnums -inheritResourceParams -noTypes
-noVoidForEmptyResponses -noAddressBinding -supportMultipleXmlReps -generateResponseIfHeadersSet -generateResponseForMethods
nombresMétodo * -async nombresMétodo * -xjc xjc-argumentsv * -encoding
codificación -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q wadl
Parámetros
Están disponibles los siguientes valores de opciones para el mandato wadl2java:
- -wadlns espacio_nombres-wadl
- Especifique el espacio de nombres de WADL.
- -p nombre-paquete
- Especifica el nombre del paquete Java que se utilizará para el código generado que representa los elementos de recurso WADL.
- -sp [espacio_nombres-esquema =]nombre-paquete
- Especifica el nombre del paquete Java que se utilizará para el código generado que representa los elementos de gramática WADL. Opcionalmente, especifique una correlación del espacio de nombres con el nombre de paquete Java.
- -tMap tipo-esquema=tipo-java *
- Especifica la correlación opcional entre el tipo de esquema de representación o parámetro WADL y el tipo Java personalizado.
- -repMap tipo-soporte=nombre-clase *
- Especifica la correlación opcional entre una representación WADL sin atributo wadl:element y una clase Java.
- -resource nombre-recurso
- Especifique el nombre de clase simple que se utilizará para el código generado que representa un recurso WADL sin el atributo id.
- -b nombre-archivo-enlace *
- Especifique archivos de enlace jaxb externos. Utilice un distintivo -b para cada archivo de enlace.
- -catalog nombre-archivo-catálogo
- Especifique el archivo de catálogo para correlacionar el wadl o esquema importado.
- -d directorio-salida
- Especifique el directorio en el que se coloca el código.
- -interface
- Especifica que se genera una interfaz.
- -impl
- Especifica que se genera una implementación de servicio ficticia.
- -async nombresMétodo *
- Especifica una lista separada por comas de nombres de método o identificadores que deben dar soporte a las invocaciones asíncronas suspendidas.
- -generateEnums
- Especifica una lista de nombres de método o identificadores separados por comas que deben dar soporte a las invocaciones asíncronas suspendidas.
- -inheritResourceParams
- Especifica que los recursos hijos pueden heredar parámetros de nivel de recurso (vía de acceso o matriz).
- -noTypes
- Desactiva la generación de tipos
- -noVoidForEmptyResponses
- Utilizar el tipo de retorno de respuesta JAX-RS para los métodos sin representación de respuesta.
- -noAddressBinding
- Especifica que el generador no puede utilizar el archivo de enlace jaxb de dirección para correlacionar wsa:EndpointReferenceType o wsa:javax.xml.ws.wsaddressing.W3CEndpointReference con EndpointReference.
- -supportMultipleXmlReps
- Especifica que, si un método contiene varias representaciones XML de solicitud, se genera un método separado por cada representación de este tipo. No habilite esta opción al generar un código JAX-RS del lado del servidor. En estos casos, se genera de forma predeterminada un único método que contiene un parámetro de entrada javax.xml.transform.
- -generateResponseIfHeadersSet
- Utilizar el tipo de retorno de respuesta JAX-RS si el elemento WADL Response contiene parámetros 'header'.
- -generateResponseForMethods nombresMétodo *
- Especifica una lista de nombres de método o identificadores separados por comas que deben generar el tipo de retorno de respuesta JAXRS.
- -async nombresMétodo *
- Especifica una lista separada por comas de nombres de método o identificadores que deben dar soporte a las invocaciones asíncronas suspendidas.
- -xjc xjc-argumentsv *
- Especifica una lista de argumentos separados por comas que se pasan directamente a XJC cuando se utiliza el enlace de datos JAXB. Esta opción hace que XJC cargue plug-ins adicionales que aumentan la generación de código. Por ejemplo, para cargar el plug-in toString(ts), que añade un método toString() a todos los tipos generados, se utilizarán los argumentos siguientes: -xjc-Xts. Puede obtenerse una lista de los plug-ins XJC disponibles mediante -xjc-X.
- -encoding encoding
- Especifica la codificación de juego de caracteres que se debe utilizar cuando se generan orígenes Java.
- -h|-?|-help
- Mostrar información detallada para las opciones.
- -version|-v
- Mostrar la versión de la herramienta.
- -verbose|-V
- Especifica que el generador se ejecuta en modalidad detallada.
- -quiet|-q|-Q
- -quiet|-q|-Q
- wadl
- wadl-url