quarkus basics

docs/hello-new-world.md

@@ -8,7 +8,7 @@
 
 #### Системы сборки
 
-Современные приложения редко состоят из парочки классов которые запускаются из среды разработки. Работа с зависимостями твоего проекта, его сборка/упаковка, всё это ответственность систем сборки. Они берут на себя нудную и иногда тяжелую работу, чтобы твой проект на развалился под грузом [JAR hell](https://dzone.com/articles/what-is-jar-hell). На 2022 год, в Java есть две наиболее популярных системы сборки:
+Современные приложения редко состоят из парочки классов которые запускаются из среды разработки. Работа с зависимостями твоего проекта, его сборка/упаковка, всё это ответственность систем сборки. Они берут на себя нудную и иногда тяжелую работу, чтобы твой проект на развалился под грузом [JAR hell](https://dzone.com/articles/what-is-jar-hell). На данный момент, для Java есть две наиболее популярных системы сборки:
 
 1. [Gradle](https://gradle.org/). Модно, молодежно, инкрементальная компиляция, описание билд-файла на Groovy или Kotlin DSL. Быстрый старт [здесь](https://docs.gradle.org/current/samples/sample_building_java_applications.html).
 2. [Maven](https://maven.apache.org/). Почти нестареющая классика. Описание билда файла на XML, есть множество плагинов на любой вкус, расширяющих стандартную функциональность. Быстрый старт [здесь](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html).

docs/quarkus.md

@@ -0,0 +1,116 @@
+### Почему Quarkus ?
+
+[Quarkus](https://quarkus.io/) - фреймворк от [RedHat](https://ru.wikipedia.org/wiki/Red_Hat), взгляд на экосистему которого заставляет рассмотреть его в качестве альтернативы таким фреймворкам как Helidon (Oracle), Spring Boot (VMware), Micronaut.
+В отличии от остальных фреймворков, перечисленных выше, Quarkus не пошел по пути создания чего-то абсолютно уникального. 
+Вместо этого, он предлагает использовать уже давно существующую в рамках мира backend web-разработки реализацию спецификации [Jakarta REST (ранее известная как JAX-RS)](https://jakarta.ee/specifications/restful-ws/3.1/jakarta-restful-ws-spec-3.1.html), известной как [Resteasy](https://resteasy.dev/).
+ В сущности, это означает, что разработчикам не пришлось особенно много усилий прилагать, чтобы уйти от устаревшего формата разработки.
+Конечно же, это можно было сделать и с помощью Spring Boot, но количество усилий несоизмеримо.
+Типовой микросервис можно перенести c сервлетного JAX-RS на Quarkus даже за 5 минут (конечно же, это средняя температура по больнице).
+
+#### Quarkus реактивный, даже не сомневайся
+
+Изначально, как было выше сказано, Quarkus использовал популярную реализацию Jakarta REST. Однако команда разработчиков пошла дальше. Вместе с разработчиками Resteasy был разработан [Resteasy Reactive](https://quarkus.io/guides/resteasy-reactive).
+В нем Quarkus использует [Vert.x](https://vertx.io/) - набор библиотек для реализации [реактивных](https://www.reactivemanifesto.org/) приложений. При этом, поддержка всех механизмов и аннотаций спецификации Jakarta REST сохранилась.
+Думаю, лучше всего реактивность Quarkus описывают слова из статьи [Quarkus Reactive Architecture](https://quarkus.io/guides/quarkus-reactive-architecture):
+
+!!! note "Quarkus is reactive"
+
+    Quarkus is reactive. It’s even more than this: Quarkus unifies reactive and imperative programming. You don’t even have to choose: you can implement reactive components and imperative components then combine them inside the very same application. No need to use different stacks, tooling or APIs; Quarkus bridges both worlds.
+
+Для более четкого представления о том, что здесь написано, было бы здорово прочитать [Quarkus Reactive Architecture](https://quarkus.io/guides/quarkus-reactive-architecture), затем [Using Eclipse Vert.x API from a Quarkus Application](https://quarkus.io/guides/vertx#executing-asynchronous-code-from-a-blocking-thread), и, для более глубокого погружения [Vert.x Reference Guide](https://quarkus.io/guides/vertx-reference).
+
+
+#### Экосистема
+##### Документация
+
+При изучении таких фреймворков как Spring и Quarkus в первую очередь встает вопрос о документации и ее качестве.
+В случае Quarkus она не должна оставить изучающего равнодушным. Стоит просто зайти на [страницу](https://quarkus.io/guides/) и наслаждаться. 
+Там ты найдешь как короткие вводные статьи для новичков о том, как использовать тот или иной фреймворк в рамках Quarkus, так и концепты внутреннего устройства проекта.
+Наконец, там присутствуют справочные(Reference Guide) статьи для продолжающих разработчиков.
+
+#### Утилиты
+
+Spring имеет такую замечательную утилиту [Spring Initializr](https://start.spring.io/) для генерации и первичной настройки проекта. 
+В свою очередь, Quarkus предоставляет Web-страницу со схожим функционалом [code.quarkus.io](https://code.quarkus.io/).
+Там ты сможешь выбрать: язык разработки, систему сборки, и, также все необходимые для разработки зависимости.
+ В итоге ты получаешь готовый проект, осталось лишь внедрить свою бизнес-логику.
+Также, Quarkus тесно интегрируется с самыми популярными [IDE](https://quarkus.io/guides/ide-tooling), системами сборки [Gradle](https://quarkus.io/guides/gradle-tooling)/[Maven](https://quarkus.io/guides/maven-tooling). Наконец, стоит отметить наличие прекрасного и самодостаточного [CLI](https://quarkus.io/guides/cli-tooling).
+
+
+##### Поддержка технологий
+Quarkus старается поддерживать множество популярных технологий. 
+Для сериализации [используется](https://quarkus.io/guides/rest-json) [Jackson](https://github.com/FasterXML/jackson). 
+Для логирования поддерживаются следующие API:
+
+  * [JBoss Logging](https://github.com/jboss-logging/jboss-logging)
+  * JDK java.util.logging (JUL)
+  * [SLF4J](https://www.slf4j.org/)
+  * [Apache Commons Logging](https://commons.apache.org/proper/commons-logging/)
+  * [Apache Log4j 2](https://logging.apache.org/log4j/2.x/)
+  * [Apache Log4j 1](https://logging.apache.org/log4j/1.2/)
+
+Не могу не упомянуть про способ логирования, которого мне не достает в любом другом фреймворке:
+
+```java title="Упрощенное логгирование"
+package com.example;
+
+import io.quarkus.logging.Log; 
+
+class MyService { 
+    public void doSomething() {
+        Log.info("Simple!"); 
+    }
+}
+```
+
+Подробнее о том, как работает такой способ читай [тут](https://quarkus.io/guides/logging).
+
+Для подключения к БД адаптированы привычные JDBC драйверы к множеству СУБД, но также предлагается и вариант подключения с помощью [реактивных клиентов](https://quarkus.io/guides/reactive-sql-clients). 
+Подробнее можно почитать [здесь](https://quarkus.io/guides/datasource).
+Если, вдруг, ты соскучился по Hibernate, то [вот](https://quarkus.io/guides/hibernate-orm) и [вот](https://quarkus.io/guides/hibernate-orm-panache). ПоДучи и распишись.
+
+Выше освещены наиболее важные технологии, которые ты так или иначе встретишь на месте работы. Но, конечно же Quarkus поддерживает множество других. Вряд ли ты обнаружишь, что не хватает чего-то важного (или не очень). 
+Достигается это не только за счет поддержки Core-команды от RedHat, но и существования Quarkiverse.
+
+
+##### Quarkiverse
+
+[Quarkiverse Github](http://github.com/quarkiverse) - это место в Github, куда любой разработчик/группа разработчиков может выложить расширение для Quarkus.
+Расширения Quarkus, размещенные в организации Quarkiverse, могут быть легко включены в каталог расширений Quarkus, доступный на code.quarkus.io, и в инструменты командной строки Quarkus (такие как mvn quarkus:list-extensions, gradle listExtensions). Но это не только лишь набор репозиториев. Множество расширений пишется по определенному [набору правил](https://hub.quarkiverse.io/) и имеют собственную [документацию](https://docs.quarkiverse.io/index/explore/index.html). Актуальный список расширений ты найдешь [тут](https://quarkus.io/extensions/). Перед использованием расширений можно прочитать [краткое руководство](https://quarkus.io/faq).
+
+
+##### Сообщество
+Команда разработчиков Quarkus глубоко заинтересована и открыта к решению проблем. При желании можно задать любой вопрос в [чате](https://quarkusio.zulipchat.com/), в котором сидят разработчики Quarkus и с охотой отвечают на любые вопросы, в том числе вопросы совсем новичков.
+Также, ты там встретишь множество реальных пользователей Quarkus, в том числе таких же новичков как ты, некоторые из которых также смогут помочь в решении той или иной проблемы. 
+
+
+##### Developer Joy
+Отдельно хотелось бы отметить тот факт, что команда разработчиков Quarkus делает акцент на комфорте разработки, используя Quarkus:
+
+!!! note "Beyond simply working, we’re aiming for Joy."
+
+    Quarkus is not just about being great for writing Web Applications or Micro-Services. 
+    We’re focusing on more than the feature set: we make sure that every feature works well, simply, with little to no configuration, in the most intuitive way possible.
+    It should be trivial to develop simple things, and easy to develop the more complex ones.
+
+Прочитай [это](https://quarkus.io/developer-joy/), надеюсь тебе понравится.
+
+#### Блоги, Книги, Подкасты
+
+Сообщество Quarkus старается так или иначе популяризировать свой продукт. На главной странице [сайта](https://quarkus.io/) можно найти все необходимые ресурсы для слежения за развитием проекта. [Блог](https://quarkus.io/blog/), [Подкасты](https://quarkus.io/insights/), [Книги](https://quarkus.io/books/) и многое другое.
+
+
+#### How-to старт
+Для того, чтобы начать писать код, достаточно зайти на страницу [Get Started](https://quarkus.io/get-started/) и следовать инструкциям.
+Здесь тебя научат как написать и запустить простейший микросервис, используя Quarkus. Обязательно обрати внимание на раздел `Next Steps`, там будут ссылки на статьи,
+которые подробнее расскажут как писать [REST сервисы](https://quarkus.io/guides/rest-json), в том числе [реактивно](https://quarkus.io/guides/getting-started-reactive). 
+Также, покажут как упростить разработку в твоей любимой [IDE](https://quarkus.io/guides/ide-tooling) и многое другое.
+
+#### Истории миграций
+В блоге Quarkus можно найти [истории миграции на Quarkus](https://quarkus.io/blog/tag/user-story/). Почитай как-нибудь на досуге.
+
+
+<figure markdown>
+  ![developerjoy](images/icon-developerjoy.svg){ width="300" }
+  <figcaption>Приятного путешествия :)</figcaption>
+</figure>

mkdocs.yml

@@ -42,14 +42,22 @@ theme:
     - toc.follow
 
 markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
   - admonition
   - pymdownx.details
-  - pymdownx.superfences
   - attr_list
   - pymdownx.emoji:
       emoji_index: !!python/name:materialx.emoji.twemoji
       emoji_generator: !!python/name:materialx.emoji.to_svg
   - def_list
+  - pymdownx.tasklist:
+      custom_checkbox: true
   - footnotes
   - md_in_html
   - toc:
@@ -89,6 +97,7 @@ nav:
   - Вступаем во взрослый мир: 
     - Вступаем во взрослый мир: hello-new-world.md
     - Spring Framework: spring-framework.md
+    - Quarkus: quarkus.md
     - CI/CD: cicd.md
     - Контейнеризация: containers.md
   - Что дальше ?: eventually.md