feign.soap

Class SOAPEncoder

java.lang.Object

feign.soap.SOAPEncoder

All Implemented Interfaces:

Encoder

public class SOAPEncoder
extends Object
implements Encoder

Encodes requests using SOAPMessage and JAXB for the body part.

Basic example with with Feign.Builder:

 public interface MyApi {

    @RequestLine("POST /getObject")
    @Headers({
      "SOAPAction: getObject",
      "Content-Type: text/xml"
    })
    MyJaxbObjectResponse getObject(MyJaxbObjectRequest request);

 }

 ...

 JAXBContextFactory jaxbFactory = new JAXBContextFactory.Builder()
     .withMarshallerJAXBEncoding("UTF-8")
     .withMarshallerSchemaLocation("http://apihost http://apihost/schema.xsd")
     .build();

 api = Feign.builder()
     .encoder(new SOAPEncoder(jaxbFactory))
     .target(MyApi.class, "http://api");

 ...

 try {
    api.getObject(new MyJaxbObjectRequest());
 } catch (SOAPFaultException faultException) {
    log.info(faultException.getFault().getFaultString());
 }
 

The JAXBContextFactory should be reused across requests as it caches the created JAXB contexts.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SOAPEncoder.Builder Creates instances of SOAPEncoder.

Nested classes/interfaces inherited from interface feign.codec.Encoder

Encoder.Default

Field Summary

Fields inherited from interface feign.codec.Encoder

MAP_STRING_WILDCARD

Constructor Summary

Constructors

Constructor and Description
SOAPEncoder(JAXBContextFactory jaxbContextFactory)
SOAPEncoder(SOAPEncoder.Builder builder)

Method Summary

Modifier and Type	Method and Description
void	encode(Object object, Type bodyType, RequestTemplate template)
protected SOAPMessage	modifySOAPMessage(SOAPMessage soapMessage) Override this in order to modify the SOAP message object before it's finally encoded.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SOAPEncoder

public SOAPEncoder(SOAPEncoder.Builder builder)

SOAPEncoder

public SOAPEncoder(JAXBContextFactory jaxbContextFactory)

Method Detail

encode

public void encode(Object object,
                   Type bodyType,
                   RequestTemplate template)

Specified by:

encode in interface Encoder

modifySOAPMessage

protected SOAPMessage modifySOAPMessage(SOAPMessage soapMessage)
                                 throws SOAPException

Override this in order to modify the SOAP message object before it's finally encoded.
This might be useful to add SOAP Headers, which are not supported by this SOAPEncoder directly.
This is an example of how to add a security header: protected SOAPMessage modifySOAPMessage(SOAPMessage soapMessage) throws SOAPException { SOAPFactory soapFactory = SOAPFactory.newInstance(); String uri = "http://schemas.xmlsoap.org/ws/2002/12/secext"; String prefix = "wss"; SOAPElement security = soapFactory.createElement("Security", prefix, uri); SOAPElement usernameToken = soapFactory.createElement("UsernameToken", prefix, uri); usernameToken.addChildElement("Username", prefix, uri).setValue("test"); usernameToken.addChildElement("Password", prefix, uri).setValue("test"); security.addChildElement(usernameToken); soapMessage.getSOAPHeader().addChildElement(security); return soapMessage; }

Throws:

SOAPException