Quarkus CXF exposes a large number of configuration options. Each extension documents its options at the bottom of its reference page.

The configuration options can be set in file or via environment variables - see Quarkus configuration reference for details.

Bean references

Several configuration options of Quarkus CXF allow referring to beans present in Quarkus CDI container. Features and interceptors are typical examples of those.

There are two ways how to set a bean reference in the configuration: by type or by bean name.

Bean reference by type

Here is an example:
# bean reference by type
quarkus.cxf.endpoint."/hello".features = org.apache.cxf.ext.logging.LoggingFeature

When using a reference by type name, the resolution proceeds as follows:

  • Fist the bean is looked up in Quarkus CDI container by type.

  • If the bean is available, it is used.

  • If multiple beans assignable to the given type, then an exception is thrown.

  • If no matching bean is available, then the class is loaded and an attempt is performed to instantiate it using its default constructor.

Bean reference by bean name

Here is an example:
# bean reference by bean name
quarkus.cxf.endpoint."/fruit".features = #myCustomLoggingFeature

When using a reference by bean name, then unsurprisingly, the bean is looked up in Quarkus CDI container by name. A named bean called myCustomLoggingFeature can be defined as follows:

import org.apache.cxf.ext.logging.LoggingFeature;
import javax.enterprise.context.ApplicationScoped;
import javax.enterprise.inject.Produces;

class Producers {

    LoggingFeature myCustomLoggingFeature() {
        LoggingFeature loggingFeature = new LoggingFeature();
        return loggingFeature;