Использование SpringMVC + Spring Boot для XML | OTUS
⚡ Подписка на курсы OTUS!
Интенсивная прокачка навыков для IT-специалистов!
Подробнее

Курсы

Программирование
Python Developer. Professional
-3%
Разработчик на Spring Framework
-5%
iOS Developer. Professional
-8%
Golang Developer. Professional
-6%
Базы данных
-12%
Agile Project Manager
-5%
Android Developer. Professional
-11%
Microservice Architecture
-5%
C++ Developer. Professional
-5%
Highload Architect
-6%
JavaScript Developer. Basic
-8%
Backend-разработчик на PHP
-9%
Архитектура и шаблоны проектирования C# Developer. Professional
-9%
Team Lead
-6%
Kotlin Backend Developer
-9%
Разработчик программных роботов (RPA) на базе UiPath и PIX Unity Game Developer. Basic Разработчик голосовых ассистентов и чат-ботов Node.js Developer Интенсив «Оптимизация в Java» Супер - интенсив по паттернам проектирования Супер - интенсив по Kubernetes iOS Developer. Basic Супер-интенсив «СУБД в высоконагруженных системах» Супер-интенсив "Tarantool"
Инфраструктура
DevOps практики и инструменты
-12%
Базы данных
-12%
Network engineer. Basic
-10%
Network engineer
-4%
Инфраструктурная платформа на основе Kubernetes
-6%
Экспресс-курс по управлению миграциями (DBVC)
-10%
Мониторинг и логирование: Zabbix, Prometheus, ELK
-10%
Administrator Linux. Professional
-6%
Разработчик IoT
-13%
Основы Windows Server Cloud Solution Architecture Разработчик голосовых ассистентов и чат-ботов VOIP инженер Супер-практикум по работе с протоколом BGP NoSQL Супер-практикум по использованию и настройке GIT Супер-интенсив «СУБД в высоконагруженных системах» Экспресс-курс «IaC Ansible»
Специализации Курсы в разработке Подготовительные курсы
+7 499 938-92-02

Использование SpringMVC + Spring Boot для XML

Не JSON-ом единым оперируют back-end-ы приложения. В дикой природе встречаются Web-сервисы, которые на работают с XML (да, мы не о SOAP, а именно об XML). SpringMVC прекрасно поддерживает данную возможность, причём разными способами.

JSON c Jackson

По умолчанию spring-boot-starter-web содержит настроенный Jackson для маппинга request/response DTO в JSON.

Раз:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

(включает в себя jackson-databind)

Два:

@RequiredArgsConstructor
@Getter
public class PersonJsonDto {

    @JsonProperty("firstName")
    private final String name;

    private final int age;
}

Три:

@RestController
public class PersonJsonController {

    @GetMapping("/api/json")
    public PersonJsonDto json() {
        return new PersonJsonDto("Ivan", 18);
    }
}

Данный контроллер содержит аннотацию @RestController, которая содержит @ResponseBody, которая в свою очередь говорит Spring MVC преобразовывать объект, используя существующие мапперы. Да, по умолчанию подразумевается application/json, для которого уже есть настроенный Jackson.

Проверяем:

GET http://localhost:8080/api/json

HTTP/1.1 200 
Content-Type: application/json
...

{
  "age": 18,
  "firstName": "Ivan"
}

XML c Jackson

Jackson, на самом деле, не “библиотека для маппинга в JSON”, а полноценный фреймворк для маппинга объектов не только в JSON, но и в XML, YAML и даже в бинарных форматах.

Подобные расширения Jacson называются dataformat.

Подключим соответствующую JAR:

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
</dependency>

В лучших традициях Spring Boot эта библиотека сразу будет настроена spring-boot-starter-mvc.

Напишем соответствующий DTO:

@JacksonXmlRootElement(
    namespace = "http://otus.ru/spring",
    localName = "person"
)
@RequiredArgsConstructor
@Getter
public class PersonXmlDto {

    private final String name;

    private final int age;
}

Да, стоит отметить, что c маппингом XML не всё так просто. Теперь поля объекта могут быть как вложенными тегами, так и атрибутами. И не стоит забывать про namespaces элементов. Пример, представленный здесь, не лишён недостатков, поэтому искушённым читателям предлагается прочитать документацию.

И напишем контроллер:

@RestController
public class PersonXmlController {

    @GetMapping(
        value = "/api/jackson-xml",
        produces = "application/xml"
    )
    public PersonXmlDto jacksonXml() {
        return new PersonXmlDto("Ivan", 18);
    }
}

Обратите внимание на параметр аннотации produces — здесь мы задали application/xml, чтобы сработал именно XML-маппер.

Если мы ничего не напишем, то значение по умолчанию — application/json и будет действовать именно Jackson JSON dataformat, как в предыдущем примере.

Кстати, если мы будем принимать XML на вход с помощью @RequestBody, то нам необходимо будет указать уже consumes.

Проверяем:

GET http://localhost:8080/api/jackson-xml

HTTP/1.1 200 
Content-Type: application/xml
...

<person xmlns="http://otus.ru/spring">
    <name xmlns="">Ivan</name>
    <age xmlns="">18</age>
</person>

JAXB и Spring MVC

Говоря об XML в Java, часто подразумевают именно JAXB. JAXB исключена из стандартной поставки Java 11, поэтому добавим вместо jackson-dataformat-xml зависимость:

<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
</dependency>

DTO выглядит похожим образом:

@XmlRootElement(
    namespace = "http://spring.otus.ru",
    name = "person-jaxb"
)
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
public class PersonJaxbDto {

    private String name;
    private int age;
}

И, как мы уже знаем, необходимо написать соответствующим образом контроллер:

@RestController
public class PersonJaxbController {

    @GetMapping(
        value = "/api/jaxb-xml",
        produces = "application/xml"
    )
    public PersonJaxbDto jacksonXml() {
        return new PersonJaxbDto("Ivan", 18);
    }
}

И, наконец, пробуем!

GET http://localhost:8080/api/jaxb-xml

Content-Type: application/xml
...

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:person-jaxb xmlns:ns2="http://spring.otus.ru">
    <age>18</age>
    <name>Ivan</name>
</ns2:person-jaxb>

Весь код доступен по ссылке. Успехов!

Не пропустите новые полезные статьи!

Спасибо за подписку!

Мы отправили вам письмо для подтверждения вашего email.
С уважением, OTUS!

Автор
0 комментариев
Для комментирования необходимо авторизоваться