Estou trabalhando com o JAXB agora e estou lutando para anotar minha noção composta de consulta de pré-condição para que o JAXB fique feliz.

Uma consulta de pré-condição pode ser:

simples: apenas um nó de texto que contém a consultacompostoOR: as pré-condições de uma consulta de pré-condição OU as outras correspondênciasAND: as pré-condições de 1 consulta de pré-condição E as outras correspondências

Obviamente, as consultas compostas podem ser feitas a partir de consultas compostas, como no exemplo a seguir:

    <precondition>
        <or>
            <and>
                <query>foo</query>
                <query>bar</query>
            </and>
            <query>baz</query>
        </or>
    </precondition>

No meu modelo Java, tenho uma única interface anotada PreconditionQuery (na verdade, uma classe abstrata, pois o JAXB parece insatisfeito com as interfaces) com 3 implementações SimplePreconditionQuery, CompoundOrPreconditionQuery e CompoundAndPreconditionQuery.

@XmlSeeAlso(PreconditionQuery.class)
@XmlRootElement(name = "query")
public class SimplePreconditionQuery extends PreconditionQuery {

    private String query;

    @XmlValue
    public String getQuery() {
        return query;
    }

    public void setQuery(String query) {
        this.query = query;
    }
}

Para os compostos (CompoundOrPreconditionQuery é basicamente o mesmo):

@XmlSeeAlso(PreconditionQuery.class)
@XmlRootElement(name = "and")
public class CompoundAndPreconditionQuery extends PreconditionQuery {

    private Collection<PreconditionQuery> preconditionQueries = newArrayList();

    @XmlElementRef(name = "query")
    public Collection<PreconditionQuery> getPreconditionQueries() {
        return preconditionQueries;
    }

    public void setPreconditionQueries(Collection<PreconditionQuery> preconditionQueries) {
        this.preconditionQueries = preconditionQueries;
    }
}

Finalmente, no nível do bean, mapeei assim:

public class Precondition {

    private PreconditionQuery query;

    @XmlElementRef(required = true)
    public PreconditionQuery getQuery() {
        return query;
    }

    public void setQuery(PreconditionQuery query) {
        this.query = query;
    }
}

No final, o JAXB reclama de não conseguir resolver isso:

Caused by: com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException: 1 counts of IllegalAnnotationExceptions
Invalid @XmlElementRef : Type "class xxx.PreconditionQuery" or any of its subclasses are not known to this context.
    this problem is related to the following location:
        at public xxx.PreconditionQuery xxx.Precondition.getQuery()
        at xxx.Precondition

E se@XmlElementRef não faz o trabalho, o que será?