geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v3.0 > Configuring JAX-WS engine
Date Wed, 26 Jan 2011 06:45:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/9/4/_/styles/combined.css?spaceKey=GMOxDOC30&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Configuring+JAX-WS+engine">Configuring
JAX-WS engine</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~maojia508">maojia</a>
    </h4>
        <br/>
                         <h4>Changes (2)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >By default, CXF will use Sun&#39;s
SOAP with Attachments API for Java (SAAJ) implementation. That implementation requires Sun
JDK. There are a few options for platforms where Sun JDK is not available: <br> <br></td></tr>
            <tr><td class="diff-changed-lines" ># Switch to Axis2 SAAJ implementation.
In <span class="diff-changed-words">Geronimo<span class="diff-added-chars"style="background-color:
#dfd;">,</span></span> you can configure which SAAJ provider should be used
by setting the *org.apache.geronimo.saaj.provider* system property. To use <span class="diff-added-words"style="background-color:
#dfd;">the</span> Axis2 SAAJ <span class="diff-changed-words">implementation<span
class="diff-added-chars"style="background-color: #dfd;">,</span></span> set
the *org.apache.geronimo.saaj.provider* system property to &quot;*axis2*&quot;. For
example: <br></td></tr>
            <tr><td class="diff-unchanged" >\\ <br>On a Windows system:
*{{set GERONIMO_OPTS=-Dorg.apache.geronimo.saaj.provider=axis2}}* <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >\\ <br>{note} <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Please
note</span> <span class="diff-added-words"style="background-color: #dfd;">Note</span>
that these options have not been tested. <br></td></tr>
            <tr><td class="diff-unchanged" >{note} <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
class='ScrollbarPrevIcon'><a href="/confluence/display/GMOxDOC30/Configuring+EJB+Containers"><img
border='0' align='middle' src='/confluence/images/icons/back_16.gif' width='16' height='16'></a></td><td
width='33%' class='ScrollbarPrevName'><a href="/confluence/display/GMOxDOC30/Configuring+EJB+Containers">Configuring
EJB Containers</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC30/Configuring+and+administering+the+Apache+Geronimo+Server"><img
border='0' align='middle' src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC30/Configuring+and+administering+the+Apache+Geronimo+Server">Configuring
and administering the Apache Geronimo Server</a></td><td width='33%' class='ScrollbarNextName'>&nbsp;<a
href="/confluence/display/GMOxDOC30/Configuring+the+JMS+server">Configuring the JMS server</a></td><td
class='ScrollbarNextIcon'><a href="/confluence/display/GMOxDOC30/Configuring+the+JMS+server"><img
border='0' align='middle' src='/confluence/images/icons/forwd_16.gif' width='16' height='16'></a></td></tr></table></div>
<p>Apache Geronimo is distributed with two JAX-WS engines: <a href="http://ws.apache.org/axis2/"
class="external-link" rel="nofollow">Apache Axis2</a> and <a href="http://incubator.apache.org/cxf/"
class="external-link" rel="nofollow">Apache CXF</a>.  The Geronimo-Jetty assembly
defaults to use CXF as its JAX-WS engine whereas the Geronimo-Tomcat assembly uses Axis2.</p>

<p>There are two ways to configure which JAX-WS engine should be used:</p>
<ul>
	<li><a href="#ConfiguringJAX-WSengine-Settingasystemproperty">Setting a system
property</a></li>
	<li><a href="#ConfiguringJAX-WSengine-Changingtheconfigurationfile">Changing
the configuration file</a></li>
</ul>


<h3><a name="ConfiguringJAX-WSengine-Settingasystemproperty"></a>Setting
a system property</h3>

<p>To configure <b>Axis2</b> as Geronimo's JAX-WS engine, set the <b>org.apache.geronimo.jaxws.provider</b>
system property to "<b>axis2</b>". For example:</p>

<p>On a Windows system: <b><tt>set GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=axis2</tt></b><br/>
On a Unix-like system: <b><tt>export GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=axis2</tt></b></p>

<p>To configure <b>CXF</b> as Geronimo's JAX-WS engine, set the <b>org.apache.geronimo.jaxws.provider</b>
system property to "<b>cxf</b>". For example:</p>

<p>On a Windows system: <b><tt>set GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=cxf</tt></b><br/>
On a Unix-like system: <b><tt>export GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=cxf</tt></b></p>

<h3><a name="ConfiguringJAX-WSengine-Changingtheconfigurationfile"></a>Changing
the configuration file</h3>

<p>To configure <b>Axis2</b> as Geronimo's JAX-WS engine, modify the <tt>&lt;GERONIMO_HOME&gt;/var/config/config.xml</tt>
file in the following way:</p>

<ol>
	<li>Remove the <b>condition</b> attribute and add the <b>load="false"</b>
attribute to <b>org.apache.geronimo.configs/cxf-deployer//car</b> module.</li>
	<li>Remove the <b>condition</b> attribute and add the <b>load="true"</b>
attribute to <b>org.apache.geronimo.configs/axis2-deployer//car</b> module.</li>
</ol>


<p>To configure <b>CXF</b> as Geronimo's JAX-WS engine, modify the <tt>&lt;GERONIMO_HOME&gt;/var/config/config.xml</tt>
file in the following way:</p>

<ol>
	<li>Remove the <b>condition</b> attribute and add the <b>load="false"</b>
attribute to <b>org.apache.geronimo.configs/axis2-deployer//car</b> module.</li>
	<li>Remove the <b>condition</b> attribute and add the <b>load="true"</b>
attribute to <b>org.apache.geronimo.configs/cxf-deployer//car</b> module.</li>
</ol>


<h2><a name="ConfiguringJAX-WSengine-SAAJengine"></a>SAAJ engine</h2>

<p>By default, CXF will use Sun's SOAP with Attachments API for Java (SAAJ) implementation.
That implementation requires Sun JDK. There are a few options for platforms where Sun JDK
is not available:</p>

<ol>
	<li>Switch to Axis2 SAAJ implementation. In Geronimo, you can configure which SAAJ
provider should be used by setting the <b>org.apache.geronimo.saaj.provider</b>
system property. To use the Axis2 SAAJ implementation, set the <b>org.apache.geronimo.saaj.provider</b>
system property to "<b>axis2</b>". For example: <br class="atl-forced-newline"
/>
<br class="atl-forced-newline" />
On a Windows system: <b><tt>set GERONIMO_OPTS=-Dorg.apache.geronimo.saaj.provider=axis2</tt></b><br/>
On a Unix-like system:  <b><tt>export GERONIMO_OPTS=-Dorg.apache.geronimo.saaj.provider=axis2</tt></b>
<br class="atl-forced-newline" />
<br class="atl-forced-newline" /></li>
	<li>Add Sun XML parser jar to the classpath. Download: <a href="https://maven-repository.dev.java.net/nonav/repository/com.sun.xml.parsers/jars/jaxp-ri-1.4.2.jar"
class="external-link" rel="nofollow">https://maven-repository.dev.java.net/nonav/repository/com.sun.xml.parsers/jars/jaxp-ri-1.4.2.jar</a>
and put it in the <tt>&lt;GERONIMO_HOME&gt;/lib/endorsed/</tt> directory.
<br class="atl-forced-newline" />
<br class="atl-forced-newline" />
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/warning.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td>Note that these options have not
been tested.</td></tr></table></div></li>
</ol>

    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Configuring+JAX-WS+engine">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20645456&revisedVersion=2&originalVersion=1">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDOC30/Configuring+JAX-WS+engine?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message