Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

1 Зачем использовать простой фреймворк Javalin на языке Java для обработки запросов и формирования ответов, и как работает шаблонизация.

2 <blockquote>Статью подготовил Сергей Чепурнов, наставник на Хекслете, Java-разработчик с опытом работы более 7 лет в распределенных командах.<a>Профиль Сергея на GitHub</a>

3 </blockquote><h2>Содержание</h2>

4 <ul><li><a>Как устроены веб-приложения</a></li>

5 <li><a>Как работает маршрутизация в Javalin</a></li>

6 <li><a>Как работают динамически сформированные запросы</a></li>

7 <li><a>Какими бывают запросы: GET, DELETE, POST, PUT</a></li>

8 <li><a>Как работает шаблонизация</a></li>

9 <li><a>Дополнительные материалы</a></li>

10 </ul><h2>Как устроены веб-приложения</h2>

11 Все веб-приложения работают по одному принципу. Во-первых, они состоят из двух частей:

12 <ul><li>Клиент - зачастую это браузер или приложение на устройстве пользователя</li>

13 <li>Сервер - компьютер с серверным ПО, который обрабатывает запросы от клиента.</li>

14 </ul>Во-вторых, в каждом приложении клиент и сервер обмениваются информацией таким образом:

15 <ul><li>Клиент отправляет запрос к серверу</li>

16 <li>Сервер обрабатывает запрос</li>

17 <li>Сервер отправляет сформированный ответ обратно клиенту.</li>

18 </ul>Такая последовательность из трех шагов называется циклом "запрос-обработка-ответ". На схеме она выглядит так:

19 Обработка запросов и формирование ответов - это рутинная задача в каждом веб-приложении.

20 При программировании на языке Java есть два способа работы с циклом "запрос-обработка-ответ":

21 <ol><li>Использование Servlet API- это стандартный пакет классов и интерфейсов, то есть встроенный механизм построения клиент-серверного приложения по схеме "запрос-ответ". Главный минус - придется писать много однотипного кода, создавать множество классов и т. п.</li>

22 <li>Использование фреймворкадля автоматизации повторяющихся задач. Фреймворк - это каркас веб-приложения, определяющий структуру программы. Код веб-приложения в таком случае легче читается, поддерживается и тестируется. Благодаря фреймворкам вы можете сосредоточиться на логике сайта, не отвлекаясь на продумывание базовой архитектуры или кодирование вспомогательных инструментов.</li>

23 </ol>Рассмотрим фреймворк Javalin: он настолько прост, что работающее веб-приложение можно написать буквально в две строчки кода:

24 Конечно, это еще не все. Также для запуска нужна система сборки - она скачает все указанные зависимости, скомпилирует исходный код и запустит приложение.

25 Для примера мы будем использовать систему сборки Gradle. В этом случае запуск приложения выполняется командой run в корне директории проекта:

26 Откроем в браузере страницу с адресомlocalhost

27 и посмотрим, запустилось ли наше двухстрочное приложение.

28 Все прошло успешно:

29 Запрос / и ответ Hello World связаны между собой. Клиент делает запрос по адресуlocalhost

30 . При этом сервер понимает, что к нему обратились с запросом "/", и в качестве ответа возвращает строку Hello World.

31 Чтобы разобраться подробнее, вернемся к двум строкам выше. Посмотрим, что в них написано:

32 Первая строка создает объект типа Javalin и устанавливает номер порта, на котором будет работать приложение (порт 7070 в данном случае). Вторая строка добавляет обработчик для запроса /. Обработчик записывается в виде лямбда-выражения и формирует ответ в виде строки.

33 Клиент получает ответ от сервера в виде http-ответа, в теле которого содержится строка:

34 <h2>Как работает маршрутизация в Javalin</h2>

35 Поступающие запросы нужно маршрутизировать - то есть обработать на сервере. Когда сервер получает запрос от клиента, он начинает маршрутизацию: обрабатывает запрос и определяет, какой ответ нужно отправить клиенту.

36 Как это происходит:

37 <ol><li>Сервер считывает/aboutв конце URL и отличает этот запрос от всех остальных</li>

38 <li>Затем сервер формирует подходящий ответ - отправляет html-страницу "О блоге".</li>

39 </ol>Рассмотрим пример. Создадим веб-приложение в виде блога:<a>https://java-javalin-blog.hexlet.app</a>. Пользователь переходит по ссылкам внутри блога и получает разную информацию. Например, на<a>https://java-javalin-blog.hexlet.app/articles</a>- увидит список всех статей, а на странице<a>https://java-javalin-blog.hexlet.app/about</a>- узнает больше о блоге и авторах.

40 Посмотрим, как маршрутизация работает в приложении:

41 Обратите внимание, что каждому URL соответствует определенный ответ - именно он возвращается в виде html-страницы. Таким образом, пользователь увидит в браузере такую страницу:

42 <h2>Как работают динамически сформированные запросы</h2>

43 До этого мы рассматривали статические адреса такого вида:

44 <ul><li><a>https://java-javalin-blog.hexlet.app/about</a></li>

45 <li><a>https://java-javalin-blog.hexlet.app/articles</a></li>

46 </ul>Кроме статических адресов, в веб-приложениях используются и динамически сформированные адреса. Например:

47 <ul><li><a>https://java-javalin-blog.hexlet.app/articles/1</a></li>

48 <li><a>https://java-javalin-blog.hexlet.app/articles/2</a></li>

49 <li><a>https://java-javalin-blog.hexlet.app/articles/3</a></li>

50 </ul>Такие URL запрашивают статьи по их уникальному идентификатору (id). По id сервер различает запросы и возвращает соответствующую статью в виде html-страницы.

51 Если на сайте есть список статей, то его можно выводить на странице в виде списка названий, а ссылки формировать динамически и с разными идентификаторами. Обычно шаблон ссылки выглядит следующим образом: “/articles/{id}”, где вместо "{id}” программным путем подставляется конкретный идентификатор статьи.

52 Чтобы обрабатывать такие запросы, на сервере создается отдельный класс контроллер, который отвечает за обработку запроса и формирование ответа клиенту.

53 Рассмотрим, как выглядит обработка запроса<a>https://java-javalin-blog.hexlet.app/articles/1</a>в коде приложения.

54 Во-первых, в маршрутизации появляется отсылка к методу контроллера:

55 Эта настройка маршрутизации сообщает о двух важных аспектах:

56 <ol><li>GET-запрос по адресу /articles попадает на обработчик ArticleController.listArticles.</li>

57 <li>GET-запрос по адресу articles/{id} с любым целочисленным параметром id попадает на обработчик ArticleController.showArticle</li>

58 - </ol>Во-вторых, обработчик запроса вида articles/{id} - метод контроллера, который извлекает параметр id из пути запроса, затем извлекает статью из хранили��а с этим идентификатором и возвращает html-страницу с текстом найденной статьи:

58 + </ol>Во-вторых, обработчик запроса вида articles/{id} - метод контроллера, который извлекает параметр id из пути запроса, затем извлекает статью из хранилища с этим идентификатором и возвращает html-страницу с текстом найденной статьи:

59 Извлекать параметры запроса (path param), в данном случае id, можно с помощью фреймворка Javalin:

60 <h2>Какими бывают запросы: GET, DELETE, POST, PUT</h2>

61 Выше мы рассмотрели, как получить список статей и извлечь одну конкретную статью, - для этого используется метод GET HTTP. Но обычно в блоге можно еще и добавлять и удалять статьи - с этими задачами справляются другие методы HTTP.

62 Обычно веб-приложение использует четыре метода:

63 <ol><li>GET - получение данных</li>

64 <li>DELETE - удаление данных</li>

65 <li>POST - создание данных</li>

66 <li>PUT - обновление данных.</li>

67 </ol>Для примера попробуем добавить статью в блог. Для этого используем метод POST HTTP:

68 Теперь у нас есть форма создания статьи:

69 А так выглядит разметка этой формы:

70 Сосредоточимся на отправке данных. Сначала пользователь вводит название и текст статьи, а потом нажимает кнопку "Создать". Так формируется запрос POST HTTP:

71 А теперь посмотрим, как обработчик POST запроса выглядит в коде:

72 Всего одной строчкой кода можно получить доступ к данным формы (form param), которые передаются в теле POST-запроса.

73 Чтобы получить две переменные из запроса, требуется две строчки кода в методе- обработчике:

74 В примерах выше мы рассмотрели:

75 <ul><li>Как извлекать данные из тела POST запроса (form param)</li>

76 <li>Как извлекать идентификатор "id" статьи из пути URL (path param), например “/articles/{id}”.</li>

77 </ul>Перейдем к извлечению переменных запроса (query param) из URL. Для этого рассмотрим пример постраничного вывода статей.

78 В этом случае GET-запрос для запроса 1-ой страницы со статьями выглядит следующим образом:<a>https://java-javalin-blog.hexlet.app/articles?page=1</a>

79 В результате данного запроса в браузере можно наблюдать первую страницу со статьями:

80 Настроить маршрутизацию для такого запроса можно так:

81 В коде обработчика доступ к переменной запроса (query param) в URL происходит также в одну строчку:

82 <h2>Как работает шаблонизация</h2>

83 Представим, что клиент запрашивает страницу с первой статьей<a>https://java-javalin-blog.hexlet.app/articles/1</a>. Тогда сервер получает GET-запрос и присылает в ответ статью в виде html-страницы. Эта страница формируется программным путем с динамическим контентом.

84 Для этого используется шаблонизатор - инструмент, который позволяет упрощать генерацию конечных html-страниц за счет использования шаблонов. Здесь для примера мы используем Thymeleaf.

85 В нашем примере код обработчика будет выглядеть так:

86 Посмотрим еще раз на две последние строки кода. Здесь вызываются методы контекста приложения:

87 Первый метод - .attribute(). Он записывает объект article как атрибут, к которому можно получить доступ в шаблоне.

88 Второй метод - .render(). Он производит рендеринг шаблона - то есть записывает динамический контент в html-странице.

89 Посмотрим на пример шаблона show.html для вывода одной статьи:

90 В этом шаблоне программным путем устанавливаются название статьи и текст самой статьи. Это происходит за счет того, что в шаблоне есть доступ к объекту article, у которого вызываются методы getName() и getDescription().

91 В итоге генерируется такая html-страница:

92 Фреймворк Javalin прост в использовании и при этом помогает автоматизировать рутинные задачи при написании веб-приложения. Он идеально подходит для обучения, потому что позволяет сосредоточиться на логике сайта, а не на продумывании базовой архитектуры или кодировании вспомогательных инструментов.

93 <h2>Дополнительные материалы</h2>

94 <ul><li>Работающая версия блога:<a>https://java-javalin-blog.hexlet.app</a>

95 </li>

96 <li>Исходный код блога:<a>https://github.com/hexlet-components/java-javalin-blog</a>

97 </li>

98 </ul>