{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":8,"offset":0,"style":"BOLD"}],"text":"Введение","type":"header-two","key":"clik0"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":11,"offset":42}],"inlineStyleRanges":[],"text":"В работе над своей небольшой библиотечкой jsp-openapi мне понадобилось сериализировать Java объекты в JSON. Я, не долго думая, подключил свою любимую библиотеку gson и пошёл дальше. Проект успешно проходил тест и собирался локально. Следующим моим шагом, как обычно, должна была стать сборка в travis-ci и подключение в sonarcloud.","type":"unstyled","key":"cvo9s"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":12,"offset":10}],"inlineStyleRanges":[],"text":"Но что-то пошло не так…","type":"unstyled","key":"f1693"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вот ключевое место лога:","type":"unstyled","key":"e6eo6"},{"data":{"image":{"id":"5de84109e6e8ef00ae12293e"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8jd18"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":26,"offset":18}],"inlineStyleRanges":[],"text":"Оказывается, gson зависит от пакета java.sql. При сборке jdk9+, библиотека должна создавать файл module-info.java, в котором необходимо описывать эту зависимость.","type":"unstyled","key":"2vgvs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В принципе, это не страшно. Я даже уже начал идти этим путем: создал module-info.java, начал разбираться как собирать проект на openjdk11 и oraclejdk8. Но тут меня осенило. Я же разрабатываю библиотеку тэгов. Для JSP. В 2019 году. Какая вообще Java 11? В лучшем случае её будут использовать в Java 8. И ещё. Библиотека рендеринга html ну совсем не может зависеть от java.sql. Тем более, что я нигде не использую эту зависимость.","type":"unstyled","key":"9f7on"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Немного взгрустнув, я вздохнул и пошёл сложной дорогой: выбор другой JSON библиотеки.","type":"unstyled","key":"8kc8e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"Выбор альтернатив","type":"header-two","key":"cov2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Самое быстрое гугление выдает 3 альтернативы:","type":"unstyled","key":"evfsc"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":9,"offset":25}],"inlineStyleRanges":[],"text":"Reference implementation json-java.","type":"unordered-list-item","key":"43bl1"},{"data":{},"depth":0,"entityRanges":[{"key":4,"length":7,"offset":0}],"inlineStyleRanges":[],"text":"Jackson","type":"unordered-list-item","key":"ap69a"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":6,"offset":0}],"inlineStyleRanges":[],"text":"json-p","type":"unordered-list-item","key":"1j7i9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Но прежде, чем выбирать какую-то одну, необходимо определиться с требованиями:","type":"unstyled","key":"eptnv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"минимальное количество зависимостей, но без фанатизма. Код всё равно будет выполняться на сервере","type":"unordered-list-item","key":"2sn7i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"возможность сериализировать POJO.","type":"unordered-list-item","key":"13s3m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"возможность отбрасывать null поля. Из-за того, что я не контролирую io.swagger.v3.oas.models.OpenAPI, то я не могу вставить в него аннотации и прочие служебные конструкции. Сериализация null полей должна быть сконфигурирована извне","type":"unordered-list-item","key":"2nlsk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"возможность pretty print. Получившийся json будет рендериться с помощью тэгов

, поэтому он должен выглядеть хорошо","type":"unordered-list-item","key":"92gaa"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":0,"style":"BOLD"}],"text":"json-java","type":"header-three","key":"3csb2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Достаточно простой проект, мало кода, а значит быстро и ничего лишнего. Однако, сериализацию объектов через reflection не поддерживает и её придётся писать самому каждый раз. Не подходит.","type":"unstyled","key":"5j5tl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":0,"style":"BOLD"}],"text":"Jackson","type":"header-three","key":"71ccu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Нет, Вы только посмотрите на их readme. Если, с помощью Jackson нельзя собрать космический корабль, то я буду крайне удивлён.","type":"unstyled","key":"ad82g"},{"data":{"image":{"id":"5de8403dfbe6e700b04a756f"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"7f17s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После 15 минут вдумчивого анализа оказалось, что для минимальной работы требуется 3 библиотеки:","type":"unstyled","key":"19dc4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"jackson-core","type":"unordered-list-item","key":"f5u28"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"jackson-annotations","type":"unordered-list-item","key":"eb3kd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"jackson-databind","type":"unordered-list-item","key":"4v79a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Скрипя сердцем, отложил, как формально подходящую под требования.","type":"unstyled","key":"73rbj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"jsonp","type":"header-three","key":"6u6qi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы начать работать с этой библиотекой, нужно добавить следующие зависимости:","type":"unstyled","key":"c1nl8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n    javax.json\n    javax.json-api\n    1.1\n\n\n\n    org.glassfish\n    javax.json\n    1.1\n","type":"blockquote","key":"1ikl3"},{"data":{},"depth":0,"entityRanges":[{"key":6,"length":6,"offset":121}],"inlineStyleRanges":[],"text":"Ох, только не glassfish. Почему выбор библиотеки может зависить от личных предпочтений? Тем не менее, прочитав случайную статью о сравнении сферических коней, решил не брать jsonp по более объективным причинам: низкая производительность.","type":"unstyled","key":"4g3f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"Вывод","type":"header-two","key":"8jnus"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Jackson, конечно, уступает в удобстве работы gson. Но за неимением лучшего пришлось выбрать его:","type":"unstyled","key":"70ia1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"JsonFactory jsonFactory = new JsonFactory();\njsonFactory.configure(JsonGenerator.Feature.AUTO_CLOSE_TARGET, false);\nObjectMapper mapper = new ObjectMapper(jsonFactory);\nmapper.enable(SerializationFeature.INDENT_OUTPUT);\nmapper.setSerializationInclusion(Include.NON_NULL);\nmapper.writeValue(w, value.getProperties());","type":"blockquote","key":"7l5sp"},{"data":{},"depth":0,"entityRanges":[{"key":7,"length":20,"offset":27}],"inlineStyleRanges":[],"text":"На этом я не остановился и выразил свою позицию разработчикам gson. Шансы, что эту задачу реализуют, крайне малы, так как это значит отказываться от обратной совместимости с предыдущими версиями. И на такое разработчики вряд ли пойдут.","type":"unstyled","key":"ckdtp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"3VsiXixhKXVPMldYOh2S"}],"entityMap":{"0":{"data":{"href":"https://github.com/dernasherbrezon/jsp-openapi","url":"https://github.com/dernasherbrezon/jsp-openapi"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"href":"https://travis-ci.org/dernasherbrezon/jsp-openapi/builds/620333411","url":"https://travis-ci.org/dernasherbrezon/jsp-openapi/builds/620333411"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"href":"https://github.com/google/gson/blob/22877d67ba44299e8d77eb841ab20c2087d46752/gson/src/main/java/module-info.java","url":"https://github.com/google/gson/blob/22877d67ba44299e8d77eb841ab20c2087d46752/gson/src/main/java/module-info.java"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"href":"https://github.com/stleary/JSON-java","url":"https://github.com/stleary/JSON-java"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"href":"https://github.com/FasterXML/jackson","url":"https://github.com/FasterXML/jackson"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"href":"https://javaee.github.io/jsonp/","url":"https://javaee.github.io/jsonp/"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"href":"https://blog.overops.com/the-ultimate-json-library-json-simple-vs-gson-vs-jackson-vs-json/","url":"https://blog.overops.com/the-ultimate-json-library-json-simple-vs-gson-vs-jackson-vs-json/"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"href":"https://github.com/google/gson/issues/1629","url":"https://github.com/google/gson/issues/1629"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}