cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r995390 - in /websites/production/cxf/content: cache/docs.pageCache docs/springboot.html
Date Thu, 18 Aug 2016 12:47:35 GMT
Author: buildbot
Date: Thu Aug 18 12:47:35 2016
New Revision: 995390

Log:
Production update by buildbot for cxf

Modified:
    websites/production/cxf/content/cache/docs.pageCache
    websites/production/cxf/content/docs/springboot.html

Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/cxf/content/docs/springboot.html
==============================================================================
--- websites/production/cxf/content/docs/springboot.html (original)
+++ websites/production/cxf/content/docs/springboot.html Thu Aug 18 12:47:35 2016
@@ -119,11 +119,11 @@ Apache CXF -- SpringBoot
            <!-- Content -->
            <div class="wiki-content">
 <div id="ConfluenceContent"><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1471366020826 {padding: 0px;}
-div.rbtoc1471366020826 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1471366020826 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1471524419644 {padding: 0px;}
+div.rbtoc1471524419644 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1471524419644 li {margin-left: 0px;padding-left: 0px;}
 
-/*]]>*/</style></p><div class="toc-macro rbtoc1471366020826">
+/*]]>*/</style></p><div class="toc-macro rbtoc1471524419644">
 <ul class="toc-indentation"><li><a shape="rect" href="#SpringBoot-SpringBootCXFJAX-WSStarter">Spring
Boot CXF JAX-WS Starter</a>
 <ul class="toc-indentation"><li><a shape="rect" href="#SpringBoot-Features">Features</a></li><li><a
shape="rect" href="#SpringBoot-Setup">Setup</a></li><li><a shape="rect"
href="#SpringBoot-AdditionalConfiguration">Additional Configuration</a></li><li><a
shape="rect" href="#SpringBoot-APIDocumentation">API Documentation</a></li><li><a
shape="rect" href="#SpringBoot-ServiceRegistryPublication">Service Registry Publication</a></li><li><a
shape="rect" href="#SpringBoot-Examples">Examples</a></li></ul>
 </li><li><a shape="rect" href="#SpringBoot-SpringBootCXFJAX-RSStarter">Spring
