Author: buildbot
Date: Thu Jun 14 14:47:54 2012
New Revision: 821731
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/maven-cxf-codegen-plugin-wsdl-to-java.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified:
websites/production/cxf/content/docs/maven-cxf-codegen-plugin-wsdl-to-java.html
==============================================================================
---
websites/production/cxf/content/docs/maven-cxf-codegen-plugin-wsdl-to-java.html
(original)
+++
websites/production/cxf/content/docs/maven-cxf-codegen-plugin-wsdl-to-java.html
Thu Jun 14 14:47:54 2012
@@ -150,12 +150,14 @@ Apache CXF -- Maven cxf-codegen-plugin (
</div></div>
<p>In this example we're running the wsdl2java goal in the generate-sources
phase. By running <b>mvn generate-sources</b>, CXF will generate artifacts in
the <sourceRoot> directory that you specify. Each <wsdlOption>
element corresponds to a WSDL that you're generated artifacts for. In the above
example we're generating we're specifying the WSDL location via the
<wsdl> option.</p>
-<p>Other configuration arguments can be included inside the <wsdlOption>
element. These pass arguments to the tooling and correspond to the options
outlined on the <a shape="rect" href="wsdl-to-java.html" title="WSDL to
Java">WSDL to Java</a> page, for example:</p>
+<p>The following example shows some customization options. By default, the
codegen plugin follows the Maven convention of "target/generated-sources/cxf"
for the output folder for the generated classes. You can override this value
using <sourceRoot> as shown below, but note this is usually not
necessary, the default is fine for most people and can make it easier for some
IDE's to detect the generated source code. Other configuration arguments can
be included inside the <wsdlOption> element. These pass arguments to the
tooling and correspond to the options outlined on the <a shape="rect"
href="wsdl-to-java.html" title="WSDL to Java">WSDL to Java</a> page.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
...
-<span class="code-tag"><wsdlOptions></span>
+<span class="code-tag"><configuration></span>
+ <span
class="code-tag"><sourceRoot></span>${project.build.directory}/generated-code/mywebservice<span
class="code-tag"></sourceRoot></span>
+ <span class="code-tag"><wsdlOptions></span>
<span class="code-tag"><wsdlOption></span>
<span
class="code-tag"><wsdl></span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag"></wsdl></span>
<span class="code-tag"><extraargs></span>
@@ -163,15 +165,12 @@ Apache CXF -- Maven cxf-codegen-plugin (
<span
class="code-tag"><extraarg></span>-verbose<span
class="code-tag"></extraarg></span>
<span class="code-tag"></extraargs></span>
<span class="code-tag"></wsdlOption></span>
-<span class="code-tag"></wsdlOptions></span>
+ <span class="code-tag"></wsdlOptions></span>
+<span class="code-tag"></configuration></span>
...
</pre>
</div></div>
-
-<p>For CXF 2.1.4 and latter you don't need anymore to specify the
<phase>, as generate-sources is the default.<br clear="none">
-For CXF 2.2 and latter you don't even need to specify the <sourceRoot>
to match maven convention for using target/generated-sources/cxf as output
folder for generated classes.</p>
-
<p>See <a shape="rect" class="external-link"
href="http://www.jroller.com/gmazza/entry/web_service_tutorial";
rel="nofollow">this blog entry</a> for a full service and client example that
uses the cxf-codegen-plugin.</p>
<h3><a shape="rect"
name="Mavencxf-codegen-plugin%28WSDLtoJava%29-Example1%3APassinginaJAXWSBindingfile"></a>Example
1: Passing in a JAX-WS Binding file</h3>
@@ -179,7 +178,6 @@ For CXF 2.2 and latter you don't even ne
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><configuration></span>
- <span
class="code-tag"><sourceRoot></span>${basedir}/target/generated/cxf<span
class="code-tag"></sourceRoot></span>
<span class="code-tag"><wsdlOptions></span>
<span class="code-tag"><wsdlOption></span>
<span
class="code-tag"><wsdl></span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag"></wsdl></span>
@@ -191,6 +189,7 @@ For CXF 2.2 and latter you don't even ne
<span class="code-tag"></configuration></span>
</pre>
</div></div>
+
<p>In this example we're specifying that we want CXF to use our JAX-WS binding
file. Binding files are a way to customize the output of the artifacts that CXF
generates. For instance, it allows you to change the package name CXF uses.</p>
<h3><a shape="rect"
name="Mavencxf-codegen-plugin%28WSDLtoJava%29-Example2%3ASpecifyingaservicetogenerateartifactsfor"></a>Example
2: Specifying a service to generate artifacts for</h3>
@@ -198,7 +197,6 @@ For CXF 2.2 and latter you don't even ne
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><configuration></span>
- <span
class="code-tag"><sourceRoot></span>${basedir}/target/generated/src/main/java<span
class="code-tag"></sourceRoot></span>
<span class="code-tag"><wsdlOptions></span>
<span class="code-tag"><wsdlOption></span>
<span
class="code-tag"><wsdl></span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag"></wsdl></span>
@@ -217,7 +215,6 @@ For CXF 2.2 and latter you don't even ne
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><configuration></span>
- <span
class="code-tag"><sourceRoot></span>${basedir}/target/generated/cxf<span
class="code-tag"></sourceRoot></span>
<span class="code-tag"><defaultOptions></span>
<span class="code-tag"><bindingFiles></span>
<span
class="code-tag"><bindingFile></span>${basedir}/src/main/jaxb/bindings.xml<span
class="code-tag"></bindingFile></span>
@@ -247,7 +244,6 @@ For CXF 2.2 and latter you don't even ne
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml">
<span class="code-tag"><configuration></span>
- <span
class="code-tag"><sourceRoot></span>${basedir}/target/generated/cxf<span
class="code-tag"></sourceRoot></span>
<span class="code-tag"><defaultOptions></span>
<span class="code-tag"><bindingFiles></span>
<span
class="code-tag"><bindingFile></span>${basedir}/src/main/jaxb/bindings.xml<span
class="code-tag"></bindingFile></span>
@@ -308,7 +304,6 @@ For CXF 2.2 and latter you don't even ne
<span class="code-tag"><id></span>generate-sources<span
class="code-tag"></id></span>
<span class="code-tag"><phase></span>generate-sources<span
class="code-tag"></phase></span>
<span class="code-tag"><configuration></span>
- <span
class="code-tag"><sourceRoot></span>${basedir}/target/generated/src/main/java<span
class="code-tag"></sourceRoot></span>
<span class="code-tag"><wsdlOptions></span>
<span class="code-tag"><wsdlOption></span>
<span
class="code-tag"><wsdl></span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag"></wsdl></span>
