Author: buildbot
Date: Sun Nov 1 16:57:19 2020
New Revision: 1067434
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 Sun Nov 1 16:57:19
2020
@@ -119,13 +119,13 @@ Apache CXF -- SpringBoot
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1603587546154 {padding: 0px;}
-div.rbtoc1603587546154 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1603587546154 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1604249799407 {padding: 0px;}
+div.rbtoc1604249799407 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1604249799407 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1603587546154">
-<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-Actuator">Actuator</a></li><li><a shape="rect"
href="#SpringBoot-Examples">Examples</a></li></ul>
+/*]]>*/</style></p><div class="toc-macro rbtoc1604249799407">
+<ul class="toc-indentation"><li><a shape="rect"
href="#SpringBoot-SpringBootActuator">Spring Boot Actuator</a></li><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 JAX-RS Starter</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#SpringBoot-Features.1">Features</a></li><li><a shape="rect"
href="#SpringBoot-Setup.1">Setup</a></li><li><a shape="rect"
href="#SpringBoot-AdditionalConfiguration.1">Additional
Configuration</a></li><li><a shape="rect"
href="#SpringBoot-APIDocumentation.1">API Documentation</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#SpringBoot-Swagger">Swagger</a></li><li><a shape="rect"
href="#SpringBoot-WADL">WADL</a></li></ul>
@@ -133,13 +133,13 @@ div.rbtoc1603587546154 li {margin-left:
<ul class="toc-indentation"><li><a shape="rect"
href="#SpringBoot-ManualConfiguration">Manual Configuration</a></li><li><a
shape="rect" href="#SpringBoot-AutoConfiguration">Auto
Configuration</a></li></ul>
</li></ul>
</li></ul>
-</div><h1 id="SpringBoot-SpringBootCXFJAX-WSStarter">Spring Boot CXF JAX-WS
Starter</h1><h2 id="SpringBoot-Features">Features</h2><p>Registers CXFServlet
with a  "/services/*" URL pattern for serving CXF JAX-WS endpoints.</p><h2
id="SpringBoot-Setup">Setup</h2><div class="code panel pdl"
style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>JAX-WS Starter</b></div><div
class="codeContent panelContent pdl">
+</div><h1 id="SpringBoot-SpringBootActuator">Spring Boot Actuator</h1><p>When
the presence of the <a shape="rect" class="external-link"
href="https://docs.spring.io/spring-boot/docs/current/reference/html/production-ready-features.html"
rel="nofollow">Spring Boot Actuator</a> is detected, the application may
benefit from metrics support auto-configuration (based on  <a shape="rect"
class="external-link" rel="nofollow"
href="https://micrometer.io/">Micrometer</a> library). The instrumentation
layer automatically (or programmatically) tracks the server-side metrics with
respect to requests processing, and exposes it along with other metrics. For
more details, please check <a shape="rect" href="micrometer.html">Micrometer
Integration</a> documentation.</p><div class="table-wrap"><table class="wrapped
confluenceTable"><colgroup span="1"><col span="1"><col span="1"><col
span="1"></colgroup><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh">Property</th><th colspan="1" rowsp
an="1" class="confluenceTh">Description</th><th colspan="1" rowspan="1"
class="confluenceTh">Default</th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><strong>cxf.metrics.enabled</strong></td><td colspan="1"
rowspan="1" class="confluenceTd">Enables or disables metrics
auto-configuration</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><strong>cxf.metrics.jaxrs.enabled</strong></td><td
colspan="1" rowspan="1" class="confluenceTd">Enables or disables JAX-RS metrics
auto-configuration</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><strong>cxf.metrics.jaxws.enabled</strong></td><td
colspan="1" rowspan="1" class="confluenceTd">Enables or disables JAX-WS metrics
auto-configuration</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1"
rowspan="1" class="
confluenceTd"><strong>cxf.metrics.server.autoTimeRequests</strong></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Whether requests handled by CXF
should be automatically timed.  If the number of time series emitted grows
<br clear="none">too large on account of request mapping timings, set it to
"false" and use <a shape="rect" class="external-link"
href="https://github.com/micrometer-metrics/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/Timed.java"
rel="nofollow">@Timed</a> or <a shape="rect" class="external-link"
href="https://github.com/micrometer-metrics/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/TimedSet.java"
rel="nofollow">@TimeSet</a> on a per <br clear="none">invocation basis as
needed.</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1"
rowspan="1"
class="confluenceTd"><strong>cxf.metrics.server.requestsMetricName</strong></
td><td colspan="1" rowspan="1" class="confluenceTd">Name of the metric for
received requests (server-side)</td><td colspan="1" rowspan="1"
class="confluenceTd"><strong>cxf.server.requests</strong></td></tr></tbody></table></div><h1
id="SpringBoot-SpringBootCXFJAX-WSStarter">Spring Boot CXF JAX-WS
Starter</h1><h2 id="SpringBoot-Features">Features</h2><p>Registers CXFServlet
with a  "/services/*" URL pattern for serving CXF JAX-WS endpoints.</p><h2
id="SpringBoot-Setup">Setup</h2><div class="code panel pdl"
style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>JAX-WS Starter</b></div><div
class="codeContent panelContent pdl">
<pre class="brush: xml; gutter: false; theme: Default"><dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
<version>3.1.12</version>
</dependency></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  "/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-Actuator">Actuator</h2><p>When the presence of the <a
shape="rect" class="external-link"
href="https://docs.spring.io/spring-boot/docs/current/reference/html/production-ready-features.html"
rel="nofollow">Spring Boot Actuator</a> is detected, the application may
benefit from metrics support auto-configuration (based on  <a shape="rect"
class="external-link" href="https://micrometer.io/"
rel="nofollow">Micrometer</a> library). The instrumentation layer automatically
(or programmatically) tracks the server-side metrics with respect to requests
processing, and exposes it along with other metrics. For more details, please
check <a shape="rect" href="micrometer.html">Micrometer Integration</a>
documentation.</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">
+</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  "/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">package sample.ws;
import javax.xml.ws.Endpoint;