Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-03-10

1 Теги: java, java enterprise, gson, jackson, jsr 353, json api, javax.json, ipaddress, jsonobjectbuilder, jsonarraybuilder, objectbuilder, javaee

2 Сегодня довольно сложно встретить веб-приложение или мобильное приложение, использующее для обмена информацией с бэкендами и сторонними системами формат данных, отличный от JSON.

3 Многие знают, что среди его основных преимуществ отмечаются такие, как простота, отсутствие избыточности при передаче (в сравнении с XML) и как следствие легковесность. На клиентской стороне, написанной на JavaScript или одном из его фреймворков, работа с JSON крайне проста и равносильна работе с обычным JS-объектом.

4 В качестве примера, обратимся к ресурсу<a>Api.ipify.org</a>, возвращающего клиентский IP-адрес в виде JSON-объекта, который присвоим некоторой переменной:

5 let ipAddress = { ip: "46.0.6.174" };Как видно из примера, объект имеет единственное поле "ip", значение которого равно 46.0.6.174. Для получения значения из этого поля JS код выглядит крайне просто:

6 let yourIp = ipAddress.ip;<h2>Представим ситуацию</h2>

7 Предположим, если бы данный сервис в качестве технологического стека использовал бы платформу JavaEE. Для Java-разработчиков, имеющих опыт работы с JSON, хорошо известны такие библиотеки, какGson,Jacksonи прочие, которые отлично подходят для работы с этим форматом данных.

8 Однако поддержка API для работы с JSON в JavaEE из "коробки" зарегистрирована подJSR 353и реализована, начиная с 7й версии. Основным пакетом является javax.json, в котором располагаются все необходимые классы и интерфейсы для работы с JSON.

9 Для описания приведённого выше примера с IP-адресом понадобиться простой классIPAddress:

10 public class IPAddress { private String ip; // getter and setter }Для конвертации объекта данного класса в JSON-строку понадобится создать экземплярJsonObjectBuilderи добавить необходимые поля, используя метод "add":

11 JsonObjectBuilder objectBuilder = Json.createObjectBuilder().add("ip", address.getIp());Обратите внимание, что у метода "add" имеется достаточное количество перегруженных версий, позволяющих передавать значения различных типов в качестве второго значения второго аргумента. Для получения строкового значения на выходе достаточно выполнить:

12 JsonObject jsonObject = objectBuilder.build(); String jsonString = null; try(Writer writer = new StringWriter()) { Json.createWriter(writer).write(jsonObject); jsonString = writer.toString(); }И этого по факту достаточно для получения строки из примера выше!Если же в качестве полей JSON-объекта также используются массивы, то для этого используются возможности классаJsonArrayBuilder, проинициализировав который необходимо передать вobjectBuilderв качестве второго параметра.

13 JsonArrayBuilder arrayBuilder = Json.createArrayBuilder(); for(String ipAddress : person.getIpAddresses()) { arrayBuilder.add(ipAddress); } objectBuilder.add("ips", arrayBuilder);<h2>Для полноты картины, также рассмотрим случай</h2>

14 Ситуация: парсинг JSON-строки выполняется средствами JavaEE, при этом на выходе получив Java-объект. Здесь также никаких сложностей нет:

15 JsonReader reader = Json.createReader(new StringReader(jsonString)); JsonObject jsonObject = reader.readObject(); IPAddress address = new IPAddress(); address.setIp(jsonObject.getString("ip"));Для получения значения полей, представленных в виде массивов, используется:

16 JsonArray addressesJson = jsonObject.getJsonArray("ips"); List<String> ipAddresses = new ArrayList<>(); for (JsonString j : addressesJson.getValuesAs(JsonString.class)) { ipAddresses.add(j.getString()); }В принципе, этих знаний достаточно, чтобы начать использовать встроенные механизмы JavaEE для генерации и обработки JSON в ваших приложениях без необходимости использования сторонних библиотек.

17 Есть вопрос? Напишите в комментариях!