You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by pp...@apache.org on 2023/06/01 09:10:51 UTC
[camel-quarkus] branch 2.13.x updated: Fix broken formatting on the CXF extension page
This is an automated email from the ASF dual-hosted git repository.
ppalaga pushed a commit to branch 2.13.x
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
The following commit(s) were added to refs/heads/2.13.x by this push:
new d3623914fb Fix broken formatting on the CXF extension page
d3623914fb is described below
commit d3623914fb440801cc39b624d83caa0d36458052
Author: Peter Palaga <pp...@redhat.com>
AuthorDate: Thu Jun 1 10:17:54 2023 +0200
Fix broken formatting on the CXF extension page
---
.../ROOT/pages/reference/extensions/cxf-soap.adoc | 19 +++++++++++++------
extensions/cxf-soap/runtime/src/main/doc/usage.adoc | 19 +++++++++++++------
2 files changed, 26 insertions(+), 12 deletions(-)
diff --git a/docs/modules/ROOT/pages/reference/extensions/cxf-soap.adoc b/docs/modules/ROOT/pages/reference/extensions/cxf-soap.adoc
index b21cc7131f..0d7dd0cd68 100644
--- a/docs/modules/ROOT/pages/reference/extensions/cxf-soap.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/cxf-soap.adoc
@@ -130,12 +130,14 @@ public interface CalculatorService {
<1> NOTE: JAX-WS annotations are required. The Simple CXF Frontend is not supported. Complex parameter types require JAXB annotations to work in properly in native mode.
[TIP]
+====
You can test this client application against the https://quay.io/repository/l2x6/calculator-ws[quay.io/l2x6/calculator-ws:1.2] container that implements this service endpoint interface:
-+
+
[source,shell]
----
$ docker run -p 8082:8080 quay.io/l2x6/calculator-ws:1.2
----
+====
NOTE: `quarkus-cxf` supports {link-quarkus-cxf-doc}/user-guide/first-soap-client.html[injecting SOAP clients]
using `@io.quarkiverse.cxf.annotation.CXFClient` annotation.
@@ -196,10 +198,13 @@ and `http://localhost:8080/soap-services/hello-inline` respectively.
The WSDL can be accessed by adding `?wsdl` to the above URLs.
-IMPORTANT: Do not use `quarkus.cxf.path = /` in your application unless you are 100% sure that no other extension will want to expose HTTP endpoints.
-+
+[IMPORTANT]
+====
+Do not use `quarkus.cxf.path = /` in your application unless you are 100% sure that no other extension will want to expose HTTP endpoints.
+
Before `quarkus-cxf` 2.0.0 (i.e. before {project-name} 3.0.0), the default value of `quarkus.cxf.path` was `/`. The default was changed because it prevented other Quarkus extensions from exposing any further HTTP endpoints.
Among others, RESTEasy, Vert.x, SmallRye Health (no health endpoints exposed!) were impacted by this.
+====
NOTE: `quarkus-cxf` supports alternative ways of exposing SOAP endpoints.
Refer to the {link-quarkus-cxf-doc}/user-guide/first-soap-web-service.html[SOAP Services] chapter of `quarkus-cxf` user guide for more details.
@@ -293,12 +298,14 @@ TIP: Both {project-name} and Quarkus CXF contain a number of
IMPORTANT: For `wsdl2Java` to work properly, your application will have to directly depend on `io.quarkiverse.cxf:quarkus-cxf`.
-TIP: While `wsdlvalidator` is not supported, you can use `wsdl2Java` with the following configuration in `application.properties`
- to validate your WSDLs:
-+
+[TIP]
+====
+While `wsdlvalidator` is not supported, you can use `wsdl2Java` with the following configuration in `application.properties` to validate your WSDLs:
+
.application.properties
[source,properties]
----
quarkus.cxf.codegen.wsdl2java.additional-params = -validate
----
+====
diff --git a/extensions/cxf-soap/runtime/src/main/doc/usage.adoc b/extensions/cxf-soap/runtime/src/main/doc/usage.adoc
index 291c658919..24b68d6a6f 100644
--- a/extensions/cxf-soap/runtime/src/main/doc/usage.adoc
+++ b/extensions/cxf-soap/runtime/src/main/doc/usage.adoc
@@ -79,12 +79,14 @@ public interface CalculatorService {
<1> NOTE: JAX-WS annotations are required. The Simple CXF Frontend is not supported. Complex parameter types require JAXB annotations to work in properly in native mode.
[TIP]
+====
You can test this client application against the https://quay.io/repository/l2x6/calculator-ws[quay.io/l2x6/calculator-ws:1.2] container that implements this service endpoint interface:
-+
+
[source,shell]
----
$ docker run -p 8082:8080 quay.io/l2x6/calculator-ws:1.2
----
+====
NOTE: `quarkus-cxf` supports {link-quarkus-cxf-doc}/user-guide/first-soap-client.html[injecting SOAP clients]
using `@io.quarkiverse.cxf.annotation.CXFClient` annotation.
@@ -144,10 +146,13 @@ and `http://localhost:8080/soap-services/hello-inline` respectively.
The WSDL can be accessed by adding `?wsdl` to the above URLs.
-IMPORTANT: Do not use `quarkus.cxf.path = /` in your application unless you are 100% sure that no other extension will want to expose HTTP endpoints.
-+
+[IMPORTANT]
+====
+Do not use `quarkus.cxf.path = /` in your application unless you are 100% sure that no other extension will want to expose HTTP endpoints.
+
Before `quarkus-cxf` 2.0.0 (i.e. before {project-name} 3.0.0), the default value of `quarkus.cxf.path` was `/`. The default was changed because it prevented other Quarkus extensions from exposing any further HTTP endpoints.
Among others, RESTEasy, Vert.x, SmallRye Health (no health endpoints exposed!) were impacted by this.
+====
NOTE: `quarkus-cxf` supports alternative ways of exposing SOAP endpoints.
Refer to the {link-quarkus-cxf-doc}/user-guide/first-soap-web-service.html[SOAP Services] chapter of `quarkus-cxf` user guide for more details.
@@ -238,11 +243,13 @@ TIP: Both {project-name} and Quarkus CXF contain a number of
IMPORTANT: For `wsdl2Java` to work properly, your application will have to directly depend on `io.quarkiverse.cxf:quarkus-cxf`.
-TIP: While `wsdlvalidator` is not supported, you can use `wsdl2Java` with the following configuration in `application.properties`
- to validate your WSDLs:
-+
+[TIP]
+====
+While `wsdlvalidator` is not supported, you can use `wsdl2Java` with the following configuration in `application.properties` to validate your WSDLs:
+
.application.properties
[source,properties]
----
quarkus.cxf.codegen.wsdl2java.additional-params = -validate
----
+====
\ No newline at end of file