CXF Extension for Quarkus
SOAP (Simple Object Access Protocol) is a normalized exchange protocol based on XML, predating the era of REST services.
This extension enables you to develop web services that consume and produce SOAP payloads using the Apache CXF libraries.
-
CXF implements the Java API for XML Web Services (JAX-WS) which makes building web services easy.
-
CXF supports a variety of web service specifications including WS-Addressing, WS-Policy, WS-Reliable Messaging and WS-Security.
This extension provides access to all these specifications for your Quarkus applications (testing and documentation in progress).
Native Mode Support
Native mode is currently supported for Java 11.
In addition to the core quarkus-cxf
module, you may also leverage the following modules for full native support of the respective CXF modules.
-
quarkus-cxf-rt-features-logging
-
quarkus-cxf-rt-features-metrics
-
quarkus-cxf-rt-ws-security
-
quarkus-cxf-rt-transports-http-hc5
Contract vs Code First
Contract and code first development are both fully supported in this extension.
You can refer to the following CXF links for more details on the different styles of developing a service consumer or provider.
-
Developing a service consumer (or client)
-
Developing a service using JAX-WS
CXF provides a wsdl2java utility as well as a Maven plugin called cxf-codegen-plugin to generate fully annotated Java code from a WSDL document. The autogenerated Java classes are fully compatible with this extension.
Sample Code
The integration-tests
module in the codebase provides various examples that demonstrate how to use this extension effectively.
Issues and Support
Please feel free to start a discussion or open an issue in the GitHub repository in case you need support. The following general guidelines can be used to determine whether to start a discussion or open an issue.