How to ignore/disable/revert/override JAXB class-level @XmlJavaTypeAdapter in certain situations ?

  • From: Charles Ouimet <charles.ouimet@...>
  • To: users@...
  • Subject: How to ignore/disable/revert/override JAXB class-level @XmlJavaTypeAdapter in certain situations ?
  • Date: Fri, 8 Nov 2013 10:10:05 -0500


Our model classes are annotated with @XmlJavaTypeAdapter (at the
class-level). Unmarshalling works fine for the root element and
containment/nesting (according to what we implemented in our custom

So far, we were happy campers for both XML and JSON
serialization/deserialization. However, a new need arose and I can't figure
out how to implement it ?

In certain situations, I'd like to be able to "revert" to default JAXB
behavior for containment: I want the class-level @XmlJavaTypeAdapter
annotation to be ignored/overriden.

I spent hours reading Blaise Doughan's blog ( and
searching StackOverflow and Google but can't find an elegant/pragmatic

Here is a quick setup to illustrate what we currently have (please note
that all our JPA/Hibernate/other annotations are not listed for
simplicity-sake but they do exist in our model classes (POJOs)):

Class Master

public class Master {
    private Long masterPrimaryKey;

    private String name;

Class Detail

public class Detail {
    private Long detailPrimaryKey;

    private Master master; // reference/foreign key. No need for
@XmlJavaTypeAdapter since it's defined at the class-level in Master.

    private String value;

When Master is used as a the root element, the XML is like this:

    <name>master name</name>
When Master is used as a contained/nested element, the XML is like this:
(thanks to our custom XmlAdapter, the <master> element is "summarized" by
its primary key)

    <value>detail value</value>

So far, everything works fine and we're happy with it.

Now, our new need:

I'd like containment to work in a different way in specific situations. I
want the class-level @XmlJavaTypeAdapter on Master to "temporarily" be
ignored/reverted/overridden in a specific context. I'd expect the default
JAXB unmarshaller to kick-in (as if there had never been a class-level
@XmlJavaTypeAdapter on the contained classes).

Think about a data-import situation where we receive the master and all the
details in one payload. As if they were all independent root elements
wrapped in a big DTO/transport container.

Here is the XML presenting what we want:

        <!-- Primary keys omitted because of the import mode -->
        <name>master name</name>

            <value>detail 1 value</value>

            <value>detail 2 value</value>

            <value>detail 3 value</value>

Class MasterDetailImport

public class MasterDetailImport implements Serializable

    private Master master;


    private List<Detail> detail = new ArrayList<Detail>();

What I'm looking for is the magic [yet non-existing]
annotation that would allow me to instruct JAXB to do as if
@XmlJavaTypeAdapter had never been defined at the class-level for the
nested classes.

So far, the solutions we envisioned [and don't like] are:

1. Create "mirror" DTO objects for deserialization only when we must
support import. The are many cons with this approach (duplicate code only
used for deserialization, adapters to copy the DTO content into the model
class, more unit tests to write/maintain, etc).

2. Get rid of class-level @XmlJavaTypeAdapter on all our entities we want
to be able to import/nest and explicitly use @XmlJavaTypeAdapter on all
attributes where nesting/containment is used. I tested this approach and
know it would work. However, I think it's error prone and not as elegant as
defining it at class-level and be able to have an
exception/special-case/override handling telling JAXB to temporarily behave
as if it never knew @XmlJavaTypeAdapter has been defined on the class.

I'm running out of ideas here... I tried looking for JAXB's default XML
adapter but was not successful:
javax.xml.bind.annotation.adapters.XmlAdapter<ValueType,BoundType> is
abstract and inherits from Java.lang.Object.

Now, the simple question: How to implement

PS: I posted the same question on StackOverflow (,
I'm reaching to the mailing list to have a more specialized audience.

Thanks in advance !


How to ignore/disable/revert/override JAXB class-level @XmlJavaTypeAdapter in certain situations ?

Charles Ouimet 11/08/2013

Remove empty optional elements from xml

Krzysztof Sobkowiak 11/27/2013

Re: Remove empty optional elements from xml

Wolfgang Laun 11/27/2013

Re: Remove empty optional elements from xml

Krzysztof Sobkowiak 11/27/2013
Terms of Use; Privacy Policy; Copyright ©2013-2014 (revision 20140418.2d69abc)
Please Confirm