cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r997379 - in /websites/production/cxf/content: cache/main.pageCache distributed-osgi-reference.html
Date Wed, 14 Sep 2016 12:47:39 GMT
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);



Mime
View raw message