You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2016/09/14 12:47:39 UTC

svn commit: r997379 - in /websites/production/cxf/content: cache/main.pageCache distributed-osgi-reference.html

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">&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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">&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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>&#160;</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);