--- title: 'JAXB2-Annotationen an Beispielen' url: 'https://tutego.de/blog/javainsel/2007/12/jaxb2-annotationen-an-beispielen' markdown: 'https://tutego.de/blog/javainsel/2007/12/jaxb2-annotationen-an-beispielen.md' date: '2007-12-06' description: 'Schreiben der Felder statt Nutzen der Setter/Getter: Annotiere die Klasse mit @XmlAccessorType( XmlAccessType.FIELD ) @XmlAttribute class Person { String name; @XmlAttribute int id; } Christian @XmlValue ``` Gibt es nur ein Element kann `@XmlValue` dies in den Rumpf setzten. ```java class Person { int id; } 123 class Person { @XmlValue int id; } 123 @Transient ``` Nimmt Element aus der XML-Abbildung aus. ```java class Person { @XmlTransient int id; String firstname; String lastname; } Christian Ullenboom @XmlList ``` Schreibt Elemente einer Sammlung nicht in einzelnen Elementen, sondern mit Leerzeichen getrennt. ```java class Person { List emails; } muh@kuh.de zick@zack.com class Person { @XmlList List emails; } muh@kuh.de zick@zack.com ``` Elemente einpacken mit `@XmlElementWrapper` ```java class Person { List emails; } muh@kuh.de zick@zack.com class Person { @XmlElementWrapper(name = "emails") @XmlElement(name = "email") List emails; } muh@kuh.de zick@zack.com ``` Reihenfolge ändern ```java class Person { String lastname, firstname; } Ullenboom Christian @XmlType( propOrder = { "firstname", "lastname" } ) class Person { String lastname, firstname; } Christian Ullenboom @XmlJavaTypeAdapter ``` Anpassen der XML-Abbildung, etwa für Datumswerte. ```java class Person { Date birthday; } 1973-03-12T00:00:00+01:00 class Person { @XmlJavaTypeAdapter( DateAdapter.class ) Date birthday; } class DateAdapter extends XmlAdapter { private final static DateFormat formatter = new SimpleDateFormat( "dd/MM/yyyy" ); ``` **public** Date `unmarshal( String date )` **throws** `ParseException` ```java { return formatter.parse( date ); } ``` **public** `String` `marshal( Date date )` ```java { return formatter.format( date ); } } 12/03/1973 ``` Der spezielle Datentyp XMLGregorianCalendar Neben der Möglichkeit, Datumswerte mit einen XmlJavaTypeAdapter zu übersetzen, bietet JAXB den Datentype XMLGregorianCalendar. ```text ``` ```java Person p = new Person(); GregorianCalendar c = new GregorianCalendar( 1973, Calendar.MARCH, 12 ); p.birthday = DatatypeFactory.newInstance().newXMLGregorianCalendar( c );; ``` ```text ``` ```text ``` ```java class Person { XMLGregorianCalendar birthday; } 1973-03-12T00:00:00.000+01:00 ``` ```text ``` Die Abbildung enthält alle notwendigen Werte. Sollen Segmente, wie die Zeitzone herausgenommen werden, so markiert man sie aus: ```text ``` ```java Person p = new Person(); GregorianCalendar c = new GregorianCalendar( 1973, Calendar.MARCH, 12 ); XMLGregorianCalendar gc = DatatypeFactory.newInstance().newXMLGregorianCalendar( c ); gc.setTimezone(DatatypeConstants.FIELD_UNDEFINED); gc.setTime(DatatypeConstants.FIELD_UNDEFINED, DatatypeConstants.FIELD_UNDEFINED, DatatypeConstants.FIELD_UNDEFINED); ``` ```java p.birthday = gc; ``` ```text ``` ```java class Person { XMLGregorianCalendar birthday; } 1973-03-12 ``` Elemente einbetten mit `@XmlElements` ```java Person p = new Person(); EmailContact c1 = new EmailContact(); c1.address = "hoho@weihnachtsmann.de"; PhoneContact c2 = new PhoneContact(); c2.number = "0011-123456789"; p.contacts = Arrays.asList( c1, c2 ); @XmlRootElement @XmlAccessorType( XmlAccessType.FIELD ) class Person { @XmlElements( { @XmlElement( name = "email", type = EmailContact.class ), @XmlElement( name = "phone", type = PhoneContact.class ) ``` } ) ```java List