JAXB: N'est-il pas possible d'utiliser un XmlAdapter sans @XmlJavaTypeAdapter?

C'est une très bonne question !

La réponse courte est que pasà l'aide de setAdapter sur marshaller /unmarshaller ne signifie pas que vous n'avez pas à utiliser @XmlJavaTypeAdapter.

Laissez-moi vous expliquer ce avec un hypothétique (encore valide!) scénario.

Prendre en considération dans une application web, un extrait d'un événement dans la forme de xml avoir schéma suivant:

<xs:element name="event" >
    <xs:complexType>
        <xs:sequence>
           <!-- Avoiding other elements for concentrating on our adapter -->
            <xs:element name="performedBy" type="xs:string" />   
        </xs:sequence> 
    </xs:complexType>  
</xs:element>

Équivalent à cela, votre modèle ressemblera:

@XmlRootElement(name="event")
@XmlType(name="")
public class Event {

     @XmlElement(required=true)
     protected String performedBy;
}

Maintenant l'application est d'ores et déjà un bean a appelé User qui maintient le détail
des informations sur l'utilisateur.

public class User {

    private String id;
    private String firstName;
    private String lastName;

    ..
}

Noter que cette User n'est pas connu pour votre JAXB Contexte.
Pour des raisons de simplicité, nous avons Utilisateur POJO, mais il peut être Valable, toute Classe Java.

De l'application de l'architecte voulez est Event's performedBy devrait être représenté comme User
pour gagner plus de détails.

Ici @XmlJavaTypeAdapter entre en image

JAXBContext est conscient performedBy comme xs:string , mais il doit être représenté comme
User dans la mémoire en Java.

Modèle modifié ressemble:

@XmlRootElement(name="event")
@XmlType(name="")
public class Event {

     @XmlElement(required=true)
     @XmlJavaTypeAdapter(UserAdapter.class) 
     protected User performedBy;
}

UserAdapter.java:

public class UserAdapter extends XmlAdapter<String, User> {

     public String marshal(User boundType) throws   Exception {
             ..   
     } 

     public User unmarshal(String valueType) throws Exception {
             ..
     } 
}

La Carte de la définition dit que -

1. BoundType est l'Utilisateur (En Mémoire de la représentation)
2. ValueType est une Chaîne (Le type de données JAXB Contexte est conscient de)

À venir pour revenir à votre question -

Je trouve cela un peu redondant.

BTW, someMarshaller.setAdapter(...) ne semblent pas faire n'importe quoi.

Considérer que notre Carte requiert une classe appelée UserContext afin de maréchal /unmarshal avec succès.

public class UserAdapter extends XmlAdapter<String, User> {

     private UserContext userContext;

     public String marshal(User boundType) throws   Exception {
          return boundType.getId();
     } 

     public User unmarshal(String valueType) throws Exception {
          return userContext.findUserById(valueType);
     } 
}

Maintenant, la question est de savoir comment les UserAdapter va chercher un instace de UserContext ??
Comme un bon design doit toujours d'approvisionnement, alors qu'il a instancié ..

public class UserAdapter extends XmlAdapter<String, User> {

     private UserContext userContext;

     public UserAdapter(UserContext userContext) {
        this.userContext = userContext;  
     } 

     public String marshal(User boundType) throws   Exception {
          return boundType.getId();
     } 

     public User unmarshal(String valueType) throws Exception {
          return userContext.findUserById(valueType);
     } 
}

Mais JAXB d'Exécution ne peut accepter que l'Adaptateur Sans-args constructeur ..
(Évidemment JAXBContext ne savent pas à propos de l'application specific model)

Donc, heureusement, il y a une option 😀

Vous pouvez dire à votre unmarshaller à utiliser instance donnée de UserAdapter plutôt que de l'activation par ses propres.

public class Test {

public static void main(String... args) { 
    JAXBContext context = JAXBContext.getInstance(Event.class);
    Unmarshaller unmarshaller = context.createUnmarshaller();

      UserContext userContext = null; //fetch it from some where
      unmarshaller.setAdapter(UserAdapter.class, new UserAdapter(userContext));

      Event event = (Event) unmarshaller.unmarshal(..);
   }
}

setAdapter la méthode est disponible sur les deux Marshaller & Unmarshaller

Remarque:

1. setAdapter sur marshaller /unmarshaller ne signifie pas que vous n'avez pas à utiliser @XmlJavaTypeAdapter.

   @XmlRootElement(name="event")
   @XmlType(name="")
   public class Event {
   
       @XmlElement(required=true)
       //@XmlJavaTypeAdapter(UserAdapter.class) 
       protected User performedBy;
   }

   Si vous omettez ce JAXB d'exécution n'a pas d'indice que l'Utilisateur est votre tenue Type & Type de Valeur, c'est autre chose. Il va essayer de maréchal User comme & u va finir par avoir mal xml
   (ou d'échec de validation si activé)

2. Bien que nous ayons pris un scénario où la Carte est nécessaire pour être avec des arguments, donc
   utilisation setAdapter méthode.

   Certains avancée usages sont aussi là, où, même si vous avez par défaut no-arg constructeur, mais vous fournir une instance de l'Adaptateur

   Peut-cet adaptateur est configuré avec des données, qui maréchal /unmarshal opération à l'aide !