JAXB в Java: преобразование XML в объекты без сложного парсинга

<dependency>
<groupId>javax.xml.bind</groupId>
<artifactId>jaxb-api</artifactId>
<version>2.3.1</version>
</dependency>
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
<version>2.3.1</version>
</dependency>

<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>3.0.1</version>
</dependency>
<dependency>
<groupId>com.sun.xml.bind</groupId>
<artifactId>jaxb-impl</artifactId>
<version>3.0.1</version>
<scope>runtime</scope>
</dependency>

// Для Java 8-10
implementation 'javax.xml.bind:jaxb-api:2.3.1'
implementation 'org.glassfish.jaxb:jaxb-runtime:2.3.1'

// Для Java 11+
implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.1'
implementation 'com.sun.xml.bind:jaxb-impl:3.0.1'

// Создание контекста JAXB
JAXBContext context = JAXBContext.newInstance(Person.class);

// Создание маршализатора
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

// Создание демаршализатора
Unmarshaller unmarshaller = context.createUnmarshaller();

SchemaFactory sf = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
Schema schema = sf.newSchema(new File("person.xsd"));
unmarshaller.setSchema(schema);

<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jaxb2-maven-plugin</artifactId>
<version>2.5.0</version>
<executions>
<execution>
<id>xjc</id>
<goals>
<goal>xjc</goal>
</goals>
</execution>
</executions>
<configuration>
<sources>
<source>${project.basedir}/src/main/resources/schema</source>
</sources>
<outputDirectory>${project.basedir}/src/main/java</outputDirectory>
<clearOutputDir>false</clearOutputDir>
<packageName>com.example.model</packageName>
</configuration>
</plugin>

@XmlRootElement(name = "person")
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder = {"firstName", "lastName", "age", "address"})
public class Person {

@XmlAttribute(name = "id")
private Long id;

@XmlElement(name = "first-name", required = true)
private String firstName;

@XmlElement(name = "last-name")
private String lastName;

@XmlElement
private int age;

@XmlElement
private Address address;

@XmlTransient
private String temporaryField;

// Геттеры и сеттеры
}

@XmlAccessorType(XmlAccessType.FIELD)
public class Address {
@XmlElement
private String street;

@XmlElement
private String city;

@XmlElement(name = "zip-code")
private String zipCode;

// Геттеры и сеттеры
}

@XmlRootElement(name = "department")
public class Department {

@XmlElement(name = "name")
private String name;

@XmlElementWrapper(name = "employees")
@XmlElement(name = "employee")
private List<Person> employees;

// Геттеры и сеттеры
}

<department>
<name>IT Department</name>
<employees>
<employee>...</employee>
<employee>...</employee>
</employees>
</department>

public class DateAdapter extends XmlAdapter<String, Date> {
private SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");

@Override
public Date unmarshal(String v) throws Exception {
return dateFormat.parse(v);
}

@Override
public String marshal(Date v) throws Exception {
return dateFormat.format(v);
}
}

@XmlElement(name = "birth-date")
@XmlJavaTypeAdapter(DateAdapter.class)
private Date birthDate;

// Создаем объекты
Person person = new Person();
person.setId(1L);
person.setFirstName("Иван");
person.setLastName("Петров");
person.setAge(30);

Address address = new Address();
address.setStreet("Ленина");
address.setCity("Москва");
address.setZipCode("123456");
person.setAddress(address);

// Создаем контекст и маршализатор
JAXBContext context = JAXBContext.newInstance(Person.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

// Маршализуем объект в XML-файл
File file = new File("person.xml");
marshaller.marshal(person, file);

// Также можно вывести в консоль
marshaller.marshal(person, System.out);

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<person id="1">
<first-name>Иван</first-name>
<last-name>Петров</last-name>
<age>30</age>
<address>
<street>Ленина</street>
<city>Москва</city>
<zip-code>123456</zip-code>
</address>
</person>

// Создаем контекст и демаршализатор
JAXBContext context = JAXBContext.newInstance(Person.class);
Unmarshaller unmarshaller = context.createUnmarshaller();

// Демаршализуем XML-файл в объект
File file = new File("person.xml");
Person person = (Person) unmarshaller.unmarshal(file);

// Теперь можно использовать полученный объект
System.out.println("Загружен: " + person.getFirstName() + " " 
+ person.getLastName() + ", возраст: " + person.getAge());
System.out.println("Адрес: " + person.getAddress().getCity() + ", " 
+ person.getAddress().getStreet());

// Демаршализация из строки
String xmlString = "<person id=\"1\"><first-name>Иван</first-name>...</person>";
Person person = (Person) unmarshaller.unmarshal(new StringReader(xmlString));

// Демаршализация из потока
InputStream is = new FileInputStream("person.xml");
Person person = (Person) unmarshaller.unmarshal(is);

// Демаршализация из URL
URL url = new URL("http://example.com/data/person.xml");
Person person = (Person) unmarshaller.unmarshal(url);

// Создаем отдел с сотрудниками
Department department = new Department();
department.setName("Разработка");
department.setEmployees(new ArrayList<>());

Person employee1 = new Person();
employee1.setFirstName("Иван");
employee1.setLastName("Иванов");
employee1.setAge(25);

Person employee2 = new Person();
employee2.setFirstName("Петр");
employee2.setLastName("Петров");
employee2.setAge(30);

department.getEmployees().add(employee1);
department.getEmployees().add(employee2);

// Маршализация
JAXBContext context = JAXBContext.newInstance(Department.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
marshaller.marshal(department, System.out);

// Создаем схему из XSD-файла
SchemaFactory sf = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
Schema schema = sf.newSchema(new File("person.xsd"));

// Настраиваем валидацию
JAXBContext context = JAXBContext.newInstance(Person.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
unmarshaller.setSchema(schema);

// Добавляем обработчик ошибок валидации
unmarshaller.setEventHandler(new ValidationEventHandler() {
@Override
public boolean handleEvent(ValidationEvent event) {
System.err.println("Ошибка валидации: " + event.getMessage());
return true; // продолжить после ошибок
}
});

try {
Person person = (Person) unmarshaller.unmarshal(new File("person.xml"));
System.out.println("XML прошел валидацию");
} catch (JAXBException e) {
System.err.println("Ошибка при обработке XML: " + e.getMessage());
}

// Плохо: создание контекста для каждой операции
public void processXML(File file) throws Exception {
JAXBContext context = JAXBContext.newInstance(Person.class);
// ...
}

// Хорошо: повторное использование контекста
private static final JAXBContext context;
static {
try {
context = JAXBContext.newInstance(Person.class);
} catch (JAXBException e) {
throw new RuntimeException(e);
}
}

public void processXML(File file) throws Exception {
// Используем предварительно созданный контекст
}

// Создаем новые экземпляры для каждого потока
public void processXML(File file) throws Exception {
Unmarshaller unmarshaller = context.createUnmarshaller();
// ...
}

XMLInputFactory xif = XMLInputFactory.newFactory();
StreamSource source = new StreamSource(new FileInputStream("huge.xml"));
XMLStreamReader xsr = xif.createXMLStreamReader(source);

// Перемещаемся к нужному элементу
while (xsr.hasNext()) {
if (xsr.getEventType() == XMLStreamConstants.START_ELEMENT 
&& xsr.getLocalName().equals("person")) {
// Демаршализуем только один элемент
Person person = (Person) unmarshaller.unmarshal(xsr);
processOnePerson(person);
}
xsr.next();
}

@XmlRootElement
public class Employee {
private String name;
private Department department;

// ...
}

@XmlRootElement
public class Department {
private String name;

@XmlIDREF // Использовать ссылки вместо вложенных объектов
private List<Employee> employees;

// ...
}

@XmlRootElement(namespace = "http://example.org/person")
@XmlAccessorType(XmlAccessType.FIELD)
public class Person {

@XmlElement(namespace = "http://example.org/person")
private String firstName;

// ...
}

marshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", 
new NamespacePrefixMapper() {
@Override
public String getPreferredPrefix(String namespaceUri, String suggestion, 
boolean requirePrefix) {
if ("http://example.org/person".equals(namespaceUri))
return "p";
return suggestion;
}
});

marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");

public class LocalDateAdapter extends XmlAdapter<String, LocalDate> {

@Override
public LocalDate unmarshal(String v) throws Exception {
return LocalDate.parse(v);
}

@Override
public String marshal(LocalDate v) throws Exception {
return v.toString();
}
}

// Использование адаптера
@XmlElement
@XmlJavaTypeAdapter(LocalDateAdapter.class)
private LocalDate birthDate;

unmarshaller.setAdapter(new XmlAdapter<String, String>() {
@Override
public String unmarshal(String v) throws Exception {
// Выполняем преобразования при чтении
return v;
}

@Override
public String marshal(String v) throws Exception {
// Выполняем преобразования при записи
return v;
}
});

marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

// Включаем отладочную информацию (с Java 9+)
// marshaller.setProperty("jaxb.debug", true);

// Для старых версий
System.setProperty("com.sun.xml.bind.v2.runtime.JAXBContextImpl.debug", "true");