Rivalry2

HTML Diff

2 added 2 removed

Original 2026-01-01

Modified 2026-03-10

1 И снова доброго времени суток! Совсем скоро у нас стартует обучение очередной группы <a>"Разработчик на Spring Framework"</a>, в связи с чем мы провели открытый урок, что стало уже традицией в преддверии запуска. На этом вебинаре говорили о разработке REST-клиентов с помощью Spring, а также детально узнали о таких технологиях, как Spring Cache, Spring Retry и Hystrix.

2 Преподаватель: <a>Юрий Дворжецкий</a> - тренер в Luxoft Training Center, ведущий разработчик, кандидат физико-математических наук.

3 - Вебинар посетила совершенно разная аудитория, оценившая свои знания по Spring в пределах 0-6 баллов по 10-бальной шкале, однако, судя по отзывам, открытый урок показался полезным даже опытным пользователям.

3 + Вебинар ��осетила совершенно разная аудитория, оценившая свои знания по Spring в пределах 0-6 баллов по 10-бальной шкале, однако, судя по отзывам, открытый урок показался полезным даже опытным пользователям.

4 Пару слов о Spring 5

5 Как известно, Spring Framework является универсальным и довольно популярным фреймворком для Java-платформы. Spring состоит из массы подпроектов или модулей, что позволяет решать множество задач. По сути, это большая коллекция "фреймворков во фреймворке", вот, например, лишь некоторые из них:

6 <ul><li>Spring IoC + AOP = Context,</li>

7 <li>Spring JDBC,</li>

8 <li>Spring ORM,</li>

9 <li>Spring Data (это целый набор подпроектов),</li>

10 <li>Spring MVC, Spring WebFlux,</li>

11 <li>Spring Security,</li>

12 <li>Spring Cloud (это ещё более огромный набор подпроектов),</li>

13 <li>Spring Batch,</li>

14 <li>Spring Boot.</li>

15 </ul><a></a>Spring заменяет конфигурированием программирование некоторых задач, однако конфигурирование иногда превращается просто в кошмар. Для быстрого создания production-grade приложений как раз и используют Spring Boot. Это специальный фреймворк, который содержит набор стартеров (‘starter’), упрощающих настройку Spring-фреймворков и других технологий.

16 Чтобы показать некоторые особенности работы Spring, прекрасно подходит тема блокировки сайтов, так как это сейчас модно)). Если хотите активно поучаствовать в уроке и попрактиковаться, рекомендуется скачать <a>репозиторий</a> с кодом сервера, который предложил преподаватель. Используем следующую команду:

17 git clone git@github.com:ydvorzhetskiy/sb-server.git

18 Далее просто запускаем, например, так:

19 mvnw spring-boot:run

20 Самым большим достижением Spring Boot является возможность запустить сервер простым запуском Main-класса в IntelliJ IDEA.

21 В файле BlockedSite.java находится наш исходный код:

