From 3937b3df45bd452ae5ff35e4783f387cb92d6205 Mon Sep 17 00:00:00 2001 From: Andreas Jonsson Date: Sat, 23 Nov 2024 11:37:33 +0100 Subject: [PATCH] Make filename and asciidoc identifers consistent Comments in nav --- ...ode.quarkus.io.png => code-quarkus-io.png} | Bin ...nce.png => release-notes-2-10-0-since.png} | Bin ...=> release-notes-2-7-0-devui-services.png} | Bin docs/modules/ROOT/nav.adoc | 17 ++++++++++++++--- .../ROOT/pages/contributor-guide/index.adoc | 2 +- docs/modules/ROOT/pages/index.adoc | 4 +++- ...cxf-integration-tracing-opentelemetry.adoc | 9 ++++++--- .../quarkus-cxf-rt-features-metrics.adoc | 9 ++++++--- .../quarkus-cxf-rt-ws-security.adoc | 5 ++++- .../reference/extensions/quarkus-cxf.adoc | 4 ++-- docs/modules/ROOT/pages/reference/index.adoc | 9 +++++---- .../ROOT/pages/release-notes/2.2.0.adoc | 1 + .../ROOT/pages/release-notes/2.2.1.adoc | 1 + .../ROOT/pages/release-notes/2.2.2.adoc | 1 + .../ROOT/pages/release-notes/2.3.0.adoc | 1 + .../ROOT/pages/release-notes/2.3.1.adoc | 1 + .../ROOT/pages/release-notes/2.4.0.adoc | 1 + .../ROOT/pages/release-notes/2.5.0.adoc | 1 + .../ROOT/pages/release-notes/2.6.0.adoc | 1 + .../ROOT/pages/release-notes/2.6.1.adoc | 1 + .../ROOT/pages/release-notes/2.7.0.adoc | 7 ++++--- .../ROOT/pages/release-notes/2.7.1.adoc | 1 + .../ROOT/pages/release-notes/3.10.0.adoc | 3 ++- .../ROOT/pages/release-notes/3.11.0.adoc | 1 + .../ROOT/pages/release-notes/3.11.1.adoc | 1 + .../ROOT/pages/release-notes/3.12.0.adoc | 1 + .../ROOT/pages/release-notes/3.13.0.adoc | 4 +++- .../ROOT/pages/release-notes/3.13.1.adoc | 3 ++- .../ROOT/pages/release-notes/3.14.0.adoc | 3 ++- .../ROOT/pages/release-notes/3.15.0.adoc | 1 + .../ROOT/pages/release-notes/3.8.0.adoc | 3 ++- .../ROOT/pages/release-notes/3.8.1.adoc | 7 ++++--- .../ROOT/pages/release-notes/3.8.2.adoc | 1 + .../ROOT/pages/release-notes/3.8.3.adoc | 1 + .../ROOT/pages/release-notes/3.8.4.adoc | 1 + .../ROOT/pages/release-notes/3.8.5.adoc | 1 + .../ROOT/pages/release-notes/3.8.6.adoc | 1 + .../ROOT/pages/release-notes/3.9.0.adoc | 1 + .../ROOT/pages/release-notes/index.adoc | 1 + docs/modules/ROOT/pages/release-planning.adoc | 3 ++- .../ROOT/pages/security-guide/index.adoc | 10 +++++----- ...ypolicy-authentication-authorization.adoc} | 9 +++++---- .../cdi-scope-of-cxfclient.adoc | 7 ++++--- .../client-endpoint-url-defaults.adoc | 3 ++- .../configure-multiple-clients.adoc | 1 + .../dynamic-client-configuration.adoc | 1 + .../prevent-resource-leaks.adoc | 2 +- ...matic-client-configuration-at-startup.adoc | 1 + .../pure-client-applications.adoc | 2 +- .../user-guide/advanced-service-topics.adoc | 1 + .../jax-ws-providers.adoc | 2 +- .../running-behind-a-reverse-proxy.adoc | 7 ++++++- .../advanced-soap-client-topics.adoc | 1 + ...adoc => authentication-authorization.adoc} | 11 +++++++---- .../pages/user-guide/camel-integration.adoc | 3 ++- .../ROOT/pages/user-guide/configuration.adoc | 1 + .../user-guide/contract-first-code-first.adoc | 1 + .../generate-java-from-wsdl.adoc | 4 ++++ .../generate-wsdl-from-java.adoc | 18 +++++++++++------- .../ROOT/pages/user-guide/create-project.adoc | 7 ++++--- .../ROOT/pages/user-guide/examples.adoc | 1 + .../pages/user-guide/first-soap-client.adoc | 3 ++- .../user-guide/first-soap-web-service.adoc | 4 ++-- docs/modules/ROOT/pages/user-guide/index.adoc | 2 +- .../interceptors-features-handlers.adoc | 1 + .../cxf-interceptors-and-features.adoc | 2 +- .../jax-ws-handlers.adoc | 4 ++-- .../package-for-jvm-and-native.adoc | 1 + .../pages/user-guide/payload-logging.adoc | 1 + .../user-guide/soap-payloads-with-jaxb.adoc | 10 +++++++--- .../{ssl.adoc => ssl-tls-https.adoc} | 9 +++++---- .../cxf/deployment/Java2WsdlProcessor.java | 2 +- .../deployment/codegen/Wsdl2JavaCodeGen.java | 2 +- .../codegen/Wsdl2JavaCodeGenTest.java | 2 +- .../java2ws/IncludesConflictJava2WsTest.java | 2 +- .../core/runtime/src/main/doc/usage.adoc | 4 ++-- .../runtime/src/main/doc/intro.adoc | 9 ++++++--- .../runtime/src/main/doc/intro.adoc | 9 ++++++--- .../cxf/ws/security/CxfWsSecurityConfig.java | 5 ++++- 79 files changed, 189 insertions(+), 89 deletions(-) rename docs/modules/ROOT/images/{code.quarkus.io.png => code-quarkus-io.png} (100%) rename docs/modules/ROOT/images/{release-notes-2.10.0-since.png => release-notes-2-10-0-since.png} (100%) rename docs/modules/ROOT/images/{release-notes-2.7.0-devui-services.png => release-notes-2-7-0-devui-services.png} (100%) rename docs/modules/ROOT/pages/security-guide/{ws-securitypolicy-auth.adoc => ws-securitypolicy-authentication-authorization.adoc} (93%) rename docs/modules/ROOT/pages/user-guide/{auth.adoc => authentication-authorization.adoc} (79%) rename docs/modules/ROOT/pages/user-guide/{ssl.adoc => ssl-tls-https.adoc} (94%) diff --git a/docs/modules/ROOT/images/code.quarkus.io.png b/docs/modules/ROOT/images/code-quarkus-io.png similarity index 100% rename from docs/modules/ROOT/images/code.quarkus.io.png rename to docs/modules/ROOT/images/code-quarkus-io.png diff --git a/docs/modules/ROOT/images/release-notes-2.10.0-since.png b/docs/modules/ROOT/images/release-notes-2-10-0-since.png similarity index 100% rename from docs/modules/ROOT/images/release-notes-2.10.0-since.png rename to docs/modules/ROOT/images/release-notes-2-10-0-since.png diff --git a/docs/modules/ROOT/images/release-notes-2.7.0-devui-services.png b/docs/modules/ROOT/images/release-notes-2-7-0-devui-services.png similarity index 100% rename from docs/modules/ROOT/images/release-notes-2.7.0-devui-services.png rename to docs/modules/ROOT/images/release-notes-2-7-0-devui-services.png diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 5c9d93388..ddea51724 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,3 +1,4 @@ +// user-guide * xref:user-guide/index.adoc[User guide] ** xref:user-guide/create-project.adoc[Create a new project] ** xref:user-guide/first-soap-web-service.adoc[Your first SOAP Web service] @@ -27,11 +28,16 @@ *** xref:user-guide/advanced-client-topics/prevent-resource-leaks.adoc[Prevent resource leaks] ** xref:user-guide/camel-integration.adoc[Camel Integration] ** xref:user-guide/examples.adoc[Examples] + +// security-guide * xref:security-guide/index.adoc[Security guide] -** xref:user-guide/ssl.adoc[SSL, TLS and HTTPS] -** xref:user-guide/auth.adoc[Authentication and authorization] -** xref:security-guide/ws-securitypolicy-auth.adoc[WS-SecurityPolicy Authentication] +** xref:user-guide/ssl-tls-https.adoc[SSL, TLS and HTTPS] +** xref:user-guide/authentication-authorization.adoc[Authentication and authorization] +** xref:security-guide/ws-securitypolicy-authentication-authorization.adoc[WS-SecurityPolicy Authentication] + +// release-notes * xref:release-notes/index.adoc[Release notes] + ifeval::[{doc-is-main} == true] ** xref:release-notes/3.17.1.adoc[3.17.1] ** xref:release-notes/3.17.0.adoc[3.17.0] @@ -69,10 +75,15 @@ ifeval::[{doc-is-main} == true] ** xref:release-notes/2.2.1.adoc[2.2.1 LTS] ** xref:release-notes/2.2.0.adoc[2.2.0 LTS] endif::[] + +// release-planning * xref:release-planning.adoc[Release planning] * xref:contributor-guide/index.adoc[Contributor guide] ** xref:contributor-guide/releasing.adoc[Releasing] + +// reference * xref:reference/index.adoc[Reference] + // extensions: START ** xref:reference/extensions/quarkus-cxf.adoc[Quarkus CXF] ** xref:reference/extensions/quarkus-cxf-rt-features-metrics.adoc[Metrics Feature] diff --git a/docs/modules/ROOT/pages/contributor-guide/index.adoc b/docs/modules/ROOT/pages/contributor-guide/index.adoc index 5c5789005..147057733 100644 --- a/docs/modules/ROOT/pages/contributor-guide/index.adoc +++ b/docs/modules/ROOT/pages/contributor-guide/index.adoc @@ -1,4 +1,4 @@ -[[contributor-guide]] +[[contributor-guide-index]] = Contributor guide diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc index ac157e3da..04a08fd27 100644 --- a/docs/modules/ROOT/pages/index.adoc +++ b/docs/modules/ROOT/pages/index.adoc @@ -1,15 +1,17 @@ -[[cxf-extension-for-quarkus]] +[[quarkus-cxf-index]] = {quarkus-cxf-project-name} This project aims at porting http://cxf.apache.org/[Apache CXF] to https://quarkus.io/[Quarkus] runtime including full support for producing https://quarkus.io/container-first/[GraalVM native images]. [IMPORTANT] +==== While http://cxf.apache.org/[Apache CXF] implements wide range of standards and specifications, {quarkus-cxf-project-name} is currently focusing *only* on supporting the ones related to *Simple Object Access Protocol* (https://en.wikipedia.org/wiki/SOAP[SOAP]) and *Java API for XML Web Services* (https://en.wikipedia.org/wiki/JAX-WS[JAX-WS]). Refer to xref:reference/index.adoc[Reference] to learn which parts of CXF are supported. +==== The documentation is divided into the following main parts: diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc index f941988ae..9f9a381a1 100644 --- a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc +++ b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-integration-tracing-opentelemetry.adoc @@ -15,9 +15,12 @@ endif::[] Generate https://opentelemetry.io/[OpenTelemetry] https://opentelemetry.io/docs/concepts/signals/traces/[traces]. -IMPORTANT: OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side, - hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus - the only OpenTelemetry feature supported by this extension. +[IMPORTANT] +==== +OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side, +hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus +the only OpenTelemetry feature supported by this extension. +==== [id="quarkus-cxf-integration-tracing-opentelemetry-maven-coordinates"] diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc index a038a5016..d0b9cc14d 100644 --- a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc +++ b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-features-metrics.adoc @@ -15,9 +15,12 @@ endif::[] Collect metrics using https://micrometer.io/[Micrometer]. -IMPORTANT: Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature], - this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics]. - Only Micrometer is supported. +[IMPORTANT] +==== +Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature], +this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics]. +Only Micrometer is supported. +==== [id="quarkus-cxf-rt-features-metrics-maven-coordinates"] diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc index 6e460b267..4bba8388c 100644 --- a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc +++ b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf-rt-ws-security.adoc @@ -1292,8 +1292,11 @@ To work around the fact that `org.apache.cxf.ws.security.trust.STSClient` does n cannot thus be used as a CDI bean type, you can use the wrapper class `io.quarkiverse.cxf.ws.security.sts.client.STSClientBean` instead. -Tip: Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page +[TIP] +==== +Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page for more information about WS-Trust. +==== *Environment variable*: `+++QUARKUS_CXF_CLIENT__CLIENT_NAME__SECURITY_STS_CLIENT+++` + *Since Quarkus CXF*: 3.8.0 diff --git a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc index dd3f9efbb..71b91c595 100644 --- a/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc +++ b/docs/modules/ROOT/pages/reference/extensions/quarkus-cxf.adoc @@ -57,8 +57,8 @@ There are several chapters in the xref:user-guide/index.adoc[User guide] coverin * xref:user-guide/configuration.adoc[Configuration] * xref:user-guide/package-for-jvm-and-native.adoc[Package for JVM and native] * xref:user-guide/payload-logging.adoc[Logging] -* xref:user-guide/ssl.adoc[SSL] -* xref:user-guide/auth.adoc[Authentication and authorization] +* xref:user-guide/ssl-tls-https.adoc[SSL] +* xref:user-guide/authentication-authorization.adoc[Authentication and authorization] * xref:user-guide/advanced-soap-client-topics.adoc[Advanced SOAP client topics] * xref:user-guide/advanced-service-topics/running-behind-a-reverse-proxy.adoc[Running behind a reverse proxy] * xref:user-guide/contract-first-code-first/generate-java-from-wsdl.adoc[Generate Java from WSDL] diff --git a/docs/modules/ROOT/pages/reference/index.adoc b/docs/modules/ROOT/pages/reference/index.adoc index 404d0522c..ed44da4db 100644 --- a/docs/modules/ROOT/pages/reference/index.adoc +++ b/docs/modules/ROOT/pages/reference/index.adoc @@ -1,11 +1,11 @@ -[[reference]] +[[reference-index]] = Reference [[extensions]] == {quarkus-cxf-project-name} -Here is the list of extensions produced by this project. -Please follow the links under the extension names to learn about how to use them, about their configuration and about any known limitations. +The following table shows the {quarkus-cxf-project-name} extensions. +Click the extension names to learn more about how to configure and use them, and about any known limitations. [cols="4,1,1,4"] |=== @@ -95,7 +95,7 @@ Out of https://cxf.apache.org/docs/transports.html[CXF Transports] only the foll * `quarkus-cxf` implements its own custom transport based on Quarkus and Vert.x for serving SOAP endpoints * HTTP client via `xref:reference/extensions/quarkus-cxf.adoc[quarkus-cxf]`, including -** xref:user-guide/auth.adoc#_client_http_basic_authentication[Basic Authentication] +** xref:user-guide/authentication-authorization.adoc[Basic Authentication] * https://cxf.apache.org/docs/asynchronous-client-http-transport.html[Asynchronous Client HTTP Transport] via `xref:reference/extensions/quarkus-cxf-rt-transports-http-hc5.adoc[quarkus-cxf-rt-transports-http-hc5]` @@ -201,6 +201,7 @@ Karaf |=== +[[supported-cxf-annotations]] == Supported CXF annotations Here is the status of https://cxf.apache.org/docs/annotations.html[CXF annotations] on Quarkus. diff --git a/docs/modules/ROOT/pages/release-notes/2.2.0.adoc b/docs/modules/ROOT/pages/release-notes/2.2.0.adoc index a5fdd1a01..f87c9c466 100644 --- a/docs/modules/ROOT/pages/release-notes/2.2.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.2.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-2-0]] = {quarkus-cxf-project-name} 2.2.0 LTS release notes == Important dependency upgrades: diff --git a/docs/modules/ROOT/pages/release-notes/2.2.1.adoc b/docs/modules/ROOT/pages/release-notes/2.2.1.adoc index a68afdaad..ae70ebbf5 100644 --- a/docs/modules/ROOT/pages/release-notes/2.2.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.2.1.adoc @@ -1,3 +1,4 @@ +[[rn-2-2-1]] = {quarkus-cxf-project-name} 2.2.1 LTS release notes == New and noteworthy in {quarkus-cxf-project-name} diff --git a/docs/modules/ROOT/pages/release-notes/2.2.2.adoc b/docs/modules/ROOT/pages/release-notes/2.2.2.adoc index 4d594199a..b0b77d561 100644 --- a/docs/modules/ROOT/pages/release-notes/2.2.2.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.2.2.adoc @@ -1,3 +1,4 @@ +[[rn-2-2-2]] = {quarkus-cxf-project-name} 2.2.2 LTS release notes == Fixed bugs diff --git a/docs/modules/ROOT/pages/release-notes/2.3.0.adoc b/docs/modules/ROOT/pages/release-notes/2.3.0.adoc index 05ea42216..b083f4019 100644 --- a/docs/modules/ROOT/pages/release-notes/2.3.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.3.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-3-0]] = {quarkus-cxf-project-name} 2.3.0 release notes == Important dependency upgrades: diff --git a/docs/modules/ROOT/pages/release-notes/2.3.1.adoc b/docs/modules/ROOT/pages/release-notes/2.3.1.adoc index 3e6a403f4..4864473d8 100644 --- a/docs/modules/ROOT/pages/release-notes/2.3.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.3.1.adoc @@ -1,3 +1,4 @@ +[[rn-2-3-1]] = {quarkus-cxf-project-name} 2.3.1 release notes == New and noteworthy in {quarkus-cxf-project-name} diff --git a/docs/modules/ROOT/pages/release-notes/2.4.0.adoc b/docs/modules/ROOT/pages/release-notes/2.4.0.adoc index 4f5ba2d0c..6a38e64eb 100644 --- a/docs/modules/ROOT/pages/release-notes/2.4.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.4.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-4-0]] = {quarkus-cxf-project-name} 2.4.0 release notes == Important dependency upgrades: diff --git a/docs/modules/ROOT/pages/release-notes/2.5.0.adoc b/docs/modules/ROOT/pages/release-notes/2.5.0.adoc index 1f9c3bc00..8c79096e2 100644 --- a/docs/modules/ROOT/pages/release-notes/2.5.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.5.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-5-0]] = {quarkus-cxf-project-name} 2.5.0 release notes == Important dependency upgrades: diff --git a/docs/modules/ROOT/pages/release-notes/2.6.0.adoc b/docs/modules/ROOT/pages/release-notes/2.6.0.adoc index 9d507cb2e..06dea4da0 100644 --- a/docs/modules/ROOT/pages/release-notes/2.6.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.6.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-6-0]] = {quarkus-cxf-project-name} 2.6.0 release notes == Important dependency upgrades: diff --git a/docs/modules/ROOT/pages/release-notes/2.6.1.adoc b/docs/modules/ROOT/pages/release-notes/2.6.1.adoc index d6597f99b..4756a9d47 100644 --- a/docs/modules/ROOT/pages/release-notes/2.6.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.6.1.adoc @@ -1,3 +1,4 @@ +[[rn-2-6-1]] = {quarkus-cxf-project-name} 2.6.1 release notes This maintenance release brings no fixes visible in end user applications. diff --git a/docs/modules/ROOT/pages/release-notes/2.7.0.adoc b/docs/modules/ROOT/pages/release-notes/2.7.0.adoc index 93b16c6da..311ff7903 100644 --- a/docs/modules/ROOT/pages/release-notes/2.7.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.7.0.adoc @@ -1,3 +1,4 @@ +[[rn-2-7-0]] = {quarkus-cxf-project-name} 2.7.0 release notes == Important dependency upgrades: @@ -41,7 +42,7 @@ There are now separate cards listing CXF http://localhost:8080/q/dev-ui/io.quark Here is a screenshot of the http://localhost:8080/q/dev-ui/io.quarkiverse.cxf.quarkus-cxf/service-endpoints[Service endpoints] card: -image::release-notes-2.7.0-devui-services.png[DevUI] +image::release-notes-2-7-0-devui-services.png[DevUI] === Schema validation configurable via `application.properties` @@ -60,8 +61,8 @@ as long as `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-c === Documentation improvements -* New `xref:user-guide/ssl.adoc[SSL guide]` -* New `xref:user-guide/auth.adoc[Authentication and authorization guide]` +* New `xref:user-guide/ssl-tls-https.adoc[SSL guide]` +* New `xref:user-guide/authentication-authorization.adoc[Authentication and authorization guide]` * Improved the xref:user-guide/payload-logging.adoc[Logging guide] * Improved the documentation of `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-version[quarkus.cxf.client."client-name".version]` and `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-browser-type[quarkus.cxf.client."client-name".browser-type]` diff --git a/docs/modules/ROOT/pages/release-notes/2.7.1.adoc b/docs/modules/ROOT/pages/release-notes/2.7.1.adoc index 5570cab2f..a6e24758f 100644 --- a/docs/modules/ROOT/pages/release-notes/2.7.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/2.7.1.adoc @@ -1,3 +1,4 @@ +[[rn-2-7-1]] = {quarkus-cxf-project-name} 2.7.1 release notes This maintenance release brings no fixes visible in end user applications. diff --git a/docs/modules/ROOT/pages/release-notes/3.10.0.adoc b/docs/modules/ROOT/pages/release-notes/3.10.0.adoc index dcd361f88..b24ec1bdb 100644 --- a/docs/modules/ROOT/pages/release-notes/3.10.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.10.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-10-0]] = {quarkus-cxf-project-name} 3.10.0 release notes == Important dependency upgrades @@ -35,7 +36,7 @@ We filed https://issues.apache.org/jira/browse/CXF-9003[CXF-9003] to see whether * All configuration properties are now tagged with the version of {quarkus-cxf-project-name} since which they exist. + -image::release-notes-2.10.0-since.png[The new since tag] +image::release-notes-2-10-0-since.png[The new since tag] + * We added the xref:release-notes/index.adoc[Version table] to the Release notes page showing which version of {quarkus-cxf-project-name} uses which CXF version and which Quarkus Platform `.` you should use diff --git a/docs/modules/ROOT/pages/release-notes/3.11.0.adoc b/docs/modules/ROOT/pages/release-notes/3.11.0.adoc index 5cb106e5e..098589c98 100644 --- a/docs/modules/ROOT/pages/release-notes/3.11.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.11.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-11-0]] = {quarkus-cxf-project-name} 3.11.0 release notes == Important dependency upgrades diff --git a/docs/modules/ROOT/pages/release-notes/3.11.1.adoc b/docs/modules/ROOT/pages/release-notes/3.11.1.adoc index 083eb31b8..93d5b397c 100644 --- a/docs/modules/ROOT/pages/release-notes/3.11.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.11.1.adoc @@ -1,3 +1,4 @@ +[[rn-3-11-1]] = {quarkus-cxf-project-name} 3.11.1 release notes == New and noteworthy in {quarkus-cxf-project-name} diff --git a/docs/modules/ROOT/pages/release-notes/3.12.0.adoc b/docs/modules/ROOT/pages/release-notes/3.12.0.adoc index 57f5ddc73..76c9cb713 100644 --- a/docs/modules/ROOT/pages/release-notes/3.12.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.12.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-12-0]] = {quarkus-cxf-project-name} 3.12.0 release notes == Important dependency upgrades diff --git a/docs/modules/ROOT/pages/release-notes/3.13.0.adoc b/docs/modules/ROOT/pages/release-notes/3.13.0.adoc index 935bbc4c5..54e7fecfc 100644 --- a/docs/modules/ROOT/pages/release-notes/3.13.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.13.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-13-0]] = {quarkus-cxf-project-name} 3.13.0 release notes == Important dependency upgrades @@ -7,6 +8,7 @@ == New and noteworthy in {quarkus-cxf-project-name} +[[vert-x-httpclient-based-http-conduit]] === Vert.x HttpClient based HTTP Conduit As Vert.x is the preferred HTTP stack on Quarkus, we decided to implement a new HTTP Conduit based on Vert.x @@ -37,7 +39,7 @@ or https://github.com/quarkiverse/quarkus-cxf/discussions[Discussions]. The issue https://github.com/quarkiverse/quarkus-cxf/issues/1425[#1425] made us figure out that we had no tests at all for injecting `jakarta.xml.ws.WebServiceContext` using the `@jakarta.annotation.Resource` and `@jakarta.annotation.Resources` annotations. -We not only added the the tests and fixed the malfunctioning case with `@CXFEndpoint("/my-path")`, +We not only added the tests and fixed the malfunctioning case with `@CXFEndpoint("/my-path")`, but we also changed how injecting `@Resource WebServiceContext` was implemented. Instead of relying on the reflective CXF code that was run at application start, the scanning is now done at build time by Arc, the CDI container of Quarkus. diff --git a/docs/modules/ROOT/pages/release-notes/3.13.1.adoc b/docs/modules/ROOT/pages/release-notes/3.13.1.adoc index ca32e8903..cf9edd916 100644 --- a/docs/modules/ROOT/pages/release-notes/3.13.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.13.1.adoc @@ -1,3 +1,4 @@ +[[rn-3-13-1]] = {quarkus-cxf-project-name} 3.13.1 release notes == Important dependency upgrades @@ -8,7 +9,7 @@ === https://github.com/quarkiverse/quarkus-cxf/issues/1455[#1455] Vert.x HTTP client is incorrectly used as the default -We introduced xref:release-notes/3.13.0.adoc#_vert_x_httpclient_based_http_conduit[Vert.x HttpClient based HTTP Conduit] in {quarkus-cxf-project-name} 3.13.0 +We introduced xref:release-notes/3.13.0.adoc#vert-x-httpclient-based-http-conduit[Vert.x HttpClient based HTTP Conduit] in {quarkus-cxf-project-name} 3.13.0 and it was not supposed to replace the original `HttpURLConnection` based default conduit. However, we screwed the default handling which resulted in using `VertxHttpClientHTTPConduit` as a default in some cases. This was fixed in {quarkus-cxf-project-name} 3.13.1. diff --git a/docs/modules/ROOT/pages/release-notes/3.14.0.adoc b/docs/modules/ROOT/pages/release-notes/3.14.0.adoc index 5cf656223..b341eed76 100644 --- a/docs/modules/ROOT/pages/release-notes/3.14.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.14.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-14-0]] = {quarkus-cxf-project-name} 3.14.0 release notes == Important dependency upgrades @@ -8,7 +9,7 @@ === https://github.com/quarkiverse/quarkus-cxf/issues/1460[#1460] IllegalArgumentException: port p must be in range 0 <= p <= 65535 when using client-endpoint-url without explicit port -When using the xref:release-notes/3.13.0.adoc#_vert_x_httpclient_based_http_conduit[new `VertxHttpClientHTTPConduitFactory`], +When using the xref:release-notes/3.13.0.adoc#vert-x-httpclient-based-http-conduit[new `VertxHttpClientHTTPConduitFactory`], the handling of default ports for `http` and `https` client endpoint URLs was broken resulting in an `IllegalArgumentException`. This was fixed in {quarkus-cxf-project-name} 3.14.0. diff --git a/docs/modules/ROOT/pages/release-notes/3.15.0.adoc b/docs/modules/ROOT/pages/release-notes/3.15.0.adoc index d3ab935eb..013717325 100644 --- a/docs/modules/ROOT/pages/release-notes/3.15.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.15.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-15-0]] = {quarkus-cxf-project-name} 3.15.0 LTS release notes This is the first release in the new 3.15 https://quarkus.io/blog/lts-releases/[LTS stream]. diff --git a/docs/modules/ROOT/pages/release-notes/3.8.0.adoc b/docs/modules/ROOT/pages/release-notes/3.8.0.adoc index 1e614df44..042120db5 100644 --- a/docs/modules/ROOT/pages/release-notes/3.8.0.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.8.0.adoc @@ -1,3 +1,4 @@ +[[rn-3-8-0]] = {quarkus-cxf-project-name} 3.8.0 (LTS) release notes == Changes in Quarkus @@ -34,7 +35,7 @@ The new Maven coordinates starting with {quarkus-cxf-project-name} 3.8.0 are `io The following parts of the documentation were improved: -* The Reference page now contains xref:reference/index.adoc#_supported_cxf_annotations[List of supported CXF annotations]. +* The Reference page now contains xref:reference/index.adoc#supported-cxf-annotations[List of supported CXF annotations]. * xref:reference/extensions/quarkus-cxf-rt-ws-security.adoc[WS-Security extension page] ** New example using xref:reference/index.adoc#extensions-quarkus-cxf-rt-ws-security-usage-ws-security-via-ws-securitypolicy[WS-SecurityPolicy] ** New configuration options for xref:reference/extensions/quarkus-cxf-rt-ws-security.adoc#quarkus-cxf_quarkus-cxf-client-client-name-security-sts-client[STSClient] diff --git a/docs/modules/ROOT/pages/release-notes/3.8.1.adoc b/docs/modules/ROOT/pages/release-notes/3.8.1.adoc index ce5120881..cd060d5aa 100644 --- a/docs/modules/ROOT/pages/release-notes/3.8.1.adoc +++ b/docs/modules/ROOT/pages/release-notes/3.8.1.adoc @@ -1,3 +1,4 @@ +[[rn-3-8-1]] = {quarkus-cxf-project-name} 3.8.1 (LTS) release notes == Important dependency upgrades: @@ -11,9 +12,9 @@ === Mutual TLS (mTLS) -Mutual TLS (mTLS) is now xref:user-guide/ssl.adoc#mtls[documented], +Mutual TLS (mTLS) is now xref:user-guide/ssl-tls-https.adoc#mtls[documented], https://github.com/quarkiverse/quarkus-cxf/tree/main/integration-tests/mtls[tested] -and and can be configured for clients via `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-key-store[quarkus.cxf.client."client-name".key*]` family of options. +and can be configured for clients via `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-key-store[quarkus.cxf.client."client-name".key*]` family of options. === Keystores and truststores now looked up in the file system @@ -41,7 +42,7 @@ Now there is a way to do so via security policy and Quarkus configuration. + In the policy file, the `AlgorithmSuite` has to be set to `CustomAlgorithmSuite`: + -[[custom-algorithm-suite-example]] +[[rn-3-8-1-custom-algorithm-suite-example]] [source,xml] ---- generate-code` to `quarkus-maven-plugin` - for `java2ws`. +[NOTE] +==== +Unlike `wsdl2java` which is executed within Quarkus source generation phase, +`java2ws` is a part Quarkus augmentation that happens after compilation. +The input of `java2ws` are, after all, Java class files. +Hence you do not need to add `generate-code` to `quarkus-maven-plugin` +for `java2ws`. +==== == See also diff --git a/docs/modules/ROOT/pages/user-guide/create-project.adoc b/docs/modules/ROOT/pages/user-guide/create-project.adoc index 86795e36c..4efcd465d 100644 --- a/docs/modules/ROOT/pages/user-guide/create-project.adoc +++ b/docs/modules/ROOT/pages/user-guide/create-project.adoc @@ -1,3 +1,4 @@ +[[create-project]] = Create a new project This guide explains how to set up a new project for a Quarkus application hosting a CXF client or server or both. @@ -15,12 +16,12 @@ In addition to that, you may need * If you are on Linux, a container runtime like `docker` is sufficient for the native mode too. Use `-Pnative -Dquarkus.native.container-build=true` instead of `-Pnative` if you choose this option. -[[create-project]] -== Create project +[[create-a-project]] +== Creating a project New project skeletons can be generated using https://{link-quarkus-code-generator}/?e=io.quarkiverse.cxf%3Aquarkus-cxf&extension-search=origin:platform%20quarkus%20cxf[{link-quarkus-code-generator}]. -image::code.quarkus.io.png[https://code.quarkus.io] +image::code-quarkus-io.png[https://code.quarkus.io] * Here you can select the extensions that you want to work with. * For a simple Hello world Web service or client the `quarkus-cxf` extension is enough. diff --git a/docs/modules/ROOT/pages/user-guide/examples.adoc b/docs/modules/ROOT/pages/user-guide/examples.adoc index 9cd4ab9c9..15711133a 100644 --- a/docs/modules/ROOT/pages/user-guide/examples.adoc +++ b/docs/modules/ROOT/pages/user-guide/examples.adoc @@ -1,3 +1,4 @@ +[[examples]] = Examples The https://github.com/quarkiverse/quarkus-cxf/tree/main/integration-tests[`integration-tests` folder] of the codebase provides various examples diff --git a/docs/modules/ROOT/pages/user-guide/first-soap-client.adoc b/docs/modules/ROOT/pages/user-guide/first-soap-client.adoc index 57976b661..d158ff9f6 100644 --- a/docs/modules/ROOT/pages/user-guide/first-soap-client.adoc +++ b/docs/modules/ROOT/pages/user-guide/first-soap-client.adoc @@ -1,3 +1,4 @@ +[[first-soap-client]] = Your first SOAP Client on Quarkus In this guide we explain how to create a simple Quarkus application acting as a client of a remote Web service. @@ -140,7 +141,7 @@ include::example$calculator-client/application.properties[tag=first-soap-client. [TIP] ==== -All client configuration properties are documented in the xref:reference/extensions/quarkus-cxf.adoc#_configuration[Configuration properties] reference. +All client configuration properties are documented in the xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf-configuration[Configuration properties] reference. ==== With all the above files in place, we should be able to start the application in Quarkus {link-quarkus-docs-base}/maven-tooling#dev-mode[`dev` mode] diff --git a/docs/modules/ROOT/pages/user-guide/first-soap-web-service.adoc b/docs/modules/ROOT/pages/user-guide/first-soap-web-service.adoc index 2388883f2..e2bf9bb04 100644 --- a/docs/modules/ROOT/pages/user-guide/first-soap-web-service.adoc +++ b/docs/modules/ROOT/pages/user-guide/first-soap-web-service.adoc @@ -1,4 +1,4 @@ -[[first-steps]] +[[first-soap-web-service]] = Your first SOAP Web service on Quarkus In this guide we explain how to create a Quarkus application exposing a simple SOAP Web service. @@ -47,7 +47,7 @@ include::example$soap-service/application.properties[tag=first-web-service.adoc] [TIP] ==== -All configuration properties are documented in the xref:reference/extensions/quarkus-cxf.adoc#_configuration[Configuration properties] reference. +All configuration properties are documented in the xref:reference/extensions/quarkus-cxf.adoc[Configuration properties] reference. ==== [TIP] diff --git a/docs/modules/ROOT/pages/user-guide/index.adoc b/docs/modules/ROOT/pages/user-guide/index.adoc index 57c317b6e..82daf4cf5 100644 --- a/docs/modules/ROOT/pages/user-guide/index.adoc +++ b/docs/modules/ROOT/pages/user-guide/index.adoc @@ -1,4 +1,4 @@ -[[user-guide]] +[[user-guide-index]] = User guide This User guide explains typical use cases of {quarkus-cxf-project-name}. diff --git a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers.adoc b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers.adoc index e0473b951..4254ec7b0 100644 --- a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers.adoc +++ b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers.adoc @@ -1,3 +1,4 @@ +[[interceptors-features-handlers]] = CXF Interceptors and Features, JAX-WS Handlers Check the following chapters to learn a bout various ways to customize the processing of SOAP requests and responses: diff --git a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/cxf-interceptors-and-features.adoc b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/cxf-interceptors-and-features.adoc index b35b5a88c..16d3e3a66 100644 --- a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/cxf-interceptors-and-features.adoc +++ b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/cxf-interceptors-and-features.adoc @@ -1,4 +1,4 @@ -[[interceptors-and-features]] +[[cxf-interceptors-and-features]] = CXF Interceptors and Features https://cxf.apache.org/docs/interceptors.html[CXF interceptors] and https://cxf.apache.org/docs/featureslist.html[CXF features] can be added to both your client or server using either annotations or `application.properties` configurations. diff --git a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/jax-ws-handlers.adoc b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/jax-ws-handlers.adoc index 0c3eb4e9d..5dcb57438 100644 --- a/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/jax-ws-handlers.adoc +++ b/docs/modules/ROOT/pages/user-guide/interceptors-features-handlers/jax-ws-handlers.adoc @@ -1,4 +1,4 @@ -[[handlers]] +[[jax-ws-handlers]] = JAX-WS Handlers As an alternative to the `@HandlerChain` annotation, @@ -38,4 +38,4 @@ public class MySOAPHandler implements SOAPHandler { The `SOAPHandler` classes are loaded via CDI first.. If no CDI beans are available, the constructor without parameters will be invoked to instantiate each class. -==== \ No newline at end of file +==== diff --git a/docs/modules/ROOT/pages/user-guide/package-for-jvm-and-native.adoc b/docs/modules/ROOT/pages/user-guide/package-for-jvm-and-native.adoc index 1d4220c31..5c6777874 100644 --- a/docs/modules/ROOT/pages/user-guide/package-for-jvm-and-native.adoc +++ b/docs/modules/ROOT/pages/user-guide/package-for-jvm-and-native.adoc @@ -1,3 +1,4 @@ +[[package-for-jvm-and-native]] = Package for running on a JVM or natively In this chapter, we explain how to package a Quarkus CXF application for running on a JVM or for running it natively. diff --git a/docs/modules/ROOT/pages/user-guide/payload-logging.adoc b/docs/modules/ROOT/pages/user-guide/payload-logging.adoc index 004ec6c15..6e1307216 100644 --- a/docs/modules/ROOT/pages/user-guide/payload-logging.adoc +++ b/docs/modules/ROOT/pages/user-guide/payload-logging.adoc @@ -1,3 +1,4 @@ +[[payload-logging]] = Logging Refer to Quarkus {link-quarkus-docs-base}/logging[Logging guide] for basic information about logging on Quarkus, such as diff --git a/docs/modules/ROOT/pages/user-guide/soap-payloads-with-jaxb.adoc b/docs/modules/ROOT/pages/user-guide/soap-payloads-with-jaxb.adoc index af3cc9478..8e67684f9 100644 --- a/docs/modules/ROOT/pages/user-guide/soap-payloads-with-jaxb.adoc +++ b/docs/modules/ROOT/pages/user-guide/soap-payloads-with-jaxb.adoc @@ -1,3 +1,4 @@ +[[soap-payloads-with-jaxb]] = Complex SOAP payloads with JAXB Our introductory guides for Quarkus xref:user-guide/first-soap-client.adoc[SOAP client] @@ -7,9 +8,12 @@ Let's have a look at passing and receiving more complex objects. As an example, let's create an application for managing fruits. -NOTE: The sample code snippets used in this section come from the - https://github.com/quarkiverse/quarkus-cxf/tree/main/integration-tests/server[server integration test] - in the source tree of {quarkus-cxf-project-name} +[NOTE] +==== +The sample code snippets used in this section come from the +https://github.com/quarkiverse/quarkus-cxf/tree/main/integration-tests/server[server integration test] +in the source tree of {quarkus-cxf-project-name} +==== Because our representation of fruit is supposed to be a complex, let's model it as a Java bean with a couple of attributes: diff --git a/docs/modules/ROOT/pages/user-guide/ssl.adoc b/docs/modules/ROOT/pages/user-guide/ssl-tls-https.adoc similarity index 94% rename from docs/modules/ROOT/pages/user-guide/ssl.adoc rename to docs/modules/ROOT/pages/user-guide/ssl-tls-https.adoc index 356b44ab2..beb1297ff 100644 --- a/docs/modules/ROOT/pages/user-guide/ssl.adoc +++ b/docs/modules/ROOT/pages/user-guide/ssl-tls-https.adoc @@ -1,13 +1,14 @@ [[ssl-tls-https]] = SSL, TLS and HTTPS +:page-aliases: user-guide/ssl.adoc This section documents various use cases related to SSL, TLS and HTTPS. [NOTE] ==== The sample code snippets used in this section come from the - {link-quarkus-cxf-source-tree-base}/integration-tests/ws-security-policy[WS-SecurityPolicy integration test] - in the source tree of {quarkus-cxf-project-name} +{link-quarkus-cxf-source-tree-base}/integration-tests/ws-security-policy[WS-SecurityPolicy integration test] +in the source tree of {quarkus-cxf-project-name} ==== @@ -34,7 +35,7 @@ Once you have prepared the trust store, you need to configure your client to use This is the easiest way to set the client trust store. The key role is played by named TLS configurations delivered by {link-quarkus-docs-base}/tls-registry-reference[Quarkus TLS registry] -an by the `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-tls-configuration-name[quarkus.cxf.client."client-name".tls-configuration-name]` property. +and by the `xref:reference/extensions/quarkus-cxf.adoc#quarkus-cxf_quarkus-cxf-client-client-name-tls-configuration-name[quarkus.cxf.client."client-name".tls-configuration-name]` property. [NOTE] ==== @@ -108,7 +109,7 @@ using the same means of public key cryptography. Hence, for the Mutual TLS (mTLS) authentication, in addition to setting up the server keystore and client truststore as described above, -you need to setup the keystore on the client side and the truststore on the server side. +you need to set up the keystore on the client side and the truststore on the server side. The tools for creating and maintaining the stores are the same and the configuration properties to use are pretty much analogous to the ones used in the Simple TLS case. diff --git a/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/Java2WsdlProcessor.java b/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/Java2WsdlProcessor.java index 1572df02c..37ed9e0fd 100644 --- a/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/Java2WsdlProcessor.java +++ b/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/Java2WsdlProcessor.java @@ -128,7 +128,7 @@ static void java2wsdl( throw new IllegalStateException("Service class " + serviceClass + " was already selected by\n\n" + oldSelectors + "\n\nand therefore it cannot once again be selected by\n\n" + selectors - + "\n\nPlease make sure that the individual include/exclude sets are mutually exclusive."); + + "\n\nEnsure that the individual include/exclude sets are mutually exclusive."); } processedClasses.put(serviceClass.toString(), selectors); diff --git a/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGen.java b/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGen.java index df53e961b..a4811b7f7 100644 --- a/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGen.java +++ b/extensions/core/deployment/src/main/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGen.java @@ -154,7 +154,7 @@ public static boolean scan( throw new IllegalStateException("WSDL file " + wsdlFile + " was already selected by\n\n" + oldSelectors + "\n\nand therefore it cannot once again be selected by\n\n" + selectors - + "\n\nPlease make sure that the individual include/exclude sets are mutually exclusive."); + + "\n\nEnsure that the individual include/exclude sets are mutually exclusive."); } processedFiles.put(wsdlFile.toString(), selectors); wsdlFileConsumer.accept(wsdlFile); diff --git a/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGenTest.java b/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGenTest.java index 83c0dc756..17ab3bd09 100644 --- a/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGenTest.java +++ b/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/codegen/Wsdl2JavaCodeGenTest.java @@ -124,7 +124,7 @@ void scanOverlappingSelections() throws IOException { io.quarkiverse.cxf.deployment.codegen.Wsdl2JavaCodeGen.WSDL2JAVA_CONFIG_KEY_PREFIX + ".my-name", files, foundFiles::add)) - .withMessageContaining("Please make sure that the individual include/exclude sets are mutually exclusive"); + .withMessageContaining("Ensure that the individual include/exclude sets are mutually exclusive"); } diff --git a/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/java2ws/IncludesConflictJava2WsTest.java b/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/java2ws/IncludesConflictJava2WsTest.java index b6d4f5ef3..98be46668 100644 --- a/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/java2ws/IncludesConflictJava2WsTest.java +++ b/extensions/core/deployment/src/test/java/io/quarkiverse/cxf/deployment/java2ws/IncludesConflictJava2WsTest.java @@ -37,7 +37,7 @@ public class IncludesConflictJava2WsTest { .overrideConfigKey("quarkus.cxf.java2ws.group_02.wsdl-name-template", "%TARGET_DIR%/" + TEST_DIR + "/%SIMPLE_CLASS_NAME%.wsdl") .assertException(t -> Assertions.assertThat(t).isInstanceOf(IllegalStateException.class) - .hasMessageContaining("Please make sure that the individual include/exclude sets are mutually exclusive")); + .hasMessageContaining("Ensure that the individual include/exclude sets are mutually exclusive")); @Test public void generationTest() throws IOException { diff --git a/extensions/core/runtime/src/main/doc/usage.adoc b/extensions/core/runtime/src/main/doc/usage.adoc index cb5a7a8de..8ff6cd8ea 100644 --- a/extensions/core/runtime/src/main/doc/usage.adoc +++ b/extensions/core/runtime/src/main/doc/usage.adoc @@ -5,8 +5,8 @@ There are several chapters in the xref:user-guide/index.adoc[User guide] coverin * xref:user-guide/configuration.adoc[Configuration] * xref:user-guide/package-for-jvm-and-native.adoc[Package for JVM and native] * xref:user-guide/payload-logging.adoc[Logging] -* xref:user-guide/ssl.adoc[SSL] -* xref:user-guide/auth.adoc[Authentication and authorization] +* xref:user-guide/ssl-tls-https.adoc[SSL] +* xref:user-guide/authentication-authorization.adoc[Authentication and authorization] * xref:user-guide/advanced-soap-client-topics.adoc[Advanced SOAP client topics] * xref:user-guide/advanced-service-topics/running-behind-a-reverse-proxy.adoc[Running behind a reverse proxy] * xref:user-guide/contract-first-code-first/generate-java-from-wsdl.adoc[Generate Java from WSDL] diff --git a/extensions/features-metrics/runtime/src/main/doc/intro.adoc b/extensions/features-metrics/runtime/src/main/doc/intro.adoc index 4f78cc0da..26106b030 100644 --- a/extensions/features-metrics/runtime/src/main/doc/intro.adoc +++ b/extensions/features-metrics/runtime/src/main/doc/intro.adoc @@ -1,5 +1,8 @@ Collect metrics using https://micrometer.io/[Micrometer]. -IMPORTANT: Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature], - this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics]. - Only Micrometer is supported. +[IMPORTANT] +==== +Unlike https://cxf.apache.org/docs/metrics.html[CXF Metrics feature], +this {quarkus-cxf-project-name} extension does not support https://cxf.apache.org/docs/dropwizard-metrics.html[Dropwizard Metrics]. +Only Micrometer is supported. +==== diff --git a/extensions/integration-tracing-opentelemetry/runtime/src/main/doc/intro.adoc b/extensions/integration-tracing-opentelemetry/runtime/src/main/doc/intro.adoc index 66db513ec..4d14b597f 100644 --- a/extensions/integration-tracing-opentelemetry/runtime/src/main/doc/intro.adoc +++ b/extensions/integration-tracing-opentelemetry/runtime/src/main/doc/intro.adoc @@ -1,5 +1,8 @@ Generate https://opentelemetry.io/[OpenTelemetry] https://opentelemetry.io/docs/concepts/signals/traces/[traces]. -IMPORTANT: OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side, - hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus - the only OpenTelemetry feature supported by this extension. +[IMPORTANT] +==== +OpenTelemetry Metrics and Logging are not supported yet on neither Quarkus nor CXF side, +hence {quarkus-cxf-project-name} cannot support them either. Tracing is thus +the only OpenTelemetry feature supported by this extension. +==== \ No newline at end of file diff --git a/extensions/ws-security/runtime/src/main/java/io/quarkiverse/cxf/ws/security/CxfWsSecurityConfig.java b/extensions/ws-security/runtime/src/main/java/io/quarkiverse/cxf/ws/security/CxfWsSecurityConfig.java index c1bdd0171..0420a82df 100644 --- a/extensions/ws-security/runtime/src/main/java/io/quarkiverse/cxf/ws/security/CxfWsSecurityConfig.java +++ b/extensions/ws-security/runtime/src/main/java/io/quarkiverse/cxf/ws/security/CxfWsSecurityConfig.java @@ -1504,8 +1504,11 @@ interface StsClientConfig { * cannot thus be used as a CDI bean type, you can use the wrapper class * `io.quarkiverse.cxf.ws.security.sts.client.STSClientBean` instead. * - * Tip: Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page + * [TIP] + * ==== + * Check the xref:reference/extensions/quarkus-cxf-services-sts.adoc[Security Token Service (STS)] extension page * for more information about WS-Trust. + * ==== * * @since 3.8.0 * @asciidoclet