Author: buildbot
Date: Wed Sep 14 12:47:39 2016
New Revision: 997379
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/main.pageCache
websites/production/cxf/content/distributed-osgi-reference.html
Modified: websites/production/cxf/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/distributed-osgi-reference.html
==============================================================================
--- websites/production/cxf/content/distributed-osgi-reference.html (original)
+++ websites/production/cxf/content/distributed-osgi-reference.html Wed Sep 14
12:47:39 2016
@@ -110,17 +110,17 @@ Apache CXF -- Distributed OSGi Reference
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><h1
id="DistributedOSGiReference-DistributedOSGiReferenceGuide">Distributed OSGi
Reference Guide</h1><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1452174423777 {padding: 0px;}
-div.rbtoc1452174423777 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1452174423777 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1473857223565 {padding: 0px;}
+div.rbtoc1473857223565 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1473857223565 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1452174423777">
+/*]]>*/</style></p><div class="toc-macro rbtoc1473857223565">
<ul class="toc-indentation"><li><a shape="rect"
href="#DistributedOSGiReference-DistributedOSGiReferenceGuide">Distributed OSGi
Reference Guide</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#DistributedOSGiReference-ConfigurationProperties">Configuration
Properties</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#DistributedOSGiReference-ServiceProviderpropertiesForConfiguringSOAP-basedservicesandconsumers">Service
Provider properties For Configuring SOAP-based services and
consumers</a></li><li><a shape="rect"
href="#DistributedOSGiReference-ServiceProviderpropertiesForConfiguringRESTfulJAXRS-basedendpointsandconsumers">Service
Provider properties For Configuring RESTful JAXRS-based endpoints and
consumers</a></li><li><a shape="rect"
href="#DistributedOSGiReference-ServiceConsumerproperties">Service Consumer
properties</a></li></ul>
</li><li><a shape="rect" href="#DistributedOSGiReference-Customintents">Custom
intents</a></li><li><a shape="rect"
href="#DistributedOSGiReference-remote-services.xmlfiles">remote-services.xml
files</a></li><li><a shape="rect"
href="#DistributedOSGiReference-ContributingDistributionpropertiestoExistingServices(withoutchangingthem)">Contributing
Distribution properties to Existing Services (without changing
them)</a></li></ul>
</li></ul>
-</div><h2 id="DistributedOSGiReference-ConfigurationProperties">Configuration
Properties</h2><p><strong>New in DOSGI 1.2</strong>: Servlet Filters
(javax.servlet.Filter) can be registered as OSGi services with the
"org.apache.cxf.httpservice.filter" boolean<br clear="none"> property set to
true and used to secure DOSGi server endpoints.Endpoints can enforce the
registration of the filters by setting an
"org.apache.cxf.httpservice.requirefilter" boolean property to
true.</p><p>These properties are set on the Service Registration in the OSGi
Service Registry.</p><h3
id="DistributedOSGiReference-ServiceProviderpropertiesForConfiguringSOAP-basedservicesandconsumers">Service
Provider properties For Configuring SOAP-based services and
consumers</h3><p><strong>Note:</strong> for backwards compatibility old values
marked below are still supported.</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Property Name</p></th><t
h colspan="1" rowspan="1" class="confluenceTh"><p>Data Type</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>Example</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>service.exported.interfaces<br
clear="none"> (previously:<em>osgi.remote.interfaces</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1"
class="confluenceTd"><p><code>org.example.BarService,org.example.FooService</code>
<code>*</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Denotes the interfaces to be exposed remotely. This is
a comma-separated list of fully qualified Java interfaces that should be made
available remotely. A special value of <code>*</code> can be provided meaning
that <em>all</em> of the interfaces passed to the
<code>BundleContext.registerService()</code> call are suitable for
remoting.</p></td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"><p>service.exported.configs
(previously:<em>osgi.remote.configuration.type</em>)</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>org.apache.cxf.ws</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the mechanism for configuring the
service exposure. Possible values:</p><ul><li><code>org.apache.cxf.ws</code>
(previously: <code>pojo</code>) the OSGi Service is exposed as a Web
Service.</li><li><code>wsdl</code> configuration driven from
WSDL</li></ul></td></tr></tbody></table></div><h4
id="DistributedOSGiReference-org.apache.cxf.wsconfigurationtype"><code>org.apache.cxf.ws</code>
configuration type</h4><p>When the
<code>service.exported.configs=org.apache.cxf.ws</code> (or
<code>osgi.remote.configuration.type=pojo</code>) property is specified, the
following properties may also be specified.</p><div class="table-wrap"><table
class="confluenceTable">
<tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Property
Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Data
Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Example</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.address<br clear="none">
(previously:<em>osgi.remote.configuration.pojo.address</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><a shape="rect" class="external-link"
href="http://localhost:9090/greeter";
rel="nofollow">http://localhost:9090/greeter</a></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The address at which the service with be
made available remotely. If this property is not specified, this defaults to <a
shape="rect" class="external-link"
href="http://localhost:9000/fully/qualified/ClassName"; rel="nofollow">http://
localhost:9000/fully/qualified/ClassName</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.httpservice.context<br
clear="none">
(previously:<em>osgi.remote.configuration.pojo.httpservice.context</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/auction</code></p></td><td
colspan="1" rowspan="1" class="external-link confluenceTd"><p>When this
property is specified, the OSGi HTTP Service is used to expose the service,
rather than a dedicated Jetty HTTP Server. This property doesn't allow the
specification of a port number, as this is provided by the HTTP Service. The
Distributed OSGi distributions come with Pax-Web, for which configuration
information can be found at <a shape="rect" class="external-link"
href="http://wiki.ops4j.org/display/paxweb/Configuration";
rel="nofollow">http://wiki.ops4j.org/display/paxweb/Configuration</a>, however
other OSGi HTTP
Service implementations are potentially configured
differently.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.frontend</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>jaxws</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The CXF frontend which will be used to create
endpoints. Defaults to 'simple' which is an Aegis-based simple frontend. Note
that for JAXWS to work a javax.jws.* has to be imported into the interface
and/or implementation and client bundles for annotations like @WebService and
@WebMethod be recognized</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.databinding</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>jaxb</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Supported values are 'aeg
is and 'jaxb', defaults to 'aegis'. Note that for JAXB to work JAXB packages
like javax.xml.bind.annotation.* have to be imported</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd">org.apache.cxf.ws.databinding.bean</td><td colspan="1"
rowspan="1" class="confluenceTd">DataBinding</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">An actual DataBinding instance to use. If not specified, a
default one is created according to the type specified in the
org.apache.cxf.ws.databinding property.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.wsdl.location</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/wsdl/service.wsdl</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL
location</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.wsdl.servi
ce.ns</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><a shape="rect" class="external-link"
href="http://services.org"; rel="nofollow">http://services.org</a></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL service
namespace</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.wsdl.service.name</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>SoapService</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL service
name</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.wsdl.port.name</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>SoapServicePort</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL port name</p></td></tr><tr
><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.ws.in.interceptors</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
>List</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>List of CXF in interceptors</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.ws.out.interceptors</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
>List</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>List of CXF out interceptors</p></td></tr><tr><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.ws.in.fault.interceptors</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
>List</p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>List of CX
F in fault interceptors</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.out.fault.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.features</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String, String[], List, Object</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>List of CXF out
features</p></td></tr></tbody></table></div><h3
id="DistributedOSGiReference-ServiceProviderpropertiesForConfiguringRESTfulJAXRS-basedendpointsandconsumers">Service
Provider properties For Configuring RESTful JAXRS-based endpoints and
consumers</h3><h4 id="DistributedOSGiReference-org.ap
ache.cxf.rsconfigurationtype"><code>org.apache.cxf.rs</code> configuration
type</h4><p>When the <code>service.exported.configs=org.apache.cxf.rs</code>
property is specified, the following properties may also be specified.</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Property Name</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Data Type</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Example</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.rs.address</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><a shape="rect" class="external-link"
href="http://localhost:9090/greeter";
rel="nofollow">http://localhost:9090/greeter</a></td><td colspan="1"
rowspan="1" class="external-link confluenceTd"><p>The address at w
hich the service with be made available remotely. If this property is not
specified, this defaults to <a shape="rect" class="external-link"
href="http://localhost:9000/fully/qualified/ClassName";
rel="nofollow">http://localhost:9000/fully/qualified/ClassName</a>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.httpservice.context</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/auction</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>When this property is
specified, the OSGi HTTP Service which is used to expose the service, rather
than a dedicated Jetty HTTP Server. By default, absolute address may look like
'http://localhost:8080/auction'</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.provider</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Boolean</p></td><td colspan="1" rowspan="1"
class="c
onfluenceTd"><p><code>true/false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Can be used to identify a global JAXRS provider as
CXF-compatible</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.provider.expected</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Boolean</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true/false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Can be used to require global
providers to set an 'org.apache.cxf.rs.provider' property with a value
'true'.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.provider.globalquery</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Boolean</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true/false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Can be used to disable queries
for global providers, defaults to 'true'.</p></td></tr
><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.rs.databinding</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>aegis</code></p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>This property has a limited
>value for JAXRS services as JAXB is supported by default, the only supported
>value is 'aegis' and it is a shortcut for registering an Aegis provider, see
>below for more information on how to register custom providers for JAXRS
>services</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.rs.wadl.location</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p><code>/wadl/service.wadl</code></p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>WADL
>location</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.rs.provider</p></td><t
d colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of JAX-RS providers</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.in.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.out.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out interceptors</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>org.apache.cxf.rs.i
n.fault.interceptors</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String, String[], List</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.out.fault.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.features</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String, String[], List</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>List of CXF out
features</p></td></tr></tbody></table></div><p>Note tha
t by default for JAXRS to work javax.ws.rs.* packages have to be imported into
the interface and/or implementation and client bundles for annotations like
@Path and @Context be recognized. You can avoid importing JAXRS annotations if
you provide an out-of-band <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-RESTfulserviceswithoutannotations";>model</a>.
The way it is done in a greeter_rest demo is described <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-IntegrationwithDistributedOSGi";>here</a>.
The model files can be located in a OSGI-INF/cxf/jaxrs resource folder and can
be named as model.xml or ServiceName-model.xml (ex :
GreeterService-model.xml).<br clear="none"> If you use JAXB and you would like
to avoid importing JAXB packages into your application bundles then you can try
registering a custom JAXB provider which is configured as described <a
shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-HandlingJAXBbeanswithoutXmlRoo
tElementannotations">here</a>.</p><h4
id="DistributedOSGiReference-RegisteringcustomJAXRSproviders">Registering
custom JAXRS providers</h4><p>Custom JAXRS providers including CXF-specific
providers can be registered like regular OSGI services, for example :</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+</div><h2 id="DistributedOSGiReference-ConfigurationProperties">Configuration
Properties</h2><p><strong>New in DOSGI 1.2</strong>: Servlet Filters
(javax.servlet.Filter) can be registered as OSGi services with the
"org.apache.cxf.httpservice.filter" boolean<br clear="none"> property set to
true and used to secure DOSGi server endpoints.Endpoints can enforce the
registration of the filters by setting an
"org.apache.cxf.httpservice.requirefilter" boolean property to
true.</p><p>These properties are set on the Service Registration in the OSGi
Service Registry.</p><h3
id="DistributedOSGiReference-ServiceProviderpropertiesForConfiguringSOAP-basedservicesandconsumers">Service
Provider properties For Configuring SOAP-based services and
consumers</h3><p><strong>Note:</strong> for backwards compatibility old values
marked below are still supported.</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Property Name</p></th><t
h colspan="1" rowspan="1" class="confluenceTh"><p>Data Type</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>Example</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>service.exported.interfaces<br
clear="none"> (previously:<em>osgi.remote.interfaces</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1"
class="confluenceTd"><p><code>org.example.BarService,org.example.FooService</code>
<code>*</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Denotes the interfaces to be exposed remotely. This is
a comma-separated list of fully qualified Java interfaces that should be made
available remotely. A special value of <code>*</code> can be provided meaning
that <em>all</em> of the interfaces passed to the
<code>BundleContext.registerService()</code> call are suitable for
remoting.</p></td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"><p>service.exported.configs
(previously:<em>osgi.remote.configuration.type</em>)</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>org.apache.cxf.ws</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the mechanism for configuring the
service exposure. Possible values:</p><ul><li><code>org.apache.cxf.ws</code>
(previously: <code>pojo</code>) the OSGi Service is exposed as a Web
Service.</li><li><code>wsdl</code> configuration driven from
WSDL</li></ul></td></tr></tbody></table></div><h4
id="DistributedOSGiReference-org.apache.cxf.wsconfigurationtype"><code>org.apache.cxf.ws</code>
configuration type</h4><p>When the
<code>service.exported.configs=org.apache.cxf.ws</code> (or
<code>osgi.remote.configuration.type=pojo</code>) property is specified, the
following properties may also be specified.</p><div class="table-wrap"><table
class="confluenceTable">
<tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Property
Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Data
Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Example</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.address<br clear="none">
(previously:<em>osgi.remote.configuration.pojo.address</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><a shape="rect" class="external-link"
href="http://localhost:9090/greeter";
rel="nofollow">http://localhost:9090/greeter</a></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The address at which the service with be
made available remotely. If this property is not specified, this defaults to <a
shape="rect" class="external-link"
href="http://localhost:9000/fully/qualified/ClassName"; rel="nofollow">http://
localhost:9000/fully/qualified/ClassName</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.httpservice.context<br
clear="none">
(previously:<em>osgi.remote.configuration.pojo.httpservice.context</em>)</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/auction</code></p></td><td
colspan="1" rowspan="1" class="external-link confluenceTd"><p>When this
property is specified, the OSGi HTTP Service is used to expose the service,
rather than a dedicated Jetty HTTP Server. This property doesn't allow the
specification of a port number, as this is provided by the HTTP Service. The
Distributed OSGi distributions come with Pax-Web, for which configuration
information can be found at <a shape="rect" class="external-link"
href="http://wiki.ops4j.org/display/paxweb/Configuration";
rel="nofollow">http://wiki.ops4j.org/display/paxweb/Configuration</a>, however
other OSGi HTTP
Service implementations are potentially configured
differently.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.frontend</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>jaxws</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The CXF frontend which will be used to create
endpoints. Defaults to 'simple' which is an Aegis-based simple frontend. Note
that for JAXWS to work a javax.jws.* has to be imported into the interface
and/or implementation and client bundles for annotations like @WebService and
@WebMethod be recognized</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.databinding</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>jaxb</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Supported values are 'aeg
is and 'jaxb', defaults to 'aegis'. Note that for JAXB to work JAXB packages
like javax.xml.bind.annotation.* have to be imported</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd">org.apache.cxf.ws.databinding.bean</td><td colspan="1"
rowspan="1" class="confluenceTd">DataBinding</td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd">An actual DataBinding instance to use. If not specified, a
default one is created according to the type specified in the
org.apache.cxf.ws.databinding property.</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.ws.wsdl.location</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/wsdl/service.wsdl</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL
location</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.service.ns
</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><a shape="rect" class="external-link"
href="http://services.org"; rel="nofollow">http://services.org</a></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>WSDL service
namespace</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.service.name</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>SoapService</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>WSDL service name</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.port.name</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>SoapServicePort</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>WSDL port name</p></td></tr><tr><td
colspan="1
" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.in.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.out.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.in.fault.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in fault inte
rceptors</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.out.fault.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.ws.features</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String, String[], List, Object</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>List of CXF out
features</p></td></tr></tbody></table></div><h3
id="DistributedOSGiReference-ServiceProviderpropertiesForConfiguringRESTfulJAXRS-basedendpointsandconsumers">Service
Provider properties For Configuring RESTful JAXRS-based endpoints and
consumers</h3><h4 id="DistributedOSGiReference-org.apache.cxf.rsconf
igurationtype"><code>org.apache.cxf.rs</code> configuration type</h4><p>When
the <code>service.exported.configs=org.apache.cxf.rs</code> property is
specified, the following properties may also be specified.</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Property Name</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Data Type</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Example</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>org.apache.cxf.rs.address</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><a shape="rect" class="external-link"
href="http://localhost:9090/greeter";
rel="nofollow">http://localhost:9090/greeter</a></td><td colspan="1"
rowspan="1" class="external-link confluenceTd"><p>The address at which the
servic
e with be made available remotely. If this property is not specified, this
defaults to <a shape="rect" class="external-link"
href="http://localhost:9000/fully/qualified/ClassName";
rel="nofollow">http://localhost:9000/fully/qualified/ClassName</a>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.httpservice.context</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>/auction</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>When this property is
specified, the OSGi HTTP Service which is used to expose the service, rather
than a dedicated Jetty HTTP Server. By default, absolute address may look like
'http://localhost:8080/auction'</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.provider</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Boolean</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p
><code>true/false</code></p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Can be used to identify a global JAXRS provider as
>CXF-compatible</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.rs.provider.expected</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>Boolean</p></td><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p><code>true/false</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Can be used to require global providers
>to set an 'org.apache.cxf.rs.provider' property with a value
>'true'.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p>org.apache.cxf.rs.provider.globalquery</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>Boolean</p></td><td
>colspan="1" rowspan="1"
>class="confluenceTd"><p><code>true/false</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Can be used to disable queries for global
>providers, defaults to 'true'.</p></td></tr><tr><td colspa
n="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.databinding</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>aegis</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>This property has a limited value for JAXRS services as
JAXB is supported by default, the only supported value is 'aegis' and it is a
shortcut for registering an Aegis provider, see below for more information on
how to register custom providers for JAXRS services</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.wadl.location</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>/wadl/service.wadl</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>WADL location</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.provider</p></td><td colspan="1" r
owspan="1" class="confluenceTd"><p>String, String[], List</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>List of JAX-RS
providers</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.in.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.out.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.in.fault.interce
ptors</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String,
String[], List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF in fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.out.fault.interceptors</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>String, String[],
List</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>List of CXF out fault interceptors</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p>org.apache.cxf.rs.features</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>String, String[], List</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>List of CXF out
features</p></td></tr></tbody></table></div><p>Note that by default fo
r JAXRS to work javax.ws.rs.* packages have to be imported into the interface
and/or implementation and client bundles for annotations like @Path and
@Context be recognized. You can avoid importing JAXRS annotations if you
provide an out-of-band <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-RESTfulserviceswithoutannotations";>model</a>.
The way it is done in a greeter_rest demo is described <a shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-IntegrationwithDistributedOSGi";>here</a>.
The model files can be located in a OSGI-INF/cxf/jaxrs resource folder and can
be named as model.xml or ServiceName-model.xml (ex :
GreeterService-model.xml).<br clear="none"> If you use JAXB and you would like
to avoid importing JAXB packages into your application bundles then you can try
registering a custom JAXB provider which is configured as described <a
shape="rect"
href="http://cxf.apache.org/docs/jax-rs.html#JAX-RS-HandlingJAXBbeanswithoutXmlRootElementannotat
ions">here</a>.</p><h4
id="DistributedOSGiReference-RegisteringcustomJAXRSproviders">Registering
custom JAXRS providers</h4><p>Custom JAXRS providers including CXF-specific
providers can be registered like regular OSGI services, for example :</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">Object provider = new CustomMessageBodyReaderWriter();
bundleContext.registerService(
new String[]{"javax.ws.rs.ext.MessageBodyReader",
"javax.ws.rs.ext.MessageBodyReader"}, provider);
