Red Hat SummitChapter 4. Quarkus CXF overview
This chapter provides information about Quarkus CXF extensions, CXF modules and CXF annotations supported by Quarkus CXF.
4.1. Quarkus CXF
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.
| Quarkus CXF extension | Support level | Since | Supported standards |
|---|---|---|---|
|
Quarkus CXF | Stable | 0.1.0 | |
|
Quarkus CXF Metrics Feature | Stable | 0.14.0 | |
|
Quarkus CXF OpenTelemetry | Stable | 2.7.0 | |
|
Quarkus CXF WS-Security | Stable | 0.14.0 | |
|
Quarkus CXF WS-ReliableMessaging | Stable | 1.5.3 | |
|
Quarkus CXF Security Token Service (STS) | Stable | 1.5.3 | |
|
Quarkus CXF HTTP Async Transport | Stable | 1.1.0 | |
|
Quarkus CXF XJC Plugins | Stable | 1.5.11 |
4.2. Supported CXF modules
Here is a list of CXF modules supported by Quarkus CXF. You should typically not depend on these directly, but rather use some of the extensions listed above that brings the given CXF module as a transitive dependency.
4.2.1. Front ends
Out of CXF front ends only the JAX-WS front end is fully supported by quarkus-cxf.
The Simple front end may work in JVM mode, but it is not tested properly. We advise not to use it.
4.2.2. Data Bindings
Out of CXF Data Bindings only the following ones are supported:
4.2.3. Transports
Out of CXF Transports only the following ones are supported:
-
quarkus-cxfimplements its own custom transport based on Quarkus and Vert.x for serving SOAP endpoints HTTP client via
quarkus-cxf, including-
Asynchronous Client HTTP Transport via
quarkus-cxf-rt-transports-http-hc5
4.2.4. Tools
-
wsdl2Java- see the Generate the Model classes from WSDL section of User guide -
java2ws- see the Generate WSDL from Java section of User guide
4.2.5. Supported SOAP Bindings
All CXF WSDL Bindings are supported. In order to switch to SOAP 1.2 or to add MTOM, set quarkus.cxf.[client|endpoint]."name".soap-binding to one of the following values:
| Binding | Property Value |
|---|---|
| SOAP 1.1 (default) | |
| SOAP 1.2 | |
| SOAP 1.1 with MTOM | |
| SOAP 1.2 with MTOM |
4.3. Unsupported CXF modules
Here is a list of CXF modules currently not supported by Quarkus CXF along with possible alternatives and/or reasons why the given module is not supported.
| CXF module | Alternative |
|---|---|
|
JAX-RS | |
| Use JAXB and JAX-WS | |
|
DOSGI | |
| JiBX | Use JAXB and JAX-WS |
|
Local transport | Use HTTP transport |
|
JMS transport | Use HTTP transport |
|
JBI | Deprecated in CXF use HTTP transport |
|
UDP transport | Use HTTP transport |
| Use HTTP transport | |
|
WebSocket transport | Use HTTP transport |
|
Clustering | |
|
CORBA | Use JAX-WS |
|
SDO databinding | |
| Deprecated in CXF | |
| Use JAX-WS | |
| Use HTTP transport | |
|
WS-Transfer runtime | |
|
Throttling | Use load balancer |
4.4. Supported CXF annotations
Here is the status of CXF annotations on Quarkus. Unless stated otherwise, the support is available via io.quarkiverse.cxf:quarkus-cxf.
| Annotation | Status |
|---|---|
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
|
Only the default value |
|
| Supported |
|
| Supported |
|
|
Supported via |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
|
| Supported |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}