What's the difference between MTOM and the attachment features provided by SAAJ?

soap jax-ws mtom saaj
Jops picture Jops · Mar 18, 2013 · Viewed 14.2k times · Source

SAAJ: SOAP with Attachments API for Java

MTOM: SOAP Message Transmission Optimization Mechanism

My simple understanding: they deal with SOAP attachments, with MTOM being the more optimized version of SAAJ. Is this correct?

Are they simply 2 different ways of doing the same thing? Or am I trying to compare apples and oranges here?

Can I use SAAJ and MTOM together?

Answer

Piotr Kochański picture Piotr Kochański · Mar 18, 2013

It is a little bit more complicated. SAAJ is an old Java API for used to manipulate SOAP envelopes, so sending binary attachments can be done in a sane way (that is not as a BASE64 encoded string in message body). SAAJ is a sort of low level interface, you need to construct SOAP envelope "by hand" in your code and add attachments to it.

If you don't need to work with legacy code and you want to work directly with SOAP envelopes, then look on JAX-WS Dispatcher and Provider interfaces.

MTOM is a another beast. It is not a full web service API - it is specialized way of sending attachments. It can be used by any "true" web service API like JAX-WS or SAAJ (if you manage to force SAAJ to work that way).

MTOM is (almost) always used with XOP, a more efficient way to send binary data, as compared to BASE64 (which has large overhead). Attachment is sent separately as MIME attachment and the MIME type is handled properly (that used to be an issue for Java-Microsoft technologies interactions).

Nowdays forget about SAAJ, use JAX-WS + MTOM support which is provided by most JAX-WS implementations.

Related questions

Java (web service - SOAP) - How do I add a SOAP handler on the client side and enable MTOM correct?

Java - JDK 1.6.0.7 - WSGEN -version: JAX-WS RI 2.2.3-b01- I have the following problem: SOAPBinding binding = (SOAPBinding)((BindingProvider)port).getBinding(); binding.setMTOMEnabled(true); List<Handler> handlerChain = new ArrayList<Handler>(); handlerChain.addAll(binding.getHandlerChain()); handlerChain.add(…

Read More
Building large MTOM/XOP messages with JAX-WS

I have a question about using MTOM/XOP with JAX-WS. I'm writing a web service which sends large amounts of binary data. The client requests a number of files and the server returns the files in the response. I'm able …

Read More
How to do a SOAP Web Service call from Java class?

I'm relative new to the webservices world and my research seems to have confused me more than enlighten me, my problem is that I was given a library(jar) which I have to extend with some webservice functionality. This library …

Read More