cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r821731 - in /websites/production/cxf/content: cache/docs.pageCache docs/maven-cxf-codegen-plugin-wsdl-to-java.html
Date Thu, 14 Jun 2012 14:47:55 GMT
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 &lt;sourceRoot&gt;
directory that you specify. Each &lt;wsdlOption&gt; 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 &lt;wsdl&gt; option.</p>
 
-<p>Other configuration arguments can be included inside the &lt;wsdlOption&gt;
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 &lt;sourceRoot&gt; 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 &lt;wsdlOption&gt; 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">&lt;wsdlOptions&gt;</span>
+<span class="code-tag">&lt;configuration&gt;</span>
+    <span class="code-tag">&lt;sourceRoot&gt;</span>${project.build.directory}/generated-code/mywebservice<span
class="code-tag">&lt;/sourceRoot&gt;</span>
+    <span class="code-tag">&lt;wsdlOptions&gt;</span>
 	<span class="code-tag">&lt;wsdlOption&gt;</span>
 		<span class="code-tag">&lt;wsdl&gt;</span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag">&lt;/wsdl&gt;</span>
                 <span class="code-tag">&lt;extraargs&gt;</span>
@@ -163,15 +165,12 @@ Apache CXF -- Maven cxf-codegen-plugin (
                     <span class="code-tag">&lt;extraarg&gt;</span>-verbose<span
class="code-tag">&lt;/extraarg&gt;</span>
                 <span class="code-tag">&lt;/extraargs&gt;</span>
 	<span class="code-tag">&lt;/wsdlOption&gt;</span>
-<span class="code-tag">&lt;/wsdlOptions&gt;</span>
+    <span class="code-tag">&lt;/wsdlOptions&gt;</span>
+<span class="code-tag">&lt;/configuration&gt;</span>
 ...
 </pre>
 </div></div>
 
-
-<p>For CXF 2.1.4 and latter you don't need anymore to specify the &lt;phase&gt;,
as generate-sources is the default.<br clear="none">
-For CXF 2.2 and latter you don't even need to specify the &lt;sourceRoot&gt; 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">&lt;configuration&gt;</span>
-  <span class="code-tag">&lt;sourceRoot&gt;</span>${basedir}/target/generated/cxf<span
class="code-tag">&lt;/sourceRoot&gt;</span>
   <span class="code-tag">&lt;wsdlOptions&gt;</span>
     <span class="code-tag">&lt;wsdlOption&gt;</span>
       <span class="code-tag">&lt;wsdl&gt;</span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag">&lt;/wsdl&gt;</span>
@@ -191,6 +189,7 @@ For CXF 2.2 and latter you don't even ne
 <span class="code-tag">&lt;/configuration&gt;</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">&lt;configuration&gt;</span>
-  <span class="code-tag">&lt;sourceRoot&gt;</span>${basedir}/target/generated/src/main/java<span
class="code-tag">&lt;/sourceRoot&gt;</span>
   <span class="code-tag">&lt;wsdlOptions&gt;</span>
     <span class="code-tag">&lt;wsdlOption&gt;</span>
       <span class="code-tag">&lt;wsdl&gt;</span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag">&lt;/wsdl&gt;</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">&lt;configuration&gt;</span>
-  <span class="code-tag">&lt;sourceRoot&gt;</span>${basedir}/target/generated/cxf<span
class="code-tag">&lt;/sourceRoot&gt;</span>
   <span class="code-tag">&lt;defaultOptions&gt;</span>
       <span class="code-tag">&lt;bindingFiles&gt;</span>
           <span class="code-tag">&lt;bindingFile&gt;</span>${basedir}/src/main/jaxb/bindings.xml<span
class="code-tag">&lt;/bindingFile&gt;</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">&lt;configuration&gt;</span>
-  <span class="code-tag">&lt;sourceRoot&gt;</span>${basedir}/target/generated/cxf<span
class="code-tag">&lt;/sourceRoot&gt;</span>
   <span class="code-tag">&lt;defaultOptions&gt;</span>
       <span class="code-tag">&lt;bindingFiles&gt;</span>
           <span class="code-tag">&lt;bindingFile&gt;</span>${basedir}/src/main/jaxb/bindings.xml<span
class="code-tag">&lt;/bindingFile&gt;</span>
@@ -308,7 +304,6 @@ For CXF 2.2 and latter you don't even ne
     <span class="code-tag">&lt;id&gt;</span>generate-sources<span
class="code-tag">&lt;/id&gt;</span>
     <span class="code-tag">&lt;phase&gt;</span>generate-sources<span
class="code-tag">&lt;/phase&gt;</span>
     <span class="code-tag">&lt;configuration&gt;</span>
-      <span class="code-tag">&lt;sourceRoot&gt;</span>${basedir}/target/generated/src/main/java<span
class="code-tag">&lt;/sourceRoot&gt;</span>
       <span class="code-tag">&lt;wsdlOptions&gt;</span>
         <span class="code-tag">&lt;wsdlOption&gt;</span>
           <span class="code-tag">&lt;wsdl&gt;</span>${basedir}/src/main/wsdl/myService.wsdl<span
class="code-tag">&lt;/wsdl&gt;</span>



Mime
View raw message