Author: buildbot
Date: Mon Apr 27 13:47:13 2015
New Revision: 949349
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jax-ws-configuration.html
websites/production/cxf/content/docs/jaxrs-services-configuration.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jax-ws-configuration.html
==============================================================================
--- websites/production/cxf/content/docs/jax-ws-configuration.html (original)
+++ websites/production/cxf/content/docs/jax-ws-configuration.html Mon Apr 27
13:47:13 2015
@@ -117,14 +117,8 @@ Apache CXF -- JAX-WS Configuration
<td height="100%">
<!-- Content -->
<div class="wiki-content">
-<div id="ConfluenceContent"><p>Please see the <a shape="rect"
href="configuration.html">Configuration</a> section to learn how to supply a
configuration to CXF. The following sections include just JAX-WS specific
configuration items.</p>
-
-<h1 id="JAX-WSConfiguration-ConfiguringanEndpoint">Configuring an Endpoint</h1>
-
-<p>A JAX-WS Endpoint can be configured in XML in addition to using the JAX-WS
APIs. Once you've created your <a shape="rect"
href="developing-a-service.html">server implementation</a>, you simply need to
provide the class name and an address. Here is a simple example:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<beans xmlns="http://www.springframework.org/schema/beans"
+<div id="ConfluenceContent"><p>Please see the <a shape="rect"
href="configuration.html">Configuration</a> section to learn how to supply a
configuration to CXF. The following sections include just JAX-WS specific
configuration items.</p><h1
id="JAX-WSConfiguration-ConfiguringanEndpoint">Configuring an Endpoint</h1><p>A
JAX-WS Endpoint can be configured in XML in addition to using the JAX-WS APIs.
Once you've created your <a shape="rect"
href="developing-a-service.html">server implementation</a>, you simply need to
provide the class name and an address. Here is a simple example:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="
@@ -141,20 +135,8 @@ http://cxf.apache.org/jaxws http://cxf.a
</beans>
]]></script>
-</div></div>
-<p>Be sure to include the JAX-WS <code>schemaLocation</code> attribute
specified on the root beans element. This allows CXF to validate the file and
is required. Also note the namespace declarations at the end of the
<jaxws:endpoint/> tag--these are required because the combined
"{namespace}localName" syntax is presently not supported for this tag's
attribute values.</p>
-
-<p>The <code>jaxws:endpoint</code> element (which appears to create an <a
shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/jaxws/EndpointImpl.html";>EndpointImpl</a>
under the covers) supports many additional attributes:</p>
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Value </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> endpointName </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The endpoint name this service is
implementing, it maps to the wsdl:port@name. In the format of
"ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this scope.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> publish
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether the
endpoint should be published now, or whether it will be published at a later
point. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
serviceName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The
service name this service is implementing, it maps to the wsdl:service@name. In
the format of "ns:SERVICE_
NAME" where ns is a namespace prefix valid at this scope.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
wsdlLocation </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The
location of the WSDL. Can be on the classpath, file system, or be hosted
remotely. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> bindingUri </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The URI, or ID, of the message binding for the
endpoint to use. For SOAP the binding URI(ID) is specified by the JAX-WS
specification. For other message bindings the URI is the namespace of the WSDL
extensions used to specify the binding. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> address </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The service publish address
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> bus
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The bus name that
will be used in the jaxws endpoint. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> implementor </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The implementor of jaxws endpoint. You can
specify the implementor class name here, or just the ref bean name in the
format of "#REF_BEAN_NAME" </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> implementorClass </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The implementor class name, it is really useful when
you specify the implementor with the ref bean which is wrapped by using Spring
AOP </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
createdFromAPI </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
This indicates that the endpoint bean was already created using jaxws API's
thus at runtime when parsing the bean spring can use these values rather than
the default ones. It's important that when this is true, the "name" of the
bean is
set to the port name of the endpoint being created in the form "{<span
class="nolink">http://</span>service.target.namespace}
PortName".</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> publishedEndpointUrl </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The URL that is placed in the address
element of the wsdl when the wsdl is retrieved. If not specified, the address
listed above is used. This parameter allows setting the "public" URL that may
not be the same as the URL the service is deployed on. (for example, the
service is behind a proxy of some sort).</p></td></tr></tbody></table></div>
-
-
-<p>It also supports many child elements:</p>
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Value </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:executor </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> A Java executor which will be used for the
service. This can be supplied using the Spring <bean class="MyExecutor"/>
syntax. </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:inInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The incoming interceptors for this endpoint. A list of
<bean>s or <ref>s. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache
.cxf.phase.PhaseInterceptor</a> </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> jaxws:inFaultInterceptors </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The incoming fault interceptors for this
endpoint. A list of <bean>s or <ref>s. Each should implement <a
shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:outInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing interceptors for this endpoint. A list of
<bean>s or <ref>s. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.
Interceptor</a> or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:outFaultInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing fault interceptors for this endpoint. A
list of <bean>s or <ref>s. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:handlers </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
The JAX-WS handlers for this endpoint. A list of <bean>s or
<ref>s. Each should implement <a shape="r
ect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect"
class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a> (Note that
<code>@HandlerChain</code> annotations on the service bean appear to be
ignored) </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:properties </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
A properties map which should be supplied to the JAX-WS endpoint. See below.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:dataBinding </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring
<bean class="MyDataBinding"/> syntax. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:binding </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> You can specify the BindingFactory for
this endpoint to use. This can be supplied using the Spring <bean
class="MyBindingFactory"/> syntax. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:features </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The features that hold the interceptors
for this endpoint. A list of <bean>s or <ref>s
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:invoker </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The
invoker which will be supplied to this endpoint. This can be supplied using the
Spring <bean class="MyInvoker"/> syntax. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> jaxws:schemaLocations
</p></td><td colspan="1" rowspan="1" cla
ss="confluenceTd"><p> The schema locations for endpoint to use. A list of
<schemaLocation>s </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> jaxws:serviceFactory </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The service factory for this endpoint to
use. This can be supplied using the Spring <bean
class="MyServiceFactory"/> syntax </p></td></tr></tbody></table></div>
-
-<p>Here is a more advanced example which shows how to provide interceptors and
properties:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<beans xmlns="http://www.springframework.org/schema/beans"
+</div></div><p>Be sure to include the JAX-WS <code>schemaLocation</code>
attribute specified on the root beans element. This allows CXF to validate the
file and is required. Also note the namespace declarations at the end of the
<jaxws:endpoint/> tag--these are required because the combined
"{namespace}localName" syntax is presently not supported for this tag's
attribute values.</p><p>The <code>jaxws:endpoint</code> element (which appears
to create an <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/jaxws/EndpointImpl.html";>EndpointImpl</a>
under the covers) supports many additional attributes:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Value</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>endpointName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The endpoint name this service
is implementing, it maps to the wsdl:port@name. In the format of
"ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this
scope.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>publish</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Whether the endpoint should be published now, or
whether it will be published at a later point.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>serviceName</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The service name this service is
implementing, it maps to the wsdl:service@name. In the format of
"ns:SERVICE_NAME" where ns is a namespace prefix valid at this
scope.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>wsdlLocation</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The location of the WSDL. Can be on the classpath, file
system, or be hosted remotely.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>bindingUri</p></td><
td colspan="1" rowspan="1" class="confluenceTd"><p>The URI, or ID, of the
message binding for the endpoint to use. For SOAP the binding URI(ID) is
specified by the JAX-WS specification. For other message bindings the URI is
the namespace of the WSDL extensions used to specify the
binding.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>address</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The service publish address</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>bus</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The bus name that will be used in the jaxws
endpoint.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>implementor</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The implementor of jaxws endpoint. You can specify the
implementor class name here, or just the ref bean name in the format of
"#REF_BEAN_NAME"</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>i
mplementorClass</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The implementor class name, it is really useful when
you specify the implementor with the ref bean which is wrapped by using Spring
AOP</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>createdFromAPI</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>This indicates that the endpoint bean was already
created using jaxws API's thus at runtime when parsing the bean spring can use
these values rather than the default ones. It's important that when this is
true, the "name" of the bean is set to the port name of the endpoint being
created in the form "{<span
class="nolink">http://</span>service.target.namespace}
PortName".</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>publishedEndpointUrl</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The URL that is placed in the address
element of the wsdl when the wsdl is retrieved. If not specified, the address l
isted above is used. This parameter allows setting the "public" URL that may
not be the same as the URL the service is deployed on. (for example, the
service is behind a proxy of some
sort).</p></td></tr></tbody></table></div><p>It also supports many child
elements:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Value</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:executor</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A Java executor which will be used for the service.
This can be supplied using the Spring <bean class="MyExecutor"/>
syntax.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:inInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The incoming interceptors for this
endpoint. A list of <bean>s or <ref>s. Each should implement <a sh
ape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:inFaultInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The incoming fault interceptors for this
endpoint. A list of <bean>s or <ref>s. Each should implement <a
shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:outInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenc
eTd"><p>The outgoing interceptors for this endpoint. A list of <bean>s
or <ref>s. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:outFaultInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The outgoing fault interceptors for this
endpoint. A list of <bean>s or <ref>s. Each should implement <a
shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>jaxws:handlers</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The JAX-WS handlers for this
endpoint. A list of <bean>s or <ref>s. Each should implement <a
shape="rect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect"
class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a> (Note that
<code>@HandlerChain</code> annotations on the service bean appear to be
ignored)</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:properties</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A properties map which should be supplied to the JAX-WS
endpoint. See below.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:dataBinding</p></td><td colspan
="1" rowspan="1" class="confluenceTd"><p>Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring <bean
class="MyDataBinding"/> syntax.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:binding</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>You can specify the BindingFactory for this endpoint to
use. This can be supplied using the Spring <bean
class="MyBindingFactory"/> syntax.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>jaxws:features</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The features that hold the interceptors for
this endpoint. A list of <bean>s or <ref>s</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>jaxws:invoker</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The invoker which will be
supplied to this endpoi
nt. This can be supplied using the Spring <bean class="MyInvoker"/>
syntax.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:schemaLocations</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The schema locations for endpoint to use. A
list of <schemaLocation>s</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:serviceFactory</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The service factory for this endpoint to
use. This can be supplied using the Spring <bean
class="MyServiceFactory"/> syntax</p></td></tr></tbody></table></div><p>Here
is a more advanced example which shows how to provide interceptors and
properties:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:soap="http://cxf.apache.org/bindings/soap"
@@ -203,23 +185,14 @@ http://cxf.apache.org/jaxws http://cxf.a
</beans>
]]></script>
-</div></div>
-<p>If you are a Spring user, you'll notice that the
<code>jaxws:properties</code> element follows the Spring Map syntax.</p>
-
-<h1 id="JAX-WSConfiguration-ConfiguringaSpringClient(Option1)">Configuring a
Spring Client (Option 1)</h1>
-
- <div class="aui-message hint shadowed information-macro">
+</div></div><p>If you are a Spring user, you'll notice that the
<code>jaxws:properties</code> element follows the Spring Map syntax.</p><h1
id="JAX-WSConfiguration-ConfiguringaSpringClient(Option1)">Configuring a Spring
Client (Option 1)</h1> <div class="aui-message hint shadowed
information-macro">
<span class="aui-icon icon-hint">Icon</span>
<div class="message-content">
-
-<p>This technique lets you add a Web Services client to your Spring
application. You can inject it into other Spring beans, or manually retrieve
it from the Spring context for use by non-Spring-aware client code.</p>
+ <p>This technique lets you add a Web Services
client to your Spring application. You can inject it into other Spring beans,
or manually retrieve it from the Spring context for use by non-Spring-aware
client code.</p>
</div>
</div>
-
-<p>The easiest way to add a Web Services client to a Spring context is to use
the <code><jaxws:client></code> element (similar to the
<code><jaxws:endpoint></code> element used for the server side). Here's
a simple example:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<?xml version="1.0" encoding="UTF-8"?>
+<p>The easiest way to add a Web Services client to a Spring context is to use
the <code><jaxws:client></code> element (similar to the
<code><jaxws:endpoint></code> element used for the server side). Here's a
simple example:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<?xml version="1.0"
encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -234,17 +207,8 @@ http://cxf.apache.org/jaxws http://cxf.a
address="http://localhost:9002/HelloWorld" />
</beans>
]]></script>
-</div></div>
-<p>The attributes available on <code><jaxws:client></code> include:</p>
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Type </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> id </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> String </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> A unique identified for the client, which is how other
beans in the context will reference it </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> address </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> URL </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The URL to connect to in order to invoke the service
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
serviceClass </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
Class </p></td><td colspan=
"1" rowspan="1" class="confluenceTd"><p> The fully-qualified name of the
interface that the bean should implement (typically, same as the service
interface used on the server side) </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> serviceName </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> QName </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The name of the service to invoke, if this
address/WSDL hosts several. It maps to the wsdl:service@name. In the format of
"ns:SERVICE_NAME" where ns is a namespace prefix valid at this scope.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
endpointName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
QName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The name of
the endpoint to invoke, if this address/WSDL hosts several. It maps to the
wsdl:port@name. In the format of "ns:ENDPOINT_NAME" where ns is a namespace
prefix valid at this scope. </p>
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> bindingId
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> URI </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> The URI, or ID, of the message
binding for the endpoint to use. For SOAP the binding URI(ID) is specified by
the JAX-WS specification. For other message bindings the URI is the namespace
of the WSDL extensions used to specify the binding. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> bus </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Bean Reference </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The bus name that will be used in the
jaxws endpoint (defaults to <code>cxf</code>). </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> username </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> String </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td></tr><tr><td
colspan="1" rows
pan="1" class="confluenceTd"><p> password </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> String </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> wsdlLocation </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> URL </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> A URL to connect to in order to retrieve the WSDL for
the service. This is not required. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> createdFromAPI </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> boolean </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> This indicates that the client bean was
already created using jaxws API's thus at runtime when parsing the bean spring
can use these values rather than the default ones. It's important that when
this is true, the "name" of the bean is set to the port name of the endpoint
being created in the form
"{<span
class="nolink">http://</span>service.target.namespace}PortName".</p></td></tr></tbody></table></div>
-
-<p>It also supports many child elements:</p>
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Description </p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> jaxws:inInterceptors
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The incoming
interceptors for this endpoint. A list of <code><bean></code> or
<code><ref></code> elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:inFaultInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The incoming fault interceptors for this endpoint
. A list of <code><bean></code> or <code><ref></code> elements.
Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:outInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing interceptors for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements. Each should
implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td><
/tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:outFaultInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing fault interceptors for this endpoint. A
list of <code><bean></code> or <code><ref></code> elements. Each
should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:features </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
The features that hold the interceptors for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
jaxws:handlers </p></td><td colspan="1" rowspan="1" c
lass="confluenceTd"><p> The JAX-WS handlers for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements. Each should
implement <a shape="rect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect"
class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a>. These are more
portable than CXF interceptors, but may cause the full message to be loaded in
as a DOM (slower for large messages). </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:properties </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> A properties map which should be supplied
to the JAX-WS endpoint. See below. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:dataBinding </p></td><td colspan="1"
rowspan="1
" class="confluenceTd"><p> Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring <bean
class="MyDataBinding"/> syntax. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:binding </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> You can specify the BindingFactory for
this endpoint to use. This can be supplied using the Spring <bean
class="MyBindingFactory"/> syntax. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> jaxws:conduitSelector </p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td></tr></tbody></table></div>
-
-<p>Here is a more advanced example which shows how to provide interceptors,
JAX-WS handlers, and properties:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<?xml version="1.0" encoding="UTF-8"?>
+</div></div><p>The attributes available on <code><jaxws:client></code>
include:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>id</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A unique identified for the client, which is how other
beans in the context will reference it</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>address</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>URL</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The URL to connect to in order to invoke the
service</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>serviceClass</p></td><td colspan
="1" rowspan="1" class="confluenceTd"><p>Class</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The fully-qualified name of the interface
that the bean should implement (typically, same as the service interface used
on the server side)</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>serviceName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>QName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The name of the service to invoke, if this address/WSDL
hosts several. It maps to the wsdl:service@name. In the format of
"ns:SERVICE_NAME" where ns is a namespace prefix valid at this
scope.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>endpointName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>QName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The name of the endpoint to invoke, if this
address/WSDL hosts several. It maps to the wsdl:port@name. In the format of
"ns:ENDPOINT_NAME" wher
e ns is a namespace prefix valid at this scope.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>bindingId</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>URI</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The URI, or ID, of the message binding for
the endpoint to use. For SOAP the binding URI(ID) is specified by the JAX-WS
specification. For other message bindings the URI is the namespace of the WSDL
extensions used to specify the binding.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>bus</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Bean Reference</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The bus name that will be used in the jaxws endpoint
(defaults to <code>cxf</code>).</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>username</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p
></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>password</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>wsdlLocation</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>URL</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>A URL to connect to in order to retrieve the WSDL for
>the service. This is not required.</p></td></tr><tr><td colspan="1"
>rowspan="1" class="confluenceTd"><p>createdFromAPI</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>This indicates that the client bean was
>already created using jaxws API's thus at runtime when parsing the bean
>spring can use these values rather than the default ones. It's important that
>when this is true, the "name" of the bean is set to the port name of the
>endpoint being cr
eated in the form "{<span
class="nolink">http://</span>service.target.namespace}PortName".</p></td></tr></tbody></table></div><p>It
also supports many child elements:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>jaxws:inInterceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The incoming interceptors for
this endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1" c
lass="confluenceTd"><p>jaxws:inFaultInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The incoming fault interceptors for this
endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:outInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The outgoing interceptors for this
endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a s
hape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:outFaultInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The outgoing fault interceptors for this
endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>jaxws:features</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The features that hold the
interceptors for this endpoint. A list of <code><bean></code> or
<code><ref>
;</code> elements</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:handlers</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The JAX-WS handlers for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements. Each should
implement <a shape="rect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect"
class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a>. These are more
portable than CXF interceptors, but may cause the full message to be loaded in
as a DOM (slower for large messages).</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>jaxws:properties</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>A properties map which should be supplied
to the JAX-WS endpoint. See
below.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:dataBinding</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring <bean
class="MyDataBinding"/> syntax.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>jaxws:binding</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>You can specify the BindingFactory for this endpoint to
use. This can be supplied using the Spring <bean
class="MyBindingFactory"/> syntax.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>jaxws:conduitSelector</p></td><td
colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td></tr></tbody></table></div><p>Here is a
more advanced example which shows how to provide interceptors, JAX-WS handlers,
and properties:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent
pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<?xml version="1.0"
encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -278,22 +242,14 @@ http://cxf.apache.org/jaxws http://cxf.a
</jaxws:client>
</beans>
]]></script>
-</div></div>
-
-<h1 id="JAX-WSConfiguration-ConfiguringaSpringClient(Option2)">Configuring a
Spring Client (Option 2)</h1>
-
- <div class="aui-message hint shadowed information-macro">
+</div></div><h1
id="JAX-WSConfiguration-ConfiguringaSpringClient(Option2)">Configuring a Spring
Client (Option 2)</h1> <div class="aui-message hint shadowed
information-macro">
<span class="aui-icon icon-hint">Icon</span>
<div class="message-content">
-
-<p>Building a Client using this configuration is only applicable for those
wishing to inject a Client into their Spring ApplicationContext.</p>
+ <p>Building a Client using this configuration is
only applicable for those wishing to inject a Client into their Spring
ApplicationContext.</p>
</div>
</div>
-
-<p>This approach requires more explicit Spring bean configuration than the
previous option, and may require more configuration data depending on which
features are used. To configure a client this way, you'll need to declare a
proxy factory bean and also a client bean which is created by that proxy
factory. Here is an example:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<beans xmlns="http://www.springframework.org/schema/beans"
+<p>This approach requires more explicit Spring bean configuration than the
previous option, and may require more configuration data depending on which
features are used. To configure a client this way, you'll need to declare a
proxy factory bean and also a client bean which is created by that proxy
factory. Here is an example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="
@@ -313,13 +269,8 @@ http://cxf.apache.org/jaxws http://cxf.a
</beans>
]]></script>
-</div></div>
-<p>The JaxWsProxyFactoryBean in this case takes two properties. The service
class, which is the interface of the Client proxy you wish to create. The
address is the address of the service you wish to call.</p>
-
-<p>The second bean definition is for the client. In this case it implements
the HelloWorld interface and is created by the proxyFactory <bean> by
calling the create() method. You can then reference this "client" bean and
inject it anywhere into your application. Here is an example of a very simple
Java class which accesses the client bean:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
-include org.springframework.context.support.ClassPathXmlApplicationContext;
+</div></div><p>The JaxWsProxyFactoryBean in this case takes two properties.
The service class, which is the interface of the Client proxy you wish to
create. The address is the address of the service you wish to call.</p><p>The
second bean definition is for the client. In this case it implements the
HelloWorld interface and is created by the proxyFactory <bean> by calling
the create() method. You can then reference this "client" bean and inject it
anywhere into your application. Here is an example of a very simple Java class
which accesses the client bean:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[include
org.springframework.context.support.ClassPathXmlApplicationContext;
public final class HelloWorldClient {
@@ -338,14 +289,8 @@ public final class HelloWorldClient {
}
}
]]></script>
-</div></div>
-<p>The JaxWsProxyFactoryBean supports many other properties:</p>
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Description </p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> clientFactoryBean </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> The ClientFactoryBean used in
construction of this proxy. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> password </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The password which the transport should use.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> username
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The username
which the transport should use. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> wsdlURL </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The wsdl URL the client should use to configure
itself. </p></td></tr><tr><
td colspan="1" rowspan="1" class="confluenceTd"><p> wsdlLocation </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Appears to be the same as
wsdlURL? </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
serviceName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The
name of the service to invoke, if this address/WSDL hosts several. It maps to
the wsdl:service@name. In the format of "ns:SERVICE_NAME" where ns is a
namespace prefix valid at this scope. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> endpointName </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The name of the endpoint to invoke, if
this address/WSDL hosts several. It maps to the wsdl:port@name. In the format
of "ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this scope.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
inInterceptors </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
The incomin
g interceptors for this endpoint. A list of <code><bean></code> or
<code><ref></code> elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
inFaultInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The incoming fault interceptors for this endpoint. A
list of <code><bean></code> or <code><ref></code> elements. Each
should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.p
hase.PhaseInterceptor</a> </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> outInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing interceptors for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements. Each should
implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
outFaultInterceptors </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The outgoing fault interceptors for this endpoint. A
list of <code><bean></code> or <code><ref></code> elements. Each
should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/intercept
or/Interceptor.html">org.apache.cxf.interceptor.Interceptor</a> or <a
shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a>
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
features </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> The
features that hold the interceptors for this endpoint. A list of
<code><bean></code> or <code><ref></code> elements
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> handlers
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> A list of
<code><bean></code> or <code><ref></code> elements pointing to
JAX-WS handler classes to be used for this client. Each should implement <a
shape="rect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect"
class="external-link" href
="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a>. These are more
portable than CXF interceptors, but may cause the full message to be loaded in
as a DOM (slower for large messages). </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> bindingConfig </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> bindingId </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> The URI, or ID, of the message binding for
the endpoint to use. For SOAP the binding URI(ID) is specified by the JAX-WS
specification. For other message bindings the URI is the namespace of the WSDL
extensions used to specify the binding. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> bus </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> A reference to a CXF bus bean. Must be provided if
, for example, handlers are used. May require additional Spring context
imports (e.g. to bring in the default CXF bus bean). </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> conduitSelector </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> dataBinding </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring <bean
class="MyDataBinding"/> syntax. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> properties </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> A properties map which should be supplied
to the JAX-WS endpoint. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> serviceFactory </p></td><td colspan="1" rowspan="1"
class="
confluenceTd"><p> </p></td></tr></tbody></table></div>
-
-<p>Using some of the properties will require additional configuration in the
Spring context. For instance, using JAX-WS handlers requires that you
explicitly import several CXF Spring configurations, and assign the "bus"
property of the JaxWsProxyFactory bean like this:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<import resource="classpath:META-INF/cxf/cxf.xml" />
+</div></div><p>The JaxWsProxyFactoryBean supports many other
properties:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>clientFactoryBean</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The ClientFactoryBean used in construction
of this proxy.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>password</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The password which the transport should
use.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>username</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The username which the transport should
use.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>wsdlURL</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The wsdl URL the c
lient should use to configure itself.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>wsdlLocation</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Appears to be the same as
wsdlURL?</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>serviceName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The name of the service to invoke, if this address/WSDL
hosts several. It maps to the wsdl:service@name. In the format of
"ns:SERVICE_NAME" where ns is a namespace prefix valid at this
scope.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>endpointName</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The name of the endpoint to invoke, if this
address/WSDL hosts several. It maps to the wsdl:port@name. In the format of
"ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this
scope.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>inInterceptors</p></td><td colspan="1" rowspan=
"1" class="confluenceTd"><p>The incoming interceptors for this endpoint. A
list of <code><bean></code> or <code><ref></code> elements. Each
should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>inFaultInterceptors</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The incoming fault interceptors for this endpoint. A
list of <code><bean></code> or <code><ref></code> elements. Each
should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseIn
terceptor.html">org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>outInterceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The outgoing interceptors for
this endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/interceptor/Interceptor.html";>org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>outFaultInterceptors</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The outgoing fault interceptors for this
endpoint. A list of <code><bean></code> or <code><ref></code>
elements. Each should implement <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/or
g/apache/cxf/interceptor/Interceptor.html">org.apache.cxf.interceptor.Interceptor</a>
or <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/phase/PhaseInterceptor.html";>org.apache.cxf.phase.PhaseInterceptor</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>features</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>The features that hold the
interceptors for this endpoint. A list of <code><bean></code> or
<code><ref></code> elements</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>handlers</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A list of <code><bean></code> or
<code><ref></code> elements pointing to JAX-WS handler classes to be used
for this client. Each should implement <a shape="rect" class="external-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/Handler.html";
rel="nofollow">javax.xml.ws.handler.Handler</a> or <a shape="rect" class="extern
al-link"
href="http://java.sun.com/javase/6/docs/api/javax/xml/ws/handler/soap/SOAPHandler.html";
rel="nofollow">javax.xml.ws.handler.soap.SOAPHandler</a>. These are more
portable than CXF interceptors, but may cause the full message to be loaded in
as a DOM (slower for large messages).</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>bindingConfig</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>bindingId</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The URI, or ID, of the message binding for
the endpoint to use. For SOAP the binding URI(ID) is specified by the JAX-WS
specification. For other message bindings the URI is the namespace of the WSDL
extensions used to specify the binding.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>bus</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A reference to a CXF bus bean. Must be provided i
f, for example, handlers are used. May require additional Spring context
imports (e.g. to bring in the default CXF bus bean).</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>conduitSelector</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>dataBinding</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Which <a shape="rect"
href="http://cxf.apache.org/javadoc/latest/org/apache/cxf/databinding/DataBinding.html";>DataBinding</a>
to use in the endpoint. This can be supplied using the Spring <bean
class="MyDataBinding"/> syntax.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>properties</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>A properties map which should be supplied to the JAX-WS
endpoint.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>serviceFactory</p></td><td colspan="1" rowspan="1"
class="confluenceTd"
><p> </p></td></tr></tbody></table></div><p>Using some of the properties
>will require additional configuration in the Spring context. For instance,
>using JAX-WS handlers requires that you explicitly import several CXF Spring
>configurations, and assign the "bus" property of the JaxWsProxyFactory bean
>like this:</p><div class="code panel pdl" style="border-width: 1px;"><div
>class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<import
resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml"
/>
<import resource="classpath:META-INF/cxf/cxf-extension-http.xml"
/>
@@ -355,16 +300,8 @@ public final class HelloWorldClient {
<property name="bus" ref="cxf" />
</bean>
]]></script>
-</div></div>
-
-<h1
id="JAX-WSConfiguration-ConfiguringanEndpoint/ClientProxyUsingCXFAPIs">Configuring
an Endpoint/Client Proxy Using CXF APIs</h1>
-
-<p>JAX-WS endpoints and client proxies are implemented on top of CXF's
frontend-neutral endpoint API. You can therefore use CXF APIs to enhance the
functionality of a JAX-WS endpoint or client proxy, for example by adding
interceptors.</p>
-
-<p>To cast a client proxy to a CXF client:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
-GreeterService gs = new GreeterService();
+</div></div><h1
id="JAX-WSConfiguration-ConfiguringanEndpoint/ClientProxyUsingCXFAPIs">Configuring
an Endpoint/Client Proxy Using CXF APIs</h1><p>JAX-WS endpoints and client
proxies are implemented on top of CXF's frontend-neutral endpoint API. You can
therefore use CXF APIs to enhance the functionality of a JAX-WS endpoint or
client proxy, for example by adding interceptors.</p><p>To cast a client proxy
to a CXF client:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[GreeterService gs = new GreeterService();
Greeter greeter = gs.getGreeterPort();
org.apache.cxf.endpoint.Client client =
@@ -372,11 +309,8 @@ org.apache.cxf.frontend.ClientProxy.getC
org.apache.cxf.endpoint.Endpoint cxfEndpoint = client.getEndpoint();
cxfEndpoint.getOutInterceptors().add(...);
]]></script>
-</div></div>
-<p>To cast a JAX-WS endpoint to a CXF server:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
-javax.xml.ws.Endpoint jaxwsEndpoint = javax.xml.ws.Endpoint.publish(
+</div></div><p>To cast a JAX-WS endpoint to a CXF server:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[javax.xml.ws.Endpoint jaxwsEndpoint =
javax.xml.ws.Endpoint.publish(
"http://localhost:9020/SoapContext/GreeterPort", new
GreeterImpl());
org.apache.cxf.jaxws.EndpointImpl jaxwsEndpointImpl =
(org.apache.cxf.jaxws.EndpointImpl)jaxwsEndpoint;
@@ -386,14 +320,8 @@ cxfEndpoint.getOutInterceptors().add(...
org.apache.cxf.service.Service cxfService = cxfEndpoint.getService();
cxfService.getOutInterceptors().add(...);
]]></script>
-</div></div>
-
-<h1
id="JAX-WSConfiguration-ConfiguretheJAXWSServer/ClientUsingSpring">Configure
the JAXWS Server/Client Using Spring</h1>
-
-<p>CXF provides <jaxws:server>, <jaxws:client> to configure the
server/client side endpoint. Here are some examples:</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[
-<beans xmlns="http://www.springframework.org/schema/beans"
+</div></div><h1
id="JAX-WSConfiguration-ConfiguretheJAXWSServer/ClientUsingSpring">Configure
the JAXWS Server/Client Using Spring</h1><p>CXF provides <jaxws:server>,
<jaxws:client> to configure the server/client side endpoint. Here are
some examples:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:soap="http://cxf.apache.org/bindings/soap"
@@ -443,8 +371,60 @@ cxfService.getOutInterceptors().add(...)
</beans>
]]></script>
-</div></div>
-<p>Since JAX-WS frontend server and client spring configuration parser are
inherited from the simple frontend, please see <a shape="rect"
href="simple-frontend-configuration.html">Simple Frontend Configuration</a> for
the attribute and element definitions. </p></div>
+</div></div><p>Since JAX-WS frontend server and client spring configuration
parser are inherited from the simple frontend, please see <a shape="rect"
href="simple-frontend-configuration.html">Simple Frontend Configuration</a> for
the attribute and element definitions.</p><p> </p><h1
id="JAX-WSConfiguration-ConfiguretheJAXWSServerUsingSpringBoot">Configure the
JAXWS Server Using SpringBoot</h1><p>Here is an example:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[import org.apache.cxf.Bus;
+import org.apache.cxf.jaxws.EndpointImpl;
+import org.apache.cxf.transport.servlet.CXFServlet;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import
org.springframework.boot.context.embedded.EmbeddedServletContainerFactory;
+import org.springframework.boot.context.embedded.ServletRegistrationBean;
+import org.springframework.boot.context.web.SpringBootServletInitializer;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.ImportResource;
+
+@Configuration
+@EnableAutoConfiguration
+@ImportResource({ "classpath:META-INF/cxf/cxf.xml" })
+public class Application extends SpringBootServletInitializer {
+
+ @Autowired
+ private ApplicationContext applicationContext;
+
+ public static void main(String[] args) {
+ SpringApplication.run(Application.class, args);
+ }
+
+ // Replaces the need for web.xml
+ @Bean
+ public ServletRegistrationBean servletRegistrationBean(ApplicationContext
context) {
+ return new ServletRegistrationBean(new CXFServlet(),
"/api/*");
+ }
+
+ // Replaces cxf-servlet.xml
+ @Bean
+ // <jaxws:endpoint id="helloWorld"
implementor="demo.spring.service.HelloWorldImpl"
address="/HelloWorld"/>
+ public EndpointImpl helloService() {
+ Bus bus = (Bus) applicationContext.getBean(Bus.DEFAULT_BUS_ID);
+ Object implementor = new HelloWorldImpl();
+ EndpointImpl endpoint = new EndpointImpl(bus, implementor);
+ endpoint.publish("/hello");
+ return endpoint;
+ }
+
+
+ // Used when deploying to a standalone servlet container, i.e. tomcat
+ @Override
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder
application) {
+ return application.sources(Application.class);
+ }
+
+}]]></script>
+</div></div><p> </p><p> </p></div>
</div>
<!-- Content -->
</td>
Modified: websites/production/cxf/content/docs/jaxrs-services-configuration.html
==============================================================================
--- websites/production/cxf/content/docs/jaxrs-services-configuration.html
(original)
+++ websites/production/cxf/content/docs/jaxrs-services-configuration.html Mon
Apr 27 13:47:13 2015
@@ -118,13 +118,13 @@ Apache CXF -- JAXRS Services Configurati
<!-- Content -->
<div class="wiki-content">
<div
id="ConfluenceContent"><p> </p><p> </p><p> </p><p> <span
class="inline-first-p" style="font-size:2em;font-weight:bold">JAX-RS : Services
Configuration</span> </p><p> </p><p> </p><p> </p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1422971215270 {padding: 0px;}
-div.rbtoc1422971215270 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1422971215270 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1430142415111 {padding: 0px;}
+div.rbtoc1430142415111 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1430142415111 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1422971215270">
+/*]]>*/</style></p><div class="toc-macro rbtoc1430142415111">
<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-ConfiguringJAX-RSservicesprogrammatically">Configuring
JAX-RS services programmatically</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-OSGI">OSGI</a>
-<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-Blueprint">Blueprint</a></li><li><a
shape="rect" href="#JAXRSServicesConfiguration-Spring">Spring</a></li></ul>
+<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-Blueprint">Blueprint</a></li><li><a
shape="rect" href="#JAXRSServicesConfiguration-Spring">Spring</a></li><li><a
shape="rect" href="#JAXRSServicesConfiguration-SpringBoot">Spring
Boot</a></li></ul>
</li><li><a shape="rect"
href="#JAXRSServicesConfiguration-ConfiguringJAX-RSendpointsprogrammaticallywithoutSpring">Configuring
JAX-RS endpoints programmatically without Spring</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-ConfiguringJAX-RSservicesincontainerwithSpringconfigurationfile.">Configuring
JAX-RS services in container with Spring configuration file.</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-web.xml">web.xml</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-UsingSpringContextLoaderListener">Using
Spring ContextLoaderListener</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-UsingCXFServletinitparameters">Using
CXFServlet init parameters</a></li></ul>
@@ -203,7 +203,57 @@ sf.create();
</beans>
]]></script>
-</div></div><h1
id="JAXRSServicesConfiguration-ConfiguringJAX-RSendpointsprogrammaticallywithoutSpring">Configuring
JAX-RS endpoints programmatically without Spring</h1><p>Note that even though
no Spring is explicitly used in the previous section, it is still used by
default to have various CXF components registered with the bus such as
transport factories. If no Spring libraries are available on the classpath then
please follow the following example :</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h2 id="JAXRSServicesConfiguration-SpringBoot">Spring
Boot</h2><p>Example:</p><p> </p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[import org.apache.cxf.Bus;
+import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;
+import org.apache.cxf.transport.servlet.CXFServlet;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import
org.springframework.boot.context.embedded.EmbeddedServletContainerFactory;
+import org.springframework.boot.context.embedded.ServletRegistrationBean;
+import org.springframework.boot.context.web.SpringBootServletInitializer;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.ImportResource;
+
+@Configuration
+@EnableAutoConfiguration
+@ImportResource({ "classpath:META-INF/cxf/cxf.xml" })
+public class Application extends SpringBootServletInitializer {
+
+ @Autowired
+ private ApplicationContext applicationContext;
+
+ public static void main(String[] args) {
+ SpringApplication.run(Application.class, args);
+ }
+
+ // Replaces the need for web.xml
+ @Bean
+ public ServletRegistrationBean servletRegistrationBean(ApplicationContext
context) {
+ return new ServletRegistrationBean(new CXFServlet(),
"/api/*");
+ }
+
+ @Bean
+ public Server helloRestService() {
+ Bus bus = (Bus) applicationContext.getBean(Bus.DEFAULT_BUS_ID);
+ JAXRSServerFactoryBean endpoint = new EndpointImpl(bus, implementor);
+ endpoint.setAddress("/hello");
+ endpoint.setServiceBean(new HelloWorldRestImpl());
+ return endpoint.create();
+ }
+
+ // Used when deploying to a standalone servlet container, i.e. tomcat
+ @Override
+ protected SpringApplicationBuilder configure(SpringApplicationBuilder
application) {
+ return application.sources(Application.class);
+ }
+
+}]]></script>
+</div></div><p>Please also check the classes in this <a shape="rect"
class="external-link"
href="https://git-wip-us.apache.org/repos/asf?p=cxf.git;a=tree;f=rt/frontend/jaxrs/src/main/java/org/apache/cxf/jaxrs/spring;h=2c0dc8fef3aa4fdbd06cbedcd93e0f329739711b;hb=HEAD";>package</a>.</p><p> </p><h1
id="JAXRSServicesConfiguration-ConfiguringJAX-RSendpointsprogrammaticallywithoutSpring">Configuring
JAX-RS endpoints programmatically without Spring</h1><p>Note that even though
no Spring is explicitly used in the previous section, it is still used by
default to have various CXF components registered with the bus such as
transport factories. If no Spring libraries are available on the classpath then
please follow the following example :</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><