Author: buildbot
Date: Tue Oct 6 21:47:11 2015
New Revision: 968007
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
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/jaxrs-services-configuration.html
==============================================================================
--- websites/production/cxf/content/docs/jaxrs-services-configuration.html
(original)
+++ websites/production/cxf/content/docs/jaxrs-services-configuration.html Tue
Oct 6 21:47:11 2015
@@ -118,14 +118,18 @@ 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.rbtoc1444049207952 {padding: 0px;}
-div.rbtoc1444049207952 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1444049207952 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1444167992021 {padding: 0px;}
+div.rbtoc1444167992021 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1444167992021 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1444049207952">
+/*]]>*/</style></p><div class="toc-macro rbtoc1444167992021">
<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>
-</li><li><a shape="rect" href="#JAXRSServicesConfiguration-SpringBoot">Spring
Boot</a></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>
+</li><li><a shape="rect" href="#JAXRSServicesConfiguration-SpringBoot">Spring
Boot</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-ConfiguringJAX-RSendpointsprogrammaticallywithoutSpring">Configuring
JAX-RS endpoints programmatically without Spring</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-BlueprintWeb">Blueprint Web</a>
+<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-Mavendependencies">Maven dependencies</a>
+<ul class="toc-indentation"><li><a shape="rect"
href="#JAXRSServicesConfiguration-OSGI.1">OSGI</a></li><li><a shape="rect"
href="#JAXRSServicesConfiguration-ServletContainer">Servlet
Container</a></li></ul>
+</li><li><a shape="rect"
href="#JAXRSServicesConfiguration-Commonexample">Common example</a></li></ul>
+</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>
</li><li><a shape="rect"
href="#JAXRSServicesConfiguration-beans.xml">beans.xml</a></li></ul>
@@ -260,7 +264,28 @@ factory.setBus(sf.getBus());
manager.registerBindingFactory(JAXRSBindingFactory.JAXRS_BINDING_ID, factory);
sf.create();
</pre>
-</div></div><h1
id="JAXRSServicesConfiguration-ConfiguringJAX-RSservicesincontainerwithSpringconfigurationfile.">Configuring
JAX-RS services in container with Spring configuration file.</h1><h2
id="JAXRSServicesConfiguration-web.xml">web.xml</h2><p>In web.xml one needs to
register one or more CXFServlet(s) and link to an application context
configuration.</p><h3
id="JAXRSServicesConfiguration-UsingSpringContextLoaderListener">Using Spring
ContextLoaderListener</h3><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
+</div></div><h1 id="JAXRSServicesConfiguration-BlueprintWeb">Blueprint
Web</h1><p>This section describes how CXF JAX-RS endpoints can be bootstrapped
with CXFBlueprintServlet and Blueprint contexts.</p><p>This approach is
recommended for developers building CXF JAX-RS endpoints to be deployed in OSGI
and which will do RequestDispatcher-based forrwards.</p><p>Additionally it
allows to reuse the same Blueprint contexts between OSGI and non-OSGI
deployments.</p><p>Both options below work with CXF 3.1.3:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: xml; gutter: false; theme: Default"
style="font-size:12px;"><dependency>
+ <groupId>org.apache.cxf</groupId>
+ <artifactId>cxf-rt-frontend-jaxrs</artifactId>
+ <version>3.1.3</version>
+</dependency>
+</pre>
+</div></div><p> </p><h2
id="JAXRSServicesConfiguration-Mavendependencies">Maven dependencies</h2><h3
id="JAXRSServicesConfiguration-OSGI.1">OSGI</h3><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<pre class="brush: xml; gutter: false; theme: Default"
style="font-size:12px;"><dependency>
+ <groupId>org.apache.aries.blueprint</groupId>
+ <artifactId>org.apache.aries.blueprint.webosgi</artifactId>
+ <version>1.0.1</version>
+</dependency>
+</pre>
+</div></div><p>In OSGI (Karaf) one should also install a 'war' feature.</p><h3
id="JAXRSServicesConfiguration-ServletContainer">Servlet Container</h3><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+<pre class="brush: xml; gutter: false; theme: Default"
style="font-size:12px;"><dependency>
+ <groupId>org.apache.aries.blueprint</groupId>
+ <artifactId>org.apache.aries.blueprint.web</artifactId>
+ <version>1.1.1</version>
+</dependency>
+</pre>
+</div></div><p> </p><h2
id="JAXRSServicesConfiguration-Commonexample">Common
example</h2><p> </p><p>This <a shape="rect" class="external-link"
href="https://github.com/apache/cxf/blob/master/systests/jaxrs/src/test/resources/jaxrs_soap_blueprint/WEB-INF/web.xml";
rel="nofollow">web.xml</a> shows how to setup CXFBlueprintServlet which
process <a shape="rect" class="external-link"
href="https://github.com/apache/cxf/blob/master/systests/jaxrs/src/test/resources/jaxrs_soap_blueprint/WEB-INF/beans.xml";
rel="nofollow">this Blueprint context.</a> It works exactly the same way in
OSGI and non-OSGI environments.</p><h1
id="JAXRSServicesConfiguration-ConfiguringJAX-RSservicesincontainerwithSpringconfigurationfile.">Configuring
JAX-RS services in container with Spring configuration file.</h1><h2
id="JAXRSServicesConfiguration-web.xml">web.xml</h2><p>In web.xml one needs to
register one or more CXFServlet(s) and link to an application context
configuration.</p><h3 id="JAXRSServicesCon
figuration-UsingSpringContextLoaderListener">Using Spring
ContextLoaderListener</h3><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
<pre class="brush: xml; gutter: false; theme: Default"
style="font-size:12px;"><?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
