<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
JBossWS - AS 7 FAQ
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/asoldano">Alessio Soldano</a> in <i>JBoss Web Services</i> - <a href="http://community.jboss.org/docs/DOC-16722">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><h1>JBossWS - AS 7 FAQ</h1><p>This page is about the JBossWS integration with JBoss Application Server 7, which comes with a completely new architecture based on modules.</p><p><span style="color: #ff9900; font-size: 14pt;"><strong>Since 4.0.0</strong></span></p><h4>Which modules belong to JBossWS? Am I supposed to modify them?</h4><p>The org.jboss.as.webservices.* and org.jboss.ws.* modules belongs to the JBossWS - AS7 integration. Users should not need to change anything in them.</p><h4>I'm getting a ClassNotFoundException with an application that used to work on AS6, what's happening?</h4><p>On JBoss AS7 the user deployment classloader does not have any visibility over JBoss internals; so for instance you can't directly use JBossWS <em>implementation</em> classes unless you explicitly set a dependency to the corresponding module.</p><h4>How do I add dependencies to modules on my deployments?</h4><p>Dependencies are configured in the deployment MANIFEST.MF file:</p><pre class="jive-pre"><code class="jive-code jive-xml">Manifest-Version: 1.0
Dependencies: org.jboss.ws.cxf.jbossws-cxf-client services export, foo.bar
</code></pre><p>Here above <em>org.jboss.ws.cxf.jbossws-cxf-client</em> and <em>foo.bar</em> are the module you want to set dependencies to; <em>services</em> tells the modules framework that you want to also import <em>META-INF/services/..</em> declarations from the dependency, while <em>export</em> exports the classes in the module so that you can actually use them in your code.</p><h4>How can I use JAXB classes?</h4><p>In order for successfully use JAXB contexts, etc. in your client or endpoint running in-container, you need to properly setup a JAXB implementation; that is performed setting the following dependency:</p><pre class="jive-pre"><code class="jive-code jive-xml">Dependencies: com.sun.xml.bind services export
</code></pre><h4>How can I use JBossWS APIs?</h4><p>The JBossWS APIs are always available by default whenever the webservices subsystem is available on AS7. So you just use them.</p><h4>How can I use Apache CXF APIs?</h4><p>In order for using Apache CXF APIs you need to add a dependency to the org.apache.cxf module:</p><pre class="jive-pre"><code class="jive-code jive-xml">Dependencies: org.apache.cxf</code></pre><p>...however, please note that would not come with any JBossWS-CXF customizations nor additional extensions. See next FAQ.</p><h4>Is there an aggregation client side module with all WS dependencies?</h4><p>Yes. Whenever you simply want to use all the JBossWS feature/functionalities, you can set a dependency to the convenient client module. For the JBossWS-CXF stack that's:</p><pre class="jive-pre"><code class="jive-code jive-xml">Dependencies: org.jboss.ws.cxf.jbossws-cxf-client services export</code></pre><h4>What is the org.jboss.ws.jaxws-client module for?</h4><p>That is the generic JAXWS client module that is internally loaded when the first call to the configured JAXWS Provider is performed. Depending on the configured ws stack, that pulls in the required modules for basic jaxws functionalities.</p><h4>How do I use Spring with JBossWS-CXF?</h4><p>The JBossWS-CXF modules have optional dependencies to the <em>org.springframework.spring</em> module. So either create that manually in the application server or use the JBossWS-CXF installation scripts for doing that.</p><h4>What SAAJ impl do I get doing MessageFactory.getFactory()?</h4><p>...</p><h4>My annotations are being ignored (and I get no special warning about that)!</h4><p>When using annotations on your endpoints / handlers such as the Apache CXF ones (@InInterceptor, @GZIP, ...), or JBossWS Native ones (@EndpointConfig, @Documentation, ...) remember to add the proper module dependency in your manifest. Otherwise your annotations are not picked up and added to the annotation index by JBoss AS7, resulting in them being completely ignored (even silently in many cases -this needs to be fixed-).</p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-16722">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Web Services at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2044">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>