Boot CXF&#160;JAX-RS Starter</a>
@@ -139,7 +139,7 @@ div.rbtoc1471366020826 li {margin-left:
     &lt;artifactId&gt;cxf-spring-boot-starter-jaxws&lt;/artifactId&gt;
     &lt;version&gt;3.1.7&lt;/version&gt;
 &lt;/dependency&gt;</pre>
-</div></div><h2 id="SpringBoot-AdditionalConfiguration">Additional Configuration</h2><p>Use
"<strong>cxf.path</strong>" property to customize a CXFServlet URL pattern</p><p>Use
"<strong>cxf.servlet.init</strong>" map property to customize CXFServlet properties
such as "services-list-path" (available by default at&#160; "/services"), etc.</p><h2
id="SpringBoot-APIDocumentation">API Documentation</h2><p>JAX-WS endpoints
support WSDL.</p><h2 id="SpringBoot-ServiceRegistryPublication">Service Registry
Publication</h2><p>Publication of JAX-WS endpoints into well-known service registries
such as Netflix Eureka Registry can be achieved similarly to the way JAX-RS endpoints are
registered and is shown in a <a shape="rect" class="external-link" href="https://github.com/apache/cxf/tree/master/distribution/src/main/release/samples/jax_rs/spring_boot_scan/application"
rel="nofollow">JAX-RS Spring Boot Scan</a> demo.</p><h2 id="SpringBoot-Examples">Examples</h2><p>Consider
the following Configur
 ation instance:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>JAX-WS Configuration</b></div><div
class="codeContent panelContent pdl">
+</div></div><h2 id="SpringBoot-AdditionalConfiguration">Additional Configuration</h2><p>Use
"<strong>cxf.path</strong>" property to customize a CXFServlet URL pattern</p><p>Use
"<strong>cxf.servlet.init</strong>" map property to customize CXFServlet properties
such as "services-list-path" (available by default at&#160; "/services"), etc.</p><p>If
needed, one can use Spring ImportResource annotation to import the existing JAX-WS contexts
available on the classpath.</p><h2 id="SpringBoot-APIDocumentation">API Documentation</h2><p>JAX-WS
endpoints support WSDL.</p><h2 id="SpringBoot-ServiceRegistryPublication">Service
Registry Publication</h2><p>Publication of JAX-WS endpoints into well-known service
registries such as Netflix Eureka Registry can be achieved similarly to the way JAX-RS endpoints
are registered and is shown in a <a shape="rect" class="external-link" href="https://github.com/apache/cxf/tree/master/distribution/src/main/release/samples/jax_rs/spring_boot_scan/application"
  rel="nofollow">JAX-RS Spring Boot Scan</a> demo.</p><h2 id="SpringBoot-Examples">Examples</h2><p>Consider
the following Configuration instance:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>JAX-WS
Configuration</b></div><div class="codeContent panelContent pdl">
 <pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">package
sample.ws;
 
 import javax.xml.ws.Endpoint;
@@ -169,7 +169,7 @@ public class WebServiceConfig {
     &lt;artifactId&gt;cxf-spring-boot-starter-jaxrs&lt;/artifactId&gt;
     &lt;version&gt;3.1.7&lt;/version&gt;
 &lt;/dependency&gt;</pre>
-</div></div><h2 id="SpringBoot-AdditionalConfiguration.1">Additional Configuration</h2><p>Use
"<strong>cxf.path</strong>" property to customize a CXFServlet URL pattern.</p><p>Use
"<strong>cxf.servlet.init</strong>" map property to customize CXFServlet properties
such as "services-list-path" (available by default at&#160; "/services"), etc.</p><p>Use
"<strong>cxf.jaxrs.server.path</strong>" property to customize a JAX-RS server
endpoint address (default is "/").</p><p>JAX-RS root resources and providers annotated
with JAX-RS @Path and @Provider and native CXF Providers annotated with CXF <a shape="rect"
class="external-link" href="https://github.com/apache/cxf/blob/cxf-3.1.6/core/src/main/java/org/apache/cxf/annotations/Provider.java"
rel="nofollow">@Provider</a> can be auto-discovered.</p><p>Use "<strong>cxf.jaxrs.component-scan</strong>"
property to create a JAX-RS endpoint from the auto-discovered&#160;JAX-RS root resources
and providers which are marked as Spring Components (ann
 otated with Spring @Component or created and returned from @Bean methods).</p><p>Use
"<strong>cxf.jaxrs.classes-scan</strong>" property to create a JAX-RS endpoint
from the auto-discovered&#160;JAX-RS root resources and provider classes. Such classes
do not have to be annotated with Spring @Component. This property needs to be accompanied
by a "<strong>cxf.jaxrs.classes-scan-packages</strong>" property which sets a
comma-separated list of the packages to scan.</p><p>Note that while "<strong>cxf.jaxrs.component-scan</strong>"
and "<strong>cxf.jaxrs.classes-scan</strong>" are mutually exclusive, "<strong>cxf.jaxrs.component-scan</strong>"
can be used alongside the "<strong>cxf.jaxrs.classes-scan-packages</strong>" property
to enable the auto-discovery of the JAX-RS resources and providers which may or may not be
marked as Spring Components.</p><h2 id="SpringBoot-APIDocumentation.1">API Documentation</h2><h3
id="SpringBoot-Swagger">Swagger</h3><p>See CXF <a shape="rect" href="swaggerfe
 ature-swagger2feature.html#SwaggerFeature/Swagger2Feature-EnablinginSpringBoot" rel="nofollow">Swagger2Feature
documentation</a> on how to enable Swagger2Feature in SpringBoot and how to auto-activate
Swagger UI.</p><h3 id="SpringBoot-WADL">WADL</h3><p>CXF automatically
loads a WADL provider if a <strong>cxf-rt-rs-service-description</strong> module
is available on the runtime classpath.</p><h2 id="SpringBoot-ServiceRegistryPublication.1">Service
Registry Publication</h2><p>Publication of JAX-RS endpoints into well-known service
registries such as Netflix Eureka Registry is shown in a <a shape="rect" class="external-link"
href="https://github.com/apache/cxf/tree/master/distribution/src/main/release/samples/jax_rs/spring_boot_scan/application"
rel="nofollow">JAX-RS Spring Boot Scan</a> demo.</p><h2 id="SpringBoot-Examples.1">Examples</h2><h3
id="SpringBoot-ManualConfiguration">Manual Configuration</h3><p>Consider the
following Configuration instance:</p><div class="code panel pdl" st
 yle="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width:
1px;"><b>JAX-RS Configuration</b></div><div class="codeContent panelContent
pdl">
+</div></div><h2 id="SpringBoot-AdditionalConfiguration.1">Additional Configuration</h2><p>Use
"<strong>cxf.path</strong>" property to customize a CXFServlet URL pattern.</p><p>Use
"<strong>cxf.servlet.init</strong>" map property to customize CXFServlet properties
such as "services-list-path" (available by default at&#160; "/services"), etc.</p><p>Use
"<strong>cxf.jaxrs.server.path</strong>" property to customize a JAX-RS server
endpoint address (default is "/").</p><p>JAX-RS root resources and providers annotated
with JAX-RS @Path and @Provider and native CXF Providers annotated with CXF <a shape="rect"
class="external-link" href="https://github.com/apache/cxf/blob/cxf-3.1.6/core/src/main/java/org/apache/cxf/annotations/Provider.java"
rel="nofollow">@Provider</a> can be auto-discovered.</p><p>Use "<strong>cxf.jaxrs.component-scan</strong>"
property to create a JAX-RS endpoint from the auto-discovered&#160;JAX-RS root resources
and providers which are marked as Spring Components (ann
 otated with Spring @Component or created and returned from @Bean methods).</p><p>Use
"<strong>cxf.jaxrs.classes-scan</strong>" property to create a JAX-RS endpoint
from the auto-discovered&#160;JAX-RS root resources and provider classes. Such classes
do not have to be annotated with Spring @Component. This property needs to be accompanied
by a "<strong>cxf.jaxrs.classes-scan-packages</strong>" property which sets a
comma-separated list of the packages to scan.</p><p>Note that while "<strong>cxf.jaxrs.component-scan</strong>"
and "<strong>cxf.jaxrs.classes-scan</strong>" are mutually exclusive, "<strong>cxf.jaxrs.component-scan</strong>"
can be used alongside the "<strong>cxf.jaxrs.classes-scan-packages</strong>" property
to enable the auto-discovery of the JAX-RS resources and providers which may or may not be
marked as Spring Components.</p><p>If needed, instead of having the resources
auto-discovered,&#160; one can use Spring ImportResource annotation to import the existing
JAX-RS
  contexts available on the classpath.</p><h2 id="SpringBoot-APIDocumentation.1">API
Documentation</h2><h3 id="SpringBoot-Swagger">Swagger</h3><p>See CXF
<a shape="rect" href="swaggerfeature-swagger2feature.html#SwaggerFeature/Swagger2Feature-EnablinginSpringBoot"
rel="nofollow">Swagger2Feature documentation</a> on how to enable Swagger2Feature
in SpringBoot and how to auto-activate Swagger UI.</p><h3 id="SpringBoot-WADL">WADL</h3><p>CXF
automatically loads a WADL provider if a <strong>cxf-rt-rs-service-description</strong>
module is available on the runtime classpath.</p><h2 id="SpringBoot-ServiceRegistryPublication.1">Service
Registry Publication</h2><p>Publication of JAX-RS endpoints into well-known service
registries such as Netflix Eureka Registry is shown in a <a shape="rect" class="external-link"
href="https://github.com/apache/cxf/tree/master/distribution/src/main/release/samples/jax_rs/spring_boot_scan/application"
rel="nofollow">JAX-RS Spring Boot Scan</a> demo.</p><h2 id="
 SpringBoot-Examples.1">Examples</h2><h3 id="SpringBoot-ManualConfiguration">Manual
Configuration</h3><p>Consider the following Configuration instance:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader
pdl" style="border-bottom-width: 1px;"><b>JAX-RS Configuration</b></div><div
class="codeContent panelContent pdl">
 <pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">package
sample.rs.service;
 import java.util.Arrays;
 



Mime
View raw message