Reference

Quarkus CXF

The following table shows the Quarkus CXF extensions. Click the extension names to learn more about how to configure and use them, and about any known limitations.

Quarkus CXF extension Support level Since Supported standards

Quarkus CXF
quarkus-cxf

Stable

0.1.0

JAX-WS, JAXB, WS-Addressing, WS-Policy, MTOM

Quarkus CXF Metrics Feature
quarkus-cxf-rt-features-metrics

Stable

0.14.0

Quarkus CXF OpenTelemetry
quarkus-cxf-integration-tracing-opentelemetry

Stable

2.7.0

Quarkus CXF WS-Security
quarkus-cxf-rt-ws-security

Stable

0.14.0

WS-Security, WS-SecurityPolicy

Quarkus CXF WS-ReliableMessaging
quarkus-cxf-rt-ws-rm

Stable

1.5.3

WS-ReliableMessaging

Quarkus CXF Security Token Service (STS)
quarkus-cxf-services-sts

Stable

1.5.3

WS-Trust

Quarkus CXF HTTP Async Transport
quarkus-cxf-rt-transports-http-hc5

Stable

1.1.0

Quarkus CXF XJC Plugins
quarkus-cxf-xjc-plugins

Stable

1.5.11

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.

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.

Data Bindings

Out of CXF Data Bindings only the following ones are supported:

Transports

Out of CXF Transports only the following ones are supported:

Tools

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)

http://schemas.xmlsoap.org/wsdl/soap/http

SOAP 1.2

http://www.w3.org/2003/05/soap/bindings/HTTP/

SOAP 1.1 with MTOM

http://schemas.xmlsoap.org/wsdl/soap/http?mtom=true

SOAP 1.2 with MTOM

http://www.w3.org/2003/05/soap/bindings/HTTP/?mtom=true

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
cxf-rt-frontend-jaxrs
cxf-rt-rs-client

Use Quarkus RESTEasy

Fediz

Use Quarkus OpenID Connect

Aegis

Use JAXB and JAX-WS

DOSGI
Karaf

JiBX

Use JAXB and JAX-WS

Local transport
cxf-rt-transports-local

Use HTTP transport

JMS transport
cxf-rt-transports-jms

Use HTTP transport

JBI
cxf-rt-transports-jbi
cxf-rt-bindings-jbi

Deprecated in CXF use HTTP transport

UDP transport
cxf-rt-transports-udp

Use HTTP transport

Coloc transport

Use HTTP transport

WebSocket transport
cxf-rt-transports-websocket

Use HTTP transport

Clustering
cxf-rt-features-clustering

Planned

CORBA cxf-rt-bindings-corba

Use JAX-WS

SDO databinding
cxf-rt-databinding-sdo

XMLBeans

Deprecated in CXF

Javascript frontend

Use JAX-WS

JCA transport

Use HTTP transport

WS-Transfer runtime
cxf-rt-ws-transfer

Throttling
cxf-rt-features-throttling

Use load balancer

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

@org.apache.cxf.feature.Features

Supported

@org.apache.cxf.interceptor.InInterceptors

Supported

@org.apache.cxf.interceptor.OutInterceptors

Supported

@org.apache.cxf.interceptor.OutFaultInterceptors

Supported

@org.apache.cxf.interceptor.InFaultInterceptors

Supported

@org.apache.cxf.annotations.WSDLDocumentation

Supported

@org.apache.cxf.annotations.WSDLDocumentationCollection

Supported

@org.apache.cxf.annotations.SchemaValidation

Supported

@org.apache.cxf.annotations.DataBinding

Only the default value org.apache.cxf.jaxb.JAXBDataBinding is supported

@org.apache.cxf.ext.logging.Logging

Supported

@org.apache.cxf.annotations.GZIP

Supported

@org.apache.cxf.annotations.FastInfoset

Supported via com.sun.xml.fastinfoset:FastInfoset dependency

@org.apache.cxf.annotations.EndpointProperty

Supported

@org.apache.cxf.annotations.EndpointProperties

Supported

@org.apache.cxf.annotations.Policy

Supported

@org.apache.cxf.annotations.Policies

Supported

@org.apache.cxf.annotations.UseAsyncMethod

Supported