22 package ru.otus.demoserver.domain;importjavax.persistence.Entity;importjavax.persistence.GeneratedValue;importjavax.persistence.Id; @Entity publicclassBlockedSite{ @Id @GeneratedValue private int id; private String url;А вот содержимое контроллера BlockedSitesController.java:

23 package ru.otus.demoserver.rest; @RestController publicclassBlockedSitesController{ private final Logger logger = LoggerFactory.getLogger(BlockedSitesController.class); private final BlockedSitesRepository repository; publicBlockedSitesController(BlockedSitesRepository repository) { this.repository = repository; } @GetMapping("/blocked-sites") public List<BlockedSite>blockedSites() { logger.info("Request has been performed");returnrepository.findAll(); } }Также обратите внимание на вложенную БД в pom.xml:

24 <?xml version="1.0" encoding="UTF-8"?> <projectxmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.2.RELEASE</version> <relativePath/>  </parent> <groupId>ru.otus</groupId> <artifactId>demo-server</artifactId> <version>0.0.1-SNAPSHOT</version> <url>demo-server</url> <description>Demo project for Spring Boot</description> <properties> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>Теперь простым и незатейливым образом сохраняем в нашу БД через репозиторий два заблокированных сайта (DemoServerApplication.java):

25 package ru.otus.demoserver; @SpringBootApplication publicclassDemoServerApplication{ publicstaticvoidmain(String[] args) { ApplicationContext ctx = SpringApplication.run(DemoServerApplication.class, args); BlockedSitesRepository repository = ctx.getBean(BlockedSitesRepository.class); repository.save(newBlockedSite("https://telegram.org/")); repository.save(newBlockedSite("https://azure.microsoft.com/")); } }Осталось запустить сервер с помощью Spring Boot и открыть соответствующий урл на локальном хосте (localhost:8080/blocked-sites). При этом наш сервер будет нам возвращать список заблокированных нами сайтов, то есть те сайты, которые мы добавили через БД.

26 Что же, пришла пора писать клиента к этому серверу. Но прежде чем к этому перейти, нужно кое-что вспомнить.

27 Теоретическое отступление

28 Давайте перечислим некоторые HTTP-методы (глаголы):

29 <ul><li>GET - получение entity или списка;</li>

30 <li>POST - создание entity;</li>

31 <li>PUT - изменение entity;</li>

32 <li>PATCH - изменение entity (RFC-…);</li>

33 <li>DELETE - удаление entity;</li>

34 <li>HEAD, OPTIONS - "хитрые" методы для поддержки HTTP-протокола и вообще REST-сервисов;</li>

35 <li>TRACE - устаревший метод, который не используется.</li>

36 </ul>Нельзя не вспомнить и про такое важное свойство, как идемпотентность. Говоря простым языком, сколько бы раз вы не применяли операцию, её результат будет один и тот же, как если бы вы применили её всего один раз. Например, вы поздоровались с утра с человеком, сказав ему "Привет!" В результате ваш знакомый переходит в состояние "поздорованный" :-). И если вы ещё несколько раз в течение дня ему скажете "Привет!", ничего не изменится, он останется в том же состоянии.

37 А теперь, давайте подумаем, какие из вышеперечисленных HTTP-методов идемпотентны? Конечно, подразумевается, что вы соблюдаете семантику. Если не знаете, то подробнее об этом рассказывает преподаватель, начиная с 26-й минуты видео.

38 REST

39 Для того чтобы писать REST-контроллер, нужно вспомнить, что такое REST:

40 <ul><li>REST - REpresentational State Transfer;</li>

41 <li>это архитектурный стиль, а не стандарт;</li>

42 <li>это, по сути, набор принципов-ограничений;</li>

43 <li>REST был давно, но термин появился сравнительно недавно;</li>

44 <li>Web-приложение в стиле REST называется RESTful, его API в таком случае - RESTful API (антоним - Stateful);</li>

45 <li>REST-ом сейчас называют всё что хотят…</li>

46 </ul>Во-первых, если говорить о взаимодействии в виде клиент-сервер, то его нужно строить в виде запрос-ответ. Да, не всегда взаимодействие так строится, но сейчас такое взаимодействие крайне распространено, а для веб-приложений что-то другое выглядит совсем странно. А вот, например, веб-сокеты - это как раз не REST.

47 Во-вторых, самое важное ограничение в REST - отсутствие состояния клиента на сервере. Предполагается, что серверу клиент всегда передаёт всё необходимое состояние с каждым запросом, то есть состояние сохраняется на стороне клиента, и нет никаких сессий на сервере.

48 <h3>Как писать клиента на Spring</h3>

49 Для продолжения работы рассмотрим и запустим клиента (используем ссылку на репозиторий):

50 git clone git@github.com:ydvorzhetskiy/sb-client.git mvnw spring-boot:runЭто уже написанный клиент и консольное приложение, а не веб-сервер.

51 Смотрим зависимости:

52 <?xml version="1.0" encoding="UTF-8"?> <projectxmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.2.RELEASE</version> <relativePath/>  </parent> <groupId>ru.otus</groupId> <artifactId>demo-client</artifactId> <version>0.0.1-SNAPSHOT</version> <url>demo-client</url> <description>Demo project for Spring Boot</description> <properties> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency>  <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>5.1.4.RELEASE</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>2.9.8</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-core</artifactId> <version>2.9.8</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.9.8</version> </dependency>  <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-cache</artifactId> </dependency>  <dependency> <groupId>org.springframework.retry</groupId> <artifactId>spring-retry</artifactId> </dependency> <dependency> <groupId>org.aspectj</groupId> <artifactId>aspectjweaver</artifactId> </dependency>  <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-hystrix</artifactId> <version>2.0.2.RELEASE</version> </dependency> <dependency> <groupId>com.netflix.hystrix</groupId> <artifactId>hystrix-javanica</artifactId> <version>1.5.12</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>У клиента есть конфигурация:

53 1. RestTemplateConfig.java

54 package ru.otus.democlient.config; @Configuration publicclassRestTemplateConfig{ @Bean public RestTemplaterestTemplate(RestTemplateBuilder restTemplateBuilder) {returnrestTemplateBuilder .setConnectTimeout(Duration.ofSeconds(2)) .setReadTimeout(Duration.ofSeconds(3)) .build(); }2. CacheConfig.java

55 package ru.otus.democlient.config; @Configuration publicclassCacheConfig{ @Bean public CacheManagercacheManager() {returnnewConcurrentMapCacheManager("sites"); } }А вот содержимое файла SiteServiceRest.java:

56 package ru.otus.democlient.service;importcom.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;importorg.springframework.beans.factory.annotation.Value;importorg.springframework.cache.annotation.Cacheable;importorg.springframework.core.ParameterizedTypeReference;importorg.springframework.http.HttpMethod;importorg.springframework.retry.annotation.Backoff;importorg.springframework.retry.annotation.Retryable;importorg.springframework.stereotype.Service;importorg.springframework.web.client.RestTemplate;importjava.util.Collections;importjava.util.List; @Service publicclassSiteServiceRestimplementsSiteService{ private final RestTemplate restTemplate; private final String serverUrl; publicSiteServiceRest( RestTemplate restTemplate, @Value("${application.server.url}") String serverUrl ) { this.restTemplate = restTemplate; this.serverUrl = serverUrl; } @Override public List<SiteInfo>findAllBlockedSites() {returnrestTemplate.exchange( serverUrl + "/blocked-sites", HttpMethod.GET, null,newParameterizedTypeReference<List<SiteInfo>>() { } ).getBody(); } public List<SiteInfo>getDefaultSites() {returnCollections.singletonList(newSiteInfo() {{ setUrl("http://vk.com/"); }}); } }Слегка подрезюмируем:

57 <ol><li>Запросы делаются через RestTemplate.</li>

58 <li>RestTemplate можно настраивать, и это обычный бин.</li>

59 <li>Jackson используется для маппинга JSON в объекты.</li>

60 <li>Дальше - только ваш полёт фантазии (подробности о запуске клиента есть в видео).</li>

61 - </ol>Коллеги, вебинар получился очень содержательным, поэтому, чтобы ничего не пропустить, лучше смотрите его полностью. Вы попробуете "в боевых условиях" реальное API, добавите @Cacheable на сервис, поработаете со Spring Retry, узнаете о Hystrix и много чего ещё. Такж�� мы приглашаем вас на <a>очередной вебинар</a> по Spring.

61 + </ol>Коллеги, вебинар получился очень содержательным, поэтому, чтобы ничего не пропустить, лучше смотрите его полностью. Вы попробуете "в боевых условиях" реальное API, добавите @Cacheable на сервис, поработаете со Spring Retry, узнаете о Hystrix и много чего ещё. Также мы приглашаем вас на <a>очередной вебинар</a> по Spring.