WSDL to Java - 8.0

Talend ESB Service Developer Guide

Version
8.0
Language
English
Product
Talend Data Fabric
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend ESB
Talend Runtime
Content
Design and Development
Installation and Upgrade
Last publication date
2023-11-06

wsdl2java creates JAX-WS and JAXB (or other databinding framework) objects from a service WSDL. It has the following parameters:

Parameter Option
-h Displays the online help for this utility and exits.
-fe frontend-name Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code.
-db databinding-name Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sdo (sdo-static and sdo-dynamic), and jibx.
-wv wsdl-version Specifies the wsdl version .Default is WSDL1.1. Currently supports only WSDL1.1 version.
-p [ wsdl-namespace= ] PackageName Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping.
-sn service-name The WSDL service name to use for the generated code.
-b binding-name Specifies JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries.
-catalog catalog-file-name Specify catalog file to map the imported wsdl/schema
-d output-directory Specifies the directory into which the generated code files are written.
-compile Compiles generated Java files.
-classdir compile-class-dir Specifies the directory into which the compiled class files are written.
-client Generates starting point code for a client mainline.
-clientjar jar-file-name Generates the jar file which contains all the client classes and wsdls; wsdlLocation param ignored with this setting.
-server Generates starting point code for a server mainline.
-impl Generates starting point code for an implementation object.
-all Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant build.xml file.
-ant Specify to generate an Ant build.xml script.
-autoNameResolution Automatically resolve naming conflicts without requiring the use of binding customizations.
-defaultValues= [DefaultValueProvider impl ] Specifies that default values are generated for the impl and client. You can also provide a custom default value provider. The default provider is RandomValueProvider
-nexclude schema-namespace [=java-packagename ] Ignore the specified WSDL schema namespace when generating code. This option may be specified multiple times. Also, optionally specifies the Java package name used by types described in the excluded namespace(s).
-exsh (true/false) Enables or disables processing of implicit SOAP headers (i.e. SOAP headers defined in the wsdl:binding but not wsdl:portType section.) Default is false.
-dns (true/false) Enables or disables the loading of the default namespace package name mapping. Default is true and [http://www.w3.org/2005/08/addressing=org.apache.cxf.ws.addressing] namespace package mapping will be enabled.
-dex (true/false) Enables or disables the loading of the default excludes namespace mapping. Default is true.
-validate Enables validating the WSDL before generating the code.
-keep Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues.
-wsdlLocation wsdlLocation Specifies the value of the @WebServiceClient annotation's wsdlLocation property.
-xjc<xjc args> Specifies a comma separated list of [arguments|https://jaxb.dev.java.net/nonav/2.2/docs/xjc.html] that are passed directly to the XJC processor when using the JAXB databinding. A list of available XJC plugins can be obtained using -xjc -X.
-noAddressBinding For compatibility with CXF 2.0, this flag directs the code generator to generate the older CXF proprietary WS-Addressing types instead of the JAX-WS 2.1 compliant WS-Addressing types.
-v Displays the version number for the tool.
-verbose Displays comments during the code generation process.
-quiet Suppresses comments during the code generation process.
-exceptionSuper superclass for any fault beans generated from wsdl:fault elements (defaults to java.lang.Exception)
-reserveClass classname Used with -autoNameResolution, defines a class names for wsdl-to-java not to use when generating classes. Use this option multiple times for multiple classes.
-allowElementReferences If true, disregards the rule given in section 2.3.1.2(v) of the JAX-WS 2.2 specification disallowing element references when using wrapper-style mapping.
-asyncMethods=foo,bar,... List of subsequently generated Java class methods to allow for client-side asynchronous calls, similar to enableAsyncMapping in a JAX-WS binding file.
-bareMethods=foo,bar,... List of subsequently generated Java class methods to have wrapper style (see below), similar to enableWrapperStyle in JAX-WS binding file.
-mimeMethods=foo,bar,... List of subsequently generated Java class methods to enable mime:content mapping, similar to enableMIMEContent in JAX-WS binding file.
-faultSerialVersionUID <fault-serialVersionUID> How to generate suid of fault exceptions. Use NONE, TIMESTAMP, FQCN, or a specific number. Default is NONE.
-mark-generated Adds the @Generated annotation to classes generated.
_wsdlurl_ The path and name of the WSDL file to use in generating the code.

Examples of wsdl2java in use:

  • wsdl2java HelloWorld.wsdl
  • wsdl2java -p com.mycompany.greeting Greeting.wsdl
  • wsdl2java -client HelloWorld.wsdl