You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2017/02/03 18:47:08 UTC
svn commit: r1006157 - in /websites/production/cxf/content:
cache/docs.pageCache docs/wsdl-to-java.html
Author: buildbot
Date: Fri Feb 3 18:47:08 2017
New Revision: 1006157
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/wsdl-to-java.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/wsdl-to-java.html
==============================================================================
--- websites/production/cxf/content/docs/wsdl-to-java.html (original)
+++ websites/production/cxf/content/docs/wsdl-to-java.html Fri Feb 3 18:47:08 2017
@@ -117,15 +117,7 @@ Apache CXF -- WSDL to Java
<td height="100%">
<!-- Content -->
<div class="wiki-content">
-<div id="ConfluenceContent"><h2 id="WSDLtoJava-WSDLtoJava">WSDL to Java</h2>
-
-<h3 id="WSDLtoJava-Name">Name </h3>
-
-<p><code>wsdl2java</code> - takes a WSDL document and generates fully annotated Java code from which to implement a service. </p>
-
-<h3 id="WSDLtoJava-Synopsis">Synopsis</h3>
-
-<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
+<div id="ConfluenceContent"><h2 id="WSDLtoJava-WSDLtoJava">WSDL to Java</h2><h3 id="WSDLtoJava-Name">Name</h3><p><code>wsdl2java</code> - takes a WSDL document and generates fully annotated Java code from which to implement a service.</p><h3 id="WSDLtoJava-Synopsis">Synopsis</h3><div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Usage : wsdl2java -fe|-frontend <front-end-name> -db|-databinding <data-binding-name>
-wv <wsdl-version> -p <[wsdl-namespace =]package-name>* -sn <service-name>
-b <binding-file-name>* -reserveClass <class-name>* -catalog <catalog-file-name>
@@ -139,39 +131,8 @@ Apache CXF -- WSDL to Java
-faultSerialVersionUID <fault-serialVersionUID> -exceptionSuper <exceptionSuper>
-mark-generated -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q -wsdlList <wsdlurl>
</pre>
-</div></div>
-
-<h3 id="WSDLtoJava-Description">Description</h3>
-
-<p><strong>wsdl2java</strong> takes a WSDL document and generates fully annotated Java code from which to implement a service. The WSDL document must have a valid <code>portType</code> element, but it does not need to contain a binding element or a service element. Using the optional arguments you can customize the generated code. In addition, wsdl2java can generate an Ant based makefile to build your application.</p>
-
-<h3 id="WSDLtoJava-Options">Options</h3>
-
-<p>The options used to validate WSDL file are reviewed in the following table.</p>
-
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> Option </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Interpretation </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-?</code>,<code>-h</code>,<code>-help</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Displays the online help for this utility and exits. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-fe frontend-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-db databinding-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sd
o (sdo-static and sdo-dynamic), and jibx. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-wv wsdl-version</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the wsdl version .Default is WSDL1.1. Currently suppports only WSDL1.1 version. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-p [ wsdl-namespace= ] PackageName</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-sn service-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The WSDL service name to use for the generated code. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-b binding-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifi
es JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-catalog catalog-file-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specify catalog file to map the imported wsdl/schema </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-d output-directory</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the directory into which the generated code files are written. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-compile</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Compiles generated Java files. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-classdir compile-class-dir</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the directory into which the compiled class files are
written. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-client</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Generates starting point code for a client mainline. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-clientjar jar-file-name</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Generates the jar file which contains all the client classes and wsdl;the specified wsdlLocation won't work when the -clientJar is defined. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-server</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Generates starting point code for a server mainline. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-impl</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Generates starting point code for an implementation object. </p></td></tr><tr><td colspan="1" rowspan="1" cla
ss="confluenceTd"><p> <code>-all</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant <code>build.xml</code> file. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-ant</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specify to generate an Ant <code>build.xml</code> script. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-autoNameResolution</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Automatically resolve naming conflicts without requiring the use of binding customizations. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-defaultValues=[DefaultValueProvider impl]</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies that default values are generated for the impl and clien
t. You can also provide a custom default value provider. The default provider is <code>RandomValueProvider</code> </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-nexclude schema-namespace [=java-packagename]</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> 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). </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-exsh (true/false)</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Enables or disables processing of implicit SOAP headers (i.e. SOAP headers defined in the wsdl:binding but not wsdl:portType section.) Processing the SOAP headers requires the SOAP binding jars available on the classpath which was not the default in CXF 2.4.x and older. You may need to add a dependency to cxf-
rt-binding-soap for this flag to work. Default is false. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-dns (true/false)</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Enables or disables the loading of the default namespace package name mapping. Default is true and <a shape="rect" class="external-link" href="http://www.w3.org/2005/08/addressing=org.apache.cxf.ws.addressing" rel="nofollow">http://www.w3.org/2005/08/addressing=org.apache.cxf.ws.addressing</a> namespace package mapping will be enabled. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-dex (true/false)</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Enables or disables the loading of the default excludes namespace mapping. Default is true. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-validate</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Enables validating the W
SDL before generating the code. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-keep</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-wsdlLocation wsdlLocation</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies the value of the @WebServiceClient annotation's wsdlLocation property. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-xjc<xjc args></code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Specifies a comma separated list of <a shape="rect" class="external-link" href="https://jaxb.dev.java.net/nonav/2.2/docs/xjc.html" rel="nofollow">arguments</a> that are passed directly to the XJC processor when using the JAXB databinding. A lis
t of available XJC plugins can be obtained using <code>-xjc-X</code>. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-noAddressBinding</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> 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. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-v</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Displays the version number for the tool. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-verbose</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Displays comments during the code generation process. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-quiet</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Suppresses comments during
the code generation process. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-exceptionSuper</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> superclass for fault beans generated from wsdl:fault elements (defaults to java.lang.Exception) </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-reserveClass classname</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Used with -autoNameResolution, defines a class names for wsdl-to-java <strong>not</strong> to use when generating classes. Use this option multiple times for multiple classes.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-allowElementReferences<=true></code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> (or -aer) 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. </p></td></tr><t
r><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-asyncMethods=foo,bar,...</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> List of subsequently generated Java class methods to allow for client-side asynchronous calls, similar to enableAsyncMapping in a JAX-WS binding file. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-bareMethods=foo,bar,...</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> List of subsequently generated Java class methods to have wrapper style (see below), similar to enableWrapperStyle in JAX-WS binding file. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-mimeMethods=foo,bar,...</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> List of subsequently generated Java class methods to enable mime:content mapping, similar to enableMIMEContent in JAX-WS binding file. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <co
de>-faultSerialVersionUID <fault-serialVersionUID></code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> How to generate suid of fault exceptions. Use NONE, TIMESTAMP, FQCN, or a specific number. Default is NONE. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>-mark-generated</code> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Adds the <a shape="rect" class="external-link" href="http://docs.oracle.com/javase/6/docs/api/javax/annotation/Generated.html" rel="nofollow">@Generated</a> annotation to classes generated. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> <em>wsdlurl</em> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The path and name of the WSDL file to use in generating the code. </p></td></tr></tbody></table></div>
-
-<p>You must specify the absolute or relative path to the WSDL document as the last argument.</p>
-
-<p><span class="confluence-anchor-link" id="WSDLtoJava-usingant"></span></p>
-
-<h3 id="WSDLtoJava-Examples">Examples</h3>
-
-<p><code>wsdl2java HelloWorld.wsdl</code></p>
-
-<p><code>wsdl2java -p com.mycompany.greeting Greeting.wsdl</code></p>
-
-<p><code>wsdl2java -client HelloWorld.wsdl</code></p>
-
-<p>(See below for usage with Apache <a shape="rect" href="wsdl-to-java.html">Ant</a> and <a shape="rect" href="wsdl-to-java.html">Maven</a>.)</p>
-
-<h3 id="WSDLtoJava-Usingwsdl2javawithAnt">Using wsdl2java with Ant</h3>
-
-<p>The wsdl2java command can be wrapped inside an Ant target as shown below:</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
-<?xml version="1.0"?>
+</div></div><h3 id="WSDLtoJava-Description">Description</h3><p><strong>wsdl2java</strong> takes a WSDL document and generates fully annotated Java code from which to implement a service. The WSDL document must have a valid <code>portType</code> element, but it does not need to contain a binding element or a service element. Using the optional arguments you can customize the generated code. In addition, wsdl2java can generate an Ant based makefile to build your application.</p><h3 id="WSDLtoJava-Options">Options</h3><p>The options used to validate WSDL file are reviewed in the following table.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Interpretation</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-?</code>,<code>-h</code>,<code>-help</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays the o
nline help for this utility and exits.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-fe frontend-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-db databinding-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sdo (sdo-static and sdo-dynamic), and jibx.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-wv wsdl-version</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the wsdl version .Default is WSDL1.1. Currently suppports only WSDL1.1 version.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-p [ wsdl-namespace= ] PackageName</code></
p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-sn service-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The WSDL service name to use for the generated code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-b binding-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-catalog catalog-file-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specify catalog file to map the imported wsdl/schema</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-d output-directory<
/code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the directory into which the generated code files are written.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-compile</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Compiles generated Java files.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-classdir compile-class-dir</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the directory into which the compiled class files are written.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-client</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for a client mainline.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-clientjar jar-file-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates the jar file which contains all the client classes a
nd wsdl;the specified wsdlLocation won't work when the -clientJar is defined.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-server</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for a server mainline.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-impl</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for an implementation object.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-all</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant <code>build.xml</code> file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-ant</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specify to generate an Ant <code>build.xm
l</code> script.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-autoNameResolution</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Automatically resolve naming conflicts without requiring the use of binding customizations.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-defaultValues=[DefaultValueProvider impl]</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that default values are generated for the impl and client. You can also provide a custom default value provider. The default provider is <code>RandomValueProvider</code></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-nexclude schema-namespace [=java-packagename]</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>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).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-exsh (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables processing of implicit SOAP headers (i.e. SOAP headers defined in the wsdl:binding but not wsdl:portType section.) Processing the SOAP headers requires the SOAP binding jars available on the classpath which was not the default in CXF 2.4.x and older. You may need to add a dependency to cxf-rt-binding-soap for this flag to work. Default is false.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-dns (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables the loading of the default namespace package name mapping. Default is true and <a shape="rect" class="external-link" href="http://www.w3.org/2005/08/addressing=org.apache.cxf.ws.addressing" rel="nofollow">http://www.w3.org/2005/08/addressing=org.a
pache.cxf.ws.addressing</a> namespace package mapping will be enabled.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-dex (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables the loading of the default excludes namespace mapping. Default is true.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-validate</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables validating the WSDL before generating the code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-keep</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-wsdlLocation wsdlLocation</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>S
pecifies the value of the @WebServiceClient annotation's wsdlLocation property.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-xjc<xjc args></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies a comma separated list of <a shape="rect" class="external-link" href="https://jaxb.dev.java.net/nonav/2.2/docs/xjc.html" rel="nofollow">arguments</a> that are passed directly to the XJC processor when using the JAXB databinding. A list of available XJC plugins can be obtained using <code>-xjc-X</code>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-noAddressBinding</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>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.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-v</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Displays the version number for the tool.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-verbose</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays comments during the code generation process.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-quiet</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Suppresses comments during the code generation process.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-exceptionSuper</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>superclass for fault beans generated from wsdl:fault elements (defaults to java.lang.Exception)</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-reserveClass classname</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used with -autoNameResolution, defines a class names for wsdl-to-java <stron
g>not</strong> to use when generating classes. Use this option multiple times for multiple classes.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-allowElementReferences<=true></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>(or -aer) 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.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-asyncMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to allow for client-side asynchronous calls, similar to enableAsyncMapping in a JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-bareMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to have wrapper st
yle (see below), similar to enableWrapperStyle in JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-mimeMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to enable mime:content mapping, similar to enableMIMEContent in JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-faultSerialVersionUID <fault-serialVersionUID></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>How to generate suid of fault exceptions. Use NONE, TIMESTAMP, FQCN, or a specific number. Default is NONE.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-mark-generated</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Adds the <a shape="rect" class="external-link" href="http://docs.oracle.com/javase/6/docs/api/javax/annotation/Generated.html" rel="nofollow">@Generated</a> annot
ation to classes generated.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><em>wsdlurl</em></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The path and name of the WSDL file to use in generating the code.</p></td></tr></tbody></table></div><p>You must specify the absolute or relative path to the WSDL document as the last argument.</p><p><span class="confluence-anchor-link" id="WSDLtoJava-usingant"></span></p><h3 id="WSDLtoJava-Examples">Examples</h3><p><code>wsdl2java HelloWorld.wsdl</code></p><p><code>wsdl2java -p com.mycompany.greeting Greeting.wsdl</code></p><p><code>wsdl2java -client HelloWorld.wsdl</code></p><p>(See below for usage with Apache <a shape="rect" href="wsdl-to-java.html">Ant</a> and <a shape="rect" href="wsdl-to-java.html">Maven</a>.)</p><h3 id="WSDLtoJava-Usingwsdl2javawithAnt">Using wsdl2java with Ant</h3><p>The wsdl2java command can be wrapped inside an Ant target as shown below:</p><div class="code panel pdl" style="border-wid
th: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><?xml version="1.0"?>
<project name="cxf wsdl2java" basedir=".">
<property name="cxf.home" location ="/usr/myapps/cxf-2.5.1"/>
@@ -194,51 +155,19 @@ Apache CXF -- WSDL to Java
</target>
</project>
</pre>
-</div></div>
-
-<p>Make sure you set the "fork=true" attribute for the <java/> task as shown above. Also, remember to keep each word or flag within the command line options in its own <arg/> element (e.g., do not use <arg value="-d src"/>, but split them up into two <arg/> elements as done here.)</p>
-
-<p>Although we would recommend using Maven, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/antbuild/">antbuild sample</a> in the CXF distribution for an example of using Ant to create a CXF project.</p>
-
-
-<h2 id="WSDLtoJava-JAXWSCustomization">JAXWS Customization</h2>
-
-<p>The default JAX-WS frontend created by wsdl2java can be customized by using a customization binding file. For an example, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/jaxws_async/wsdl/async_binding.xml?view=markup">async_binding.xml</a> file in samples/jaxws_async – if specified when running wsdl2java, it will generate asynchronous methods in the SEI.</p>
-
-<p><strong>Q: What if I want to change the generated SEI name?</strong></p>
-
-<p>A: We don't have a command-line option to do this, but you can have a binding file like the following snippet to achieve this goal</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
-<bindings
+</div></div><p>Make sure you set the "fork=true" attribute for the <java/> task as shown above. Also, remember to keep each word or flag within the command line options in its own <arg/> element (e.g., do not use <arg value="-d src"/>, but split them up into two <arg/> elements as done here.)</p><p>Although we would recommend using Maven, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/antbuild/">antbuild sample</a> in the CXF distribution for an example of using Ant to create a CXF project.</p><h2 id="WSDLtoJava-JAXWSCustomization">JAXWS Customization</h2><p>The default JAX-WS frontend created by wsdl2java can be customized by using a customization binding file. For an example, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/jaxws_async/wsdl/async_binding.xml?view=markup">async_binding.xml</a> file
in samples/jaxws_async – if specified when running wsdl2java, it will generate asynchronous methods in the SEI.</p><p><strong>Q: What if I want to change the generated SEI name?</strong></p><p>A: We don't have a command-line option to do this, but you can have a binding file like the following snippet to achieve this goal</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><bindings
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
wsdlLocation="hello_world.wsdl"
xmlns="http://java.sun.com/xml/ns/jaxws">
- <bindings node="wsdl:definitions/wsdl:portType">
+ <bindings node="wsdl:definitions/wsdl:portType[@name='GreeterSE']">
<class name="GreeterSEI"/>
</bindings>
</bindings>
</pre>
-</div></div>
-
-<p><strong>Q: How do I pass the binding file to wsdl2java?</strong></p>
-
-<p>A: If you are using wsdl2java via command line tool: </p>
-
-<p> wsdl2java HelloWorld.wsdl -b my_binding.xml</p>
-
-<p>For Ant, follow the example above on how to add "-b" and "my_binding.xml" as arg elements.</p>
-
-<p>For Maven see <a shape="rect" href="maven-cxf-codegen-plugin-wsdl-to-java.html">cxf-codegen-plugin</a></p>
-
-<p><strong>Q: How to map xsd:dateTime to java.util.Date?</strong><br clear="none">
-Well, people don't like the XMLGregorianCalendar which is the default mapping from the xsd:dateTime (xsd:time and xsd:date as well),<br clear="none">
-We can use the jaxws customization to change the default mapping, here are some sample binding files<br clear="none">
-If you have schema inside the wsdl, here is the binding file you can use:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
-<jaxws:bindings wsdlLocation="YOUR_WSDL_LOCATION"
+</div></div><p><strong>Q: How do I pass the binding file to wsdl2java?</strong></p><p>A: If you are using wsdl2java via command line tool:</p><p>wsdl2java HelloWorld.wsdl -b my_binding.xml</p><p>For Ant, follow the example above on how to add "-b" and "my_binding.xml" as arg elements.</p><p>For Maven see <a shape="rect" href="maven-cxf-codegen-plugin-wsdl-to-java.html">cxf-codegen-plugin</a></p><p><strong>Q: How to map xsd:dateTime to java.util.Date?</strong><br clear="none"> Well, people don't like the XMLGregorianCalendar which is the default mapping from the xsd:dateTime (xsd:time and xsd:date as well),<br clear="none"> We can use the jaxws customization to change the default mapping, here are some sample binding files<br clear="none"> If you have schema inside the wsdl, here is the binding file you can use:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jaxws:bindings wsdlLocation="YOUR_WSDL_LOCATION"
xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
@@ -246,42 +175,33 @@ If you have schema inside the wsdl, here
<jaxws:bindings node="wsdl:definitions/wsdl:types/xs:schema[@targetNamespace='THE_NAMESPACE_OF_YOUR_SCHEMA']">
<jxb:globalBindings xmlns:jxb="http://java.sun.com/xml/ns/jaxb" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<jxb:javaType name="java.util.Date" xmlType="xs:dateTime"
- parseMethod="org.apache.cxf.tools.common.DataTypeAdapter.parseDateTime"
- printMethod="org.apache.cxf.tools.common.DataTypeAdapter.printDateTime"/>
+ parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime"
+ printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime"/>
</jxb:globalBindings>
</jaxws:bindings>
</jaxws:bindings>
</pre>
-</div></div>
-
-<p>If you want to use java.util.Calendar, just change the org.apache.cxf.tools.common.DataTypeAdapter to javax.xml.bind.DatatypeConverter, and change the name value to "java.util.Calendar"</p>
-
-<p>If your schema is out of wsdl, here is an example you can try:</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
-<jxb:bindings version="2.0"
+</div></div><p>This requires an additional dependency:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><dependency>
+ <groupId>org.apache.cxf.xjc-utils</groupId>
+ <artifactId>cxf-xjc-runtime</artifactId>
+</dependency>
+</pre>
+</div></div><p> </p><p>If you want to use java.util.Calendar, just change the org.apache.cxf.xjc.runtime.DataTypeAdapter to javax.xml.bind.DatatypeConverter, and change the name value to "java.util.Calendar"</p><p>If your schema is out of wsdl, here is an example you can try:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jxb:bindings version="2.0"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<jxb:bindings schemaLocation="file:<path><name>.xsd" node="/xs:schema">
<jxb:globalBindings xmlns:jxb="http://java.sun.com/xml/ns/jaxb" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<jxb:javaType name="java.util.Date" xmlType="xs:dateTime"
- parseMethod="org.apache.cxf.tools.common.DataTypeAdapter.parseDateTime"
- printMethod="org.apache.cxf.tools.common.DataTypeAdapter.printDateTime"/>
+ parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime"
+ printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime"/>
</jxb:globalBindings>
</jxb:bindings>
</jxb:bindings>
</pre>
-</div></div>
-
-<p><span class="confluence-anchor-link" id="WSDLtoJava-wrapperstyle"></span><br clear="none">
-<strong>Q: How can I switch my generated web service method calls from wrapper style to non wrapper-style (or vice-versa)?</strong></p>
-
-<p>A: Create an external binding file and set the value of <enableWrapperStyle/> to true or false as desired:</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
-<jaxws:bindings
+</div></div><p><span class="confluence-anchor-link" id="WSDLtoJava-wrapperstyle"></span><br clear="none"> <strong>Q: How can I switch my generated web service method calls from wrapper style to non wrapper-style (or vice-versa)?</strong></p><p>A: Create an external binding file and set the value of <enableWrapperStyle/> to true or false as desired:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jaxws:bindings
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
wsdlLocation="your.wsdl"
@@ -290,13 +210,8 @@ If you have schema inside the wsdl, here
<enableWrapperStyle>false</enableWrapperStyle>
</jaxws:bindings>
</pre>
-</div></div>
-
-<p>Alternatively you can embed this instruction within the WSDL file directly, as the immediate child of the wsdl:portType:</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
-<wsdl:portType name="MyWebServicePortType">
+</div></div><p>Alternatively you can embed this instruction within the WSDL file directly, as the immediate child of the wsdl:portType:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><wsdl:portType name="MyWebServicePortType">
<jaxws:bindings xmlns:jaxws="http://java.sun.com/xml/ns/jaxws">
<jaxws:enableWrapperStyle>false</jaxws:enableWrapperStyle>
... other binding settings if needed ...
@@ -305,22 +220,7 @@ If you have schema inside the wsdl, here
...
</wsdl:portType>
</pre>
-</div></div>
-
-<p>Note: The meaning of "wrapper-style" and "non-wrapper style" as defined in the <a shape="rect" class="external-link" href="http://jcp.org/aboutJava/communityprocess/pfd/jsr224/index.html" rel="nofollow">JAX-WS 2.1 specification</a> can be counterintuitive. Wrapper-style indicates that each data element within the request message gets its own Java parameter, while non-wrapper style means that a single Java object containing all the data elements serves as the lone parameter to the web service method call. (See Figure 2.2 of the specification for an example.) Also, <strong>note the wrapper style is not always available</strong>, the WSDL criteria specified in Section 2.3.1.2 ("Wrapper Style") of the specification must be met or only non-wrapper style will be generated.</p>
-
-<p><strong>Q: What else can I change with the JAXWS customization binding file?</strong></p>
-
-<p>A: You can find the full list of customization items in Chapter 8 of the JAX-WS Specification.</p>
-
-<p><span class="confluence-anchor-link" id="WSDLtoJava-usingmaven"></span></p>
-<h2 id="WSDLtoJava-UsingmaventogeneratejavacodefromWSDL">Using maven to generate java code from WSDL</h2>
-
-<p>see <a shape="rect" href="maven-cxf-codegen-plugin-wsdl-to-java.html">cxf-codegen-plugin</a></p>
-
-<h3 id="WSDLtoJava-SeeAlso">See Also</h3>
-
-<p><a shape="rect" href="idl-to-wsdl.html"><code>idl2wsdl</code></a>, <a shape="rect" href="java-to-javascript.html"><code>java2js</code></a>, <a shape="rect" href="java-to-ws.html"><code>java2ws</code></a>, <a shape="rect" href="wsdl-to-corba.html"><code>wsdl2corba</code></a>, <a shape="rect" href="wsdl-to-javascript.html"><code>wsdl2js</code></a>, <a shape="rect" href="wsdl-to-service.html"><code>wsdl2service</code></a>, <a shape="rect" href="wsdl-to-soap.html"><code>wsdl2soap</code></a>, <a shape="rect" href="wsdl-to-xml.html"><code>wsdl2xml</code></a>, <a shape="rect" href="wsdlvalidator.html"><code>wsdlvalidator</code></a> and <a shape="rect" href="xsd-to-wsdl.html">xsd2wsdl</a>.</p></div>
+</div></div><p>Note: The meaning of "wrapper-style" and "non-wrapper style" as defined in the <a shape="rect" class="external-link" href="http://jcp.org/aboutJava/communityprocess/pfd/jsr224/index.html" rel="nofollow">JAX-WS 2.1 specification</a> can be counterintuitive. Wrapper-style indicates that each data element within the request message gets its own Java parameter, while non-wrapper style means that a single Java object containing all the data elements serves as the lone parameter to the web service method call. (See Figure 2.2 of the specification for an example.) Also, <strong>note the wrapper style is not always available</strong>, the WSDL criteria specified in Section 2.3.1.2 ("Wrapper Style") of the specification must be met or only non-wrapper style will be generated.</p><p><strong>Q: What else can I change with the JAXWS customization binding file?</strong></p><p>A: You can find the full list of customization items in Chapter 8 of the JAX-WS Specification.</p><p><span
class="confluence-anchor-link" id="WSDLtoJava-usingmaven"></span></p><h2 id="WSDLtoJava-UsingmaventogeneratejavacodefromWSDL">Using maven to generate java code from WSDL</h2><p>see <a shape="rect" href="maven-cxf-codegen-plugin-wsdl-to-java.html">cxf-codegen-plugin</a></p><h3 id="WSDLtoJava-SeeAlso">See Also</h3><p><a shape="rect" href="idl-to-wsdl.html"><code>idl2wsdl</code></a>, <a shape="rect" href="java-to-javascript.html"><code>java2js</code></a>, <a shape="rect" href="java-to-ws.html"><code>java2ws</code></a>, <a shape="rect" href="wsdl-to-corba.html"><code>wsdl2corba</code></a>, <a shape="rect" href="wsdl-to-javascript.html"><code>wsdl2js</code></a>, <a shape="rect" href="wsdl-to-service.html"><code>wsdl2service</code></a>, <a shape="rect" href="wsdl-to-soap.html"><code>wsdl2soap</code></a>, <a shape="rect" href="wsdl-to-xml.html"><code>wsdl2xml</code></a>, <a shape="rect" href="wsdlvalidator.html"><code>wsdlvalidator</code></a> and <a shape="rect" href="xsd-to-wsdl.html">xs
d2wsdl</a>.</p></div>
</div>
<!-- Content -->
</td>