Vert.x in Action: примеры из книги

👋 Добро пожаловать!

Это рабочие примеры для Vert.x in Action (ISBN 9781617295621) от Manning Publications Co и написанной Julien Ponge.

Как открыть и запустить примеры?

Читатели книги должны напрямую открывать проекты из подпапок: все они независимы.

Вы найдёте дескрипторы сборки Gradle и Maven для каждого проекта, так что вы можете загрузить проекты с помощью текстовых редакторов или интегрированных сред разработки, таких как IntelliJ IDEA, Eclipse IDE или Microsoft Visual Studio Code.

Например, если вы хотите собрать главу 1 с Gradle, откройте терминал и запустите:

$ cd chapter1
$ ./gradlew build

или с Maven запустите:

$ cd chapter1
$ mvn package

Примеры из книги лучше всего работают в некоторой среде Unix: Linux, macOS или Windows Subsystem for Linux от Microsoft.

Какова структура репозитория?

Доступны следующие папки:

• chapter1
• chapter2
• chapter3
• chapter4
• chapter5
• chapter6
• part2-steps-challenge (охватывает главы 7–12)
• chapter13

В ветке master вы найдёте рабочие примеры.

Глава 12 предоставляет варианты одного и того же кода, которые вы можете получить из следующих веток:

• chapter12/public-api-with-timeouts
• chapter12/public-api-with-circuit-breaker
• chapter12/public-api-with-circuit-breaker-and-timeouts

Будут ли обновления?

Книга была выпущена издательством Manning в августе 2020 года.

Этот репозиторий содержит образцы против Eclipse Vert.x 4.0.3 (см. тег vertx-4.0.3), который был выпущен в марте 2021 года.

По своему усмотрению я могу обновиться до более новых версий Vert.x, когда они будут опубликованы.

Обратите внимание, что основная команда Vert.x поставила перед собой цель обеспечить работу Vert.x 4.0.3 со всеми примерами в этом репозитории.

Могу ли я внести свой вклад?

Из-за характера этого проекта я не приму никакого вклада в этот репозиторий.

Что делать, если у меня есть вопрос / проблема?

Если вы являетесь клиентом Manning, то у вас есть доступ к форумам. Пожалуйста, обратитесь к Vert.x in Action на веб-сайте Manning, где предоставлена ссылка на форум.

Если у вас есть вопросы по Vert.x, пожалуйста, свяжитесь с Eclipse Vert.x community. Есть несколько каналов, которые вы можете использовать, включая публичные списки рассылки и чат.

Если у вас возникли проблемы с заказом книги или какой-либо особый запрос, пожалуйста, свяжитесь с Manning.

Исправления

Ноябрь 2020

Из-за особенностей поддержки Docker Compose в TestContainers иногда может потребоваться явное ожидание открытия контейнеров, иначе тестовые выполнения могут иногда завершаться неудачно, потому что порт контейнера ещё не открыт.

Это можно сделать, вызвав метод withExposedService для экземпляра DockerComposeContainer, например:

@Container
private static final DockerComposeContainer CONTAINERS = new DockerComposeContainer(new File("../docker-compose.yml"))
  .withExposedService("mongo_1", 27017);

Это исправление было применено к тестам в part2-steps-challenge.