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 2012/04/10 22:48:05 UTC
svn commit: r812240 - in /websites/production/cxf/content:
cache/docs.pageCache docs/wsdl-to-java.html
Author: buildbot
Date: Tue Apr 10 20:48:05 2012
New Revision: 812240
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 Tue Apr 10 20:48:05 2012
@@ -130,16 +130,18 @@ Apache CXF -- WSDL to Java
<h3><a shape="rect" name="WSDLtoJava-Synopsis"></a>Synopsis</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
-<pre>wsdl2java -fe <frontend name>* -db <data binding name>* -wv <[wsdl version]>*
--p <[wsdl namespace =]Package Name>* -sn <service-name> -b <binding-name>*
--catalog <catalog-file-name> -d <output-directory> -compile
--classdir <compile-classes-directory> -impl -server -client -all
--autoNameResolution -defaultValues<=class name for DefaultValueProvider> -ant
--nexclude <schema namespace [= java packagename]>* -exsh <(true, false)>
--dns <(true, false)> -dex <(true, false)> -validate -keep
--wsdlLocation <wsdlLocation attribute> -xjc<xjc arguments> -noAddressBinding -h
--v -verbose -quiet -useFQCNForFaultSerialVersionUID <wsdlurl>
--exceptionSuper <exception class>
+<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>
+-d <output-directory> -compile -classdir <compile-classes-directory> -impl -server
+-client -all -autoNameResolution -allowElementReferences|-aer<=true>
+-defaultValues<=class-name-for-DefaultValueProvider> -ant
+-nexclude <schema-namespace [= java-package-name]>* -exsh <(true, false)> -noTypes
+-dns <(true, false> -dex <(true, false)> -validate -keep
+-wsdlLocation <wsdlLocation> -xjc<xjc-arguments>* -asyncMethods<[=method1,method2,...]>*
+-bareMethods<[=method1,method2,...]>* -mimeMethods<[=method1,method2,...]>* -noAddressBinding
+-faultSerialVersionUID <fault-serialVersionUID> -exceptionSuper <exceptionSuper>
+-mark-generated -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q -wsdlList <wsdlurl>
</pre>
</div></div>
@@ -152,8 +154,7 @@ Apache CXF -- WSDL to Java
<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"> Option </th><th colspan="1" rowspan="1" class="confluenceTh"> Interpretation </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-?</tt>,<tt>-h</tt>,<tt>-help</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays the online help for this utility and exits. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-fe frontend-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-db databinding-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sdo (sdo-static and sdo-dynamic), and jibx. </td></tr><tr><td colspan="1" rowspan="1" cla
ss="confluenceTd"> <tt>-wv wsdl-version</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the wsdl version .Default is WSDL1.1. Currently suppports only WSDL1.1 version. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-p [ wsdl-namespace= ] PackageName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-sn service-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The WSDL service name to use for the generated code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-b binding-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries. </td></tr><tr><td colspan="1" rowspan="1" c
lass="confluenceTd"> <tt>-catalog catalog-file-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specify catalog file to map the imported wsdl/schema </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-d output-directory</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the directory into which the generated code files are written. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-compile</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Compiles generated Java files. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-classdir compile-class-dir</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the directory into which the compiled class files are written. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-client</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for a client mainline. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>-server</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for a server mainline. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-impl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for an implementation object. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-all</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant <tt>build.xml</tt> file. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-ant</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specify to generate an Ant <tt>build.xml</tt> script. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-autoNameResolution</tt> </td><td colspan="1" rowspan="1" class="c
onfluenceTd"> Automatically resolve naming conflicts without requiring the use of binding customizations. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-defaultValues=[DefaultValueProvider impl]</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies that default values are generated for the impl and client. You can also provide a custom default value provider. The default provider is <tt>RandomValueProvider</tt> </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-nexclude schema-namespace [=java-packagename]</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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). </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-exsh (true/false)</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> E
nables 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-dns (true/false)</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-dex (true/false)</tt> </td><td colspan="1" rowspan="1" class="conf
luenceTd"> Enables or disables the loading of the default excludes namespace mapping. Default is true. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-validate</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Enables validating the WSDL before generating the code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-keep</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-wsdlLocation wsdlLocation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the value of the @WebServiceClient annotation's wsdlLocation property. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-xjc<xjc args></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies a comma separat
ed 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 <tt>-xjc-X</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-noAddressBinding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-v</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays the version number for the tool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-verbose</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays comments during the code generation process. </td></tr>
<tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-quiet</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Suppresses comments during the code generation process. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-useFQCNForFaultSerialVersionUID</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Enable generation of Serial Version UID in fault Exception(s) based on hashcode<br clear="none">
-of the fully qualified class name of the Exception </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-exceptionSuper</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> superclass for fault beans generated from wsdl:fault elements (defaults to java.lang.Exception) </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <em>wsdlurl</em> </td><td colspan="1" rowspan="1" class="confluenceTd"> The path and name of the WSDL file to use in generating the code. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh"> Interpretation </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-?</tt>,<tt>-h</tt>,<tt>-help</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays the online help for this utility and exits. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-fe frontend-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-db databinding-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sdo (sdo-static and sdo-dynamic), and jibx. </td></tr><tr><td colspan="1" rowspan="1" cla
ss="confluenceTd"> <tt>-wv wsdl-version</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the wsdl version .Default is WSDL1.1. Currently suppports only WSDL1.1 version. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-p [ wsdl-namespace= ] PackageName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-sn service-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The WSDL service name to use for the generated code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-b binding-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries. </td></tr><tr><td colspan="1" rowspan="1" c
lass="confluenceTd"> <tt>-catalog catalog-file-name</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specify catalog file to map the imported wsdl/schema </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-d output-directory</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the directory into which the generated code files are written. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-compile</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Compiles generated Java files. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-classdir compile-class-dir</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the directory into which the compiled class files are written. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-client</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for a client mainline. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>-server</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for a server mainline. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-impl</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates starting point code for an implementation object. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-all</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant <tt>build.xml</tt> file. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-ant</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specify to generate an Ant <tt>build.xml</tt> script. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-autoNameResolution</tt> </td><td colspan="1" rowspan="1" class="c
onfluenceTd"> Automatically resolve naming conflicts without requiring the use of binding customizations. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-defaultValues=[DefaultValueProvider impl]</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies that default values are generated for the impl and client. You can also provide a custom default value provider. The default provider is <tt>RandomValueProvider</tt> </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-nexclude schema-namespace [=java-packagename]</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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). </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-exsh (true/false)</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> E
nables 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-dns (true/false)</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-dex (true/false)</tt> </td><td colspan="1" rowspan="1" class="conf
luenceTd"> Enables or disables the loading of the default excludes namespace mapping. Default is true. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-validate</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Enables validating the WSDL before generating the code. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-keep</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-wsdlLocation wsdlLocation</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies the value of the @WebServiceClient annotation's wsdlLocation property. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-xjc<xjc args></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Specifies a comma separat
ed 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 <tt>-xjc-X</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-noAddressBinding</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-v</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays the version number for the tool. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-verbose</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Displays comments during the code generation process. </td></tr>
<tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-quiet</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Suppresses comments during the code generation process. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-exceptionSuper</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> superclass for fault beans generated from wsdl:fault elements (defaults to java.lang.Exception) </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-reserveClass<<span class="error">[=class1,class2,...]</span>></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Used with -autoNameResolution, defines a list of class names for wsdl-to-java <b>not</b> to use when generating classes. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-allowElementReferences<=true></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> (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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-asyncMethods<<span class="error">[=method1,method2,...]</span>></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> List of subsequently generated Java class methods to allow for client-side asynchronous calls, equivalent to enableAsyncMapping in a JAX-WS binding file. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-bareMethods<<span class="error">[=method1,method2,...]</span>></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> List of subsequently generated Java class methods to have wrapper style (see below), equivalent to enableWrapperStyle in JAX-WS binding file. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-mimeMethods<<span class="error">[=method1,method2,...]</span>>*</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> List of subsequent
ly generated Java class methods to enable mime:content mapping, equivalent to enableMIMEContent in JAX-WS binding file. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-faultSerialVersionUID <fault-serialVersionUID></tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> How to generate suid of fault exceptions: NONE</td><td colspan="1" rowspan="1" class="confluenceTd">TIMESTAMP</td><td colspan="1" rowspan="1" class="confluenceTd">FQCN</td><td colspan="1" rowspan="1" class="confluenceTd">####, default is NONE. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>-mark-generated</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> 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. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <em>wsdlurl</em> </td><td colspan="1" rowspan
="1" class="confluenceTd"> The path and name of the WSDL file to use in generating the code. </td></tr></tbody></table>
</div>
<p>You must specify the absolute or relative path to the WSDL document as the last argument.</p>