Spring boot/cloud workshop at jpoint 2018

Spring {Boot,Cloud}
Workshop

View Slide

Тренинг с конференции Joker 2017

View Slide

https://goo.gl/xRL4wU
https://t.me/joker2017st

View Slide

Часть 1
Основы микросервисописания

View Slide

Как будет проходить тренинг?
Теория – мы рассказываем вы слушаете

View Slide

Как будет проходить тренинг?
Практика

View Slide

The project structure

View Slide

web.xml

org.springframework.web.context.ContextLoaderListener

springSecurityFilterChain
org.springframework.web.filter.DelegatingFilterProxy

springSecurityFilterChain
/*

mvc-dispatcher
org.springframework.web.servlet.DispatcherServlet
1

mvc-dispatcher
/

View Slide

View Slide

…

contextClass param-name>
…AnnotationConfigWebApplicationContext param-value>

contextConfigLocation param-name>
com.inwhite.conf.AppConfig param-value>

…

View Slide

Deployment
→Use maven/gradle to build a war from that project
→Copy it to webapps directory of tomcat

View Slide

create Spring
ContextLoaderListener
start applicationContext
Create filter
mapping
Create
security filter
login
Create spring
dispatcher
servlet
Delegate to
Controller

View Slide

Теперь давайте замочим XML

View Slide

Жизнь без web.xml
false
Java Servlet Specification 3.+
Tomcat 7+

View Slide

Что будем имплементировать
вместо web.xml?

View Slide

WebApplicationInitializer

View Slide

ServletContainerInitializer

View Slide


View Slide

§ 8.2.4 Shared libraries / runtimes pluggability
The ServletContainerInitializer class is looked up via
the jar services API. For each application, an instance
of the ServletContainerInitializer is created by the
container at application startup time. The framework
providing an implementation of the
ServletContainerInitializer MUST bundle in the
META-INF/services directory of the jar file a file
called javax.servlet.ServletContainerInitializer, as per
the jar services API, that points to the implementation
class of the ServletContainerInitializer.
3.+

View Slide

Как? SPI
tomcat
|→ get javax.servlet.ServletContainerInitializer impl via SPI

View Slide

§ 8.2.4 Shared libraries / runtimes pluggability
The ServletContainerInitializer’s onStartup method get's
a Set of Classes that either extend / implement the
classes that the initializer expressed interest in or if
it is annotated with any of the classes specified via
the @HandlesTypes annotation.
3.+

View Slide

Как? SPI
tomcat
|→ get all MyInitializer classes (from @HandlesTypes)

View Slide

Как? SPI
tomcat
|→ get all WebApplicationInitializer classes (from @HandlesTypes)
org.springframework.web.WebApplicationInitializer

View Slide

Как? SPI
tomcat
|→ get all WebApplicationInitializer classes (from @HandlesTypes)
|→ call
ServletContainerInitializer.onStartup(classes,servletCtx)
according to @Order order

View Slide

SPI
org.springframework.web.SpringServletContainerInitializer
content

View Slide

§ Class ServiceLoader
loader =
ServiceLoader.load(ServletContainerInitializer.class)
6.+

View Slide

§ Class ServiceLoader
loader =ServiceLoader.load(ServletContainerInitializer.class)
6.+
Все имплементации ServletContainerInitializer

View Slide

@HandlesTypes(WebApplicationInitializer.class)
public class SpringServletContainerInitializer implements
ServletContainerInitializer {
...

View Slide


View Slide

@Override
public void onStartup(Set>
webAppInitializerClasses, ServletContext servletContext)

View Slide

@Override
...
AnnotationAwareOrderComparator.sort(initializers);
...

View Slide

@Override
...
AnnotationAwareOrderComparator.sort(initializers);
...
initializers.forEach(initializer -> initializer.onStartup(ctx));
}

View Slide

Дружок, дай ка мне
tomcat 7
Spring
Jar

View Slide

Spring
ServletContainer
Initializer
tomcat 7
Spring
Jar

View Slide

public class SpringServletContainerInitializer
implements ServletContainerInitializer

View Slide

W
AI
WAI
tomcat 7
JARS

View Slide

W
AI
WAI
SpringServletContainerInitializer
tomcat 7

View Slide

public class WebStarter implements WebApplicationInitializer {
@Override
public void onStartup(ServletContext servletContext) throws
ServletException {
AnnotationConfigWebApplicationContext webContext = new
AnnotationConfigWebApplicationContext();
webContext.register(WebConfig.class);
ServletRegistration.Dynamic servlet =
servletContext.addServlet("dispatcher", new
DispatcherServlet(webContext));
servlet.setLoadOnStartup(1);
AnnotationConfigWebApplicationContext appContext = new
appContext.register(AppConfig.class);
servletContext.addListener(new ContextLoaderListener(appContext));
servlet.addMapping("/*");
}

View Slide

А попроще нельзя?

View Slide

Можно, но со Spring Boot`ом – Демо

View Slide

Как выглядит наш pom.xml

org.springframework.boot
spring-boot-starter-parent
1.5.3.RELEASE

View Slide

spring-boot-starter-parent
1.5.3.RELEASE

spring-boot-dependencies
1.5.3.RELEASE

View Slide

View Slide

В чём проблема получить
dependency management таким путём?

View Slide

Это чужой parent!

View Slide

View Slide

io.spring.platform
platform-bom
Brussels-SR2
pom
import

View Slide

Как выглядит наш build.gradle
plugins {
id "org.springframework.boot" version "1.5.3.RELEASE"
}
Пакует
приложение

View Slide

plugins {
}
dependencies {
compile 'org.springframework.boot:spring-boot-starter-web'
}
Добавляем
зависимости

View Slide

plugins {
}
dependencies {
}
Automatic
Dependency
Management

View Slide

plugins {
}
dependencies {
}
dependencyManagement {
imports {
mavenBom 'org.springframework.cloud:spring-cloud-dependencies:Dalston.RELEASE'
}
}

View Slide

А я не понял

View Slide

Web Starter ТАЩИТ!

View Slide

Кто всё пакует

spring-boot-maven-plugin

View Slide

Jar как Jar, но если зайти внутрь...

View Slide

View Slide

Перед запуском main – сформируй classpath

View Slide

JarLauncher

View Slide

myapp.jar
|- META-INF
|- BOOT-INF
|- libs
|- classes
|- org
|- springframework
|- boot
MANIFEST.MF
...
Spring-Boot-Version: 1.5.3.RELEASE
Implementation-Vendor: Pivotal Software, Inc.
Main-Class:
org.springframework.boot.loader.JarLauncher
Start-Class:ru….ripper.OurMainClass
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/
...

View Slide

А кто прописывает манифест этому джару?

View Slide

conference...OurMainClass

MANIFEST.MF
...
Start-Class: conference.spring.boot.ripper.OurMainClass
...

View Slide

Как выбирается mainClass если его не указать
Spring boot plugin сканирует проект – ищет мейны
● если есть только один – то это он :)
● если больше одного – смотрит где стоит
@SpringBootApplication и выбирает его
● если @SpringBootApplication нет или >1 – ошибка о
множественных main при сборке

View Slide

Жмя и Работает
executable jar для бабушки
java -jar слишком сложно

View Slide

Хочу executable jar: Maven


true

springBoot {
executable = true
}
Gradle

View Slide

Demo. Executable jar

View Slide

Внутренний мир executable Jar
● Бабушка хочет чтобы жмя и работало
● windows “click click”
● $ ./app.jar
● ...

View Slide

Demo. jar structure

View Slide

Как выглядит Jar?
Script
0xf4ra -> а это ZIP!
jar archive

View Slide

Script
jar archive
Начало файла

View Slide

Script
jar archive
Начало файла
Начало zip архива

View Slide

Где контекс?
@SpringBootApplilcation
class App {
public static void main(String[] args) {
SpringApplication.run(App.class,args);
}
}

View Slide

Вот контекст!
@SpringBootApplilcation
class App {
ApplicationContext context =
SpringApplication.run(App.class,args);
}
}

View Slide

Разрешите представиться

View Slide

Давайте поговорим о контексте
Малыш знает про
ClassPathXmlApplicationContext
А какие контексты знаешь ТЫ?

View Slide

Типы ConfigurableApplicationContext

View Slide

Это я решаю какой контекст создать
Я до создания
контекста ещё много
всего делаю, но об
этом потом.
SpringApplication

View Slide

Web Context Generic Context

View Slide

Если в classpath есть
Servlet.class...

View Slide


View Slide

Если в classpath есть
Servlet.class...

View Slide

Если есть
javax.servlet.Servlet ConfigurableWebApplicationContext
+
AnnotationConfigEmbedded WebApplicationContext
AnnotationConfig ApplicationContext
Иначе

View Slide

И что там в контексте то?

View Slide

Откуда 436 spring beans?

View Slide

Откуда взялись все
эти бины?

View Slide

Что за spring.factories ?
§ 44.1 Understanding auto-configured beans
Under the hood, auto-configuration is implemented with standard @Configuration classes. Additional @Conditional annotations
are used to constrain when the auto-configuration should apply. Usually auto-configuration classes use @ConditionalOnClass and
@ConditionalOnMissingBean annotations. This ensures that auto-configuration only applies when relevant classes are found and
when you have not declared your own @Configuration.
You can browse the source code of spring-boot-autoconfigure to see the @Configuration classes that we provide (see
theMETA-INF/spring.factories file).

View Slide

Даёшь инверсию контроля для стартеров

View Slide

@SpringBootApplication
Всему голова

View Slide


View Slide

→ @ComponentScan
→ @Configuration
→ @EnableAutoConfiguration

View Slide

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
@Filter(type = FilterType.CUSTOM, classes =
AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
…

View Slide

@Target({ElementType.TYPE})
@Documented
@Inherited
@AutoConfigurationPackage
@Import({EnableAutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
Class>[] exclude() default {};
String[] excludeName() default {};
}

View Slide

@Target({ElementType.TYPE})
@Documented
@Inherited
@AutoConfigurationPackage
@Import({EnableAutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
Class>[] exclude() default {};
String[] excludeName() default {};
}
ImportSelector

View Slide

ImportSelector
Web Starter Boot Starter
…
Starter
Mongo Starter

View Slide

Spring Factories Loader
Jar/Starter
spring.factories
SpringFactoriesLoader

View Slide

SpringFactoriesLoader
static List loadFactories(
Class factoryClass,
ClassLoader cl
)
static List loadFactoryNames(
Class> factoryClass,
ClassLoader cl
)

View Slide

Даёшь инверсию контроля для стартеров

View Slide

spring-boot-autoconfigure.jar/spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,\
org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\
org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration
….

View Slide

spring-boot-autoconfigure.jar
@Import(CacheConfigurationImportSelector.class)
public class CacheAutoConfiguration {

View Slide

CacheConfigurations
private static final Map> MAPPINGS;
static {
Map> mappings = new HashMap>();
mappings.put(CacheType.GENERIC, GenericCacheConfiguration.class);
mappings.put(CacheType.EHCACHE, EhCacheCacheConfiguration.class);
mappings.put(CacheType.HAZELCAST, HazelcastCacheConfiguration.class);
mappings.put(CacheType.INFINISPAN, InfinispanCacheConfiguration.class);
mappings.put(CacheType.JCACHE, JCacheCacheConfiguration.class);
mappings.put(CacheType.COUCHBASE, CouchbaseCacheConfiguration.class);
mappings.put(CacheType.REDIS, RedisCacheConfiguration.class);
mappings.put(CacheType.CAFFEINE, CaffeineCacheConfiguration.class);
addGuavaMapping(mappings);
mappings.put(CacheType.SIMPLE, SimpleCacheConfiguration.class);
mappings.put(CacheType.NONE, NoOpCacheConfiguration.class);
MAPPINGS = Collections.unmodifiableMap(mappings);
}

View Slide

Где то внутри CacheAutoConfiguration
for (int i = 0; i < types.length; i++) {
Imports[i] = CacheConfigurations.getConfigurationClass(types[i]);
}
return imports;

View Slide

Захардкодили

View Slide

И что, они всегда грузятся?

View Slide

Спокойствие, есть @Conditional
Они фильтруются

View Slide

Почему бин то есть то нет?
Какие условия?

View Slide

@ConditionalOn***

View Slide

Conditional и друзья
@ConditionalOnBean
@ConditionalOnClass
@ConditionalOnCloudPlatform
@ConditionalOnExpression
@ConditionalOnJava
@ConditionalOnJndi
@ConditionalOnMissingBean
@ConditionalOnMissingClass
@ConditionalOnNotWebApplication
@ConditionalOnProperty
@ConditionalOnResource
@ConditionalOnSingleCandidate
@ConditionalOnWebApplication
...

View Slide

Паззлер
@Configuration
@ConditionalOnWinterIsHere
public class UndeadArmyConfiguration {
@Bean
public WinterUndeadArmy cursedArmy() {
return new WinterUndeadArmy();
}
@Bean
@ConditionalOnWinterIsHere
public DragonGlassFactory dragonGlassFactory() {
return new DragonGlassFactory();
}

View Slide

ConditionalOnPuzzler
@Configuration
public class КонфигурацияКазни {
@Bean
@ConditionalOnClass ({Мыло.class, Веревка.class})
@ConditionalOnMissingBean ({ФабрикаКазни. class})
public ФабрикаКазни виселицы() { return new ФабрикаВиселиц( "..."); }
}

View Slide

@Configuration
@Bean
@Bean
@ConditionalOnClass ({Стул.class, Ток.class})
public ФабрикаКазни cтулья() { return new ФабрикаЭлектрическихСтульев( "вж вж"); }
}

View Slide

@Configuration
@Bean
@Bean
@Bean
@ConditionalOnClass ({Гильотина.class, ХорошееНастроение. class})
public ФабрикаКазни гильотины() { return new ФабрикаГильотин( "хрусть хрусть"); }
}

View Slide

@Configuration
@Bean
@Bean
@Bean
@ConditionalOnClass ({Гильотина.class, ХорошееНастроение. class})
public ФабрикаКазни гильотины() { return new ФабрикаГильотин( "хрусть хрусть"); }
}
1. ClassDefNotFound ?
2. Так вообще нельзя, не
компилируется
3. Будет работать
4. Будет отлично работать

View Slide

Потому что ASM

View Slide

OnPropertyCondition
@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {
String[] value() default {};
String prefix() default "";
String[] name() default {};
String havingValue() default "";
boolean matchIfMissing() default false;
boolean relaxedNames() default true;
}
Что если нужно изменить?

View Slide

Люблю Spring Boot
Но хочу Tomcat

View Slide

@Override
ServletException {
AnnotationConfigWebApplicationContext webContext = new
webContext.register(WebConfig.class);
ServletRegistration.Dynamic servlet =
servletContext.addServlet("dispatcher", new
DispatcherServlet(webContext));
servlet.setLoadOnStartup(1);
AnnotationConfigWebApplicationContext appContext = new
appContext.register(AppConfig.class);
servletContext.addListener(new ContextLoaderListener(appContext));
servlet.addMapping("/*");
}

View Slide

@Override
public void onStartup(ServletContext servletContext){
SpringApplication.run(RipperApplication.class);
}
}

View Slide

@Override
public void onStartup(ServletContext servletContext) {
}
}
public class RipperApplication {
SpringApplication.run(RipperApplication.class, args);
}
}

View Slide

А в Tomcat не запустилось!
В Tomcat`e
не пашет

View Slide

public class WebStarter implements WebApplicationInitializer{
@Override
ServletException {
}
}
Tomcat в Tomcat`е

View Slide

Читаем документацию

View Slide

§ 85.1 Create a deployable war file
public class Application extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder app) {
return app.sources(Application.class);
}
public static void main(String[] args) throws Exception {
SpringApplication.run(Application.class, args);
}
}

View Slide

@Override
}
}
}
Работает по
разному

View Slide

@Override
}
}
}

View Slide

@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder a) {
return application.sources(Application.class);
}
}
}
Никогда не запустится в tomcat
Только java -jar

View Slide

@Override
}
}
}
Без main не соберется
см. maven/gradle плагины
Обязательно

View Slide

@Override
}
}
}
Опционально

View Slide

@Override
}
}
}
Никогда не запустится в embedded режиме
Только в Tomcat контейнере
Опционально

View Slide

А как убрать tomcat из tomcat?
If you are using a version of Gradle that supports compile only dependencies (2.12
or later), you should continue to use providedRuntime. Among other limitations,
compileOnly dependencies are not on the test classpath so any web-based
integration tests will fail.

View Slide

Jar стал похож на War

View Slide

View Slide

Замочили web.xml

View Slide

Замочили web.xml
Вместе с Tomcat`ом
Вопросы?

View Slide

Наконец то будем писать код!

View Slide

Напишем Экзаминатора
public static void main(String[] args){
SpringApplication.run(
ExaminatorApplication.class,
args);
}

View Slide

{
"География":5,
"Физика" :3
}
Физика Математика
Теология
Не грешно ли лезть в атом? Теорема Пифагора
Неравенство Коши
ваы
Количество вопросов Количество вопросов
Экзаминатор

View Slide

С чего начинают строить микросервис
→Контроллеры
→Сервисы
→Dao
→Model

View Slide

С чего начинают строить микросервис
→Контроллеры
→Сервисы
→Dao
→Model – поскольку модель используется на всех слоях, пожалуй
лучше начинать с неё

View Slide

in: {
"student": "Борисов Евгений",
"title": "Экзамен на JokerConf",
"sections": [{
"title": "Java",
"description": "простые вопросы по java",
"exercises": [
{ "question": "разница между spring string и swing",
"answer": "без spring`а не обойтись" },
{ "question": "разница между final finally finalize",
"answer": "за finalize отрывают руки" }
]},
{
"title": "философия",
"description": "сложные вопросы по философии",
"exercises": [{
"question": "В чем смысл жизни",
"answer": "42"
}, {
"question": "Что раньше, яйцо или курица",
"answer": "петух"
}]
}]
}
out: {
"mark": 99,
"sections": [{
"title": "Java",
"exercises": [
]},
{
"exercises": [{
"answer": "42"
}, {
}]
}]
}

View Slide

Data model - задание
Придумайте архитектуру модели, которая позволит написать Сервис:
- принимающий на вход объект SolvedExam
- отдающий CheckedExam с оценкой
- Должны проходить тесты
@Test
public void checkExamineContract() throws Exception {
...
mockMvc.perform(post("/examine"))
...
}
Use @RestController and @RequestMapping > @*Mapping Luke

View Slide

@RestController("/examine")
Ошибку видишь? А она есть

View Slide

@RestController("/examine")
Это имя spring bean, не http path
И это даже может работать:
● Если нет ни одного контроллера с путём (всегда будет вызываться)
● Если потом указали полный путь в @RequestMapping

View Slide

@RequestMapping и его братья
Управляет маршрутизацией запросов в метод контроллера. Маршрутизирует
по:
● name/value – сам http path
● method – http method
● params
● headers

View Slide

@PostMapping("/examine")
public CheckedExam ex`( @RequestBody SolvedExam title) { }
@RequestMapping (path = "/examine", method = POST)
public CheckedExam ex2( @RequestBody SolvedExam title) { }
@RequestMapping (path = "/examine", method = POST, headers = {"my-app=appid"})
@GetMapping(path = "/examine", headers = {"content-type=application/json"})
public CheckedExam ex3() { }
@GetMapping(path = "/examine", produces =
MimeTypeUtils. APPLICATION_JSON_VALUE)

View Slide

public CheckedExam ex`( @RequestBody SolvedExam title) { }
@RequestMapping (path = "/examine", method = POST)
@GetMapping(path = "/examine", headers = {"content-type=application/json"})
@GetMapping(path = "/examine", produces = APPLICATION_JSON_VALUE)
@GetMapping(path = "/examine", produces = APPLICATION_JSON_VALUE)

View Slide

//curl -XPOST /examine -d '{ "title": {..} }'
public CheckedExam ex`( @RequestBody SolvedExam exam) { }
//curl -XGET /examine/ mytitle
@GetMapping("/examine/{title}")
public CheckedExam ex3( @PathVariable String title) { }
//curl -XGET /examine/mytitle ?debug=true
@GetMapping("/examine/{title}")
public CheckedExam ex3( @PathVariable String title, @RequestParam Boolean debug)
{ }

View Slide

@RequestMapping автовпрыскивание
public CheckedExam ex6(HttpServletRequest httpServletRequest,
Authentication auth,
UserDetails user,
etc
) { }

View Slide

Data model - задание
Придумайте архитектуру модели, которая позволит написать Сервис:
- принимающий на вход объект SolvedExam
- отдающий CheckedExam с оценкой
- Смотрите в src/test/resources/*.json
- Должны проходить тесты
@Test
public void checkExamineContract() throws Exception {
...
mockMvc.perform(post("/examine"))
...
}
Use @RestController and @RequestMapping > @*Mapping Luke

View Slide

Зло наследования

View Slide

Композиция намного лучше

View Slide

У композиции нет границ

View Slide

Lombok – composition / delegate and friends
Annotation Processor
Работает на этапе компиляции
Генерит код, чтобы мы не писали
Делает джаву более похожим на нормальный язык

View Slide

Про lombok, модели и не только
@Data – POJO (@Getter, @Setter, @ToString, @EqualsAndHashcode)
@Value – immutable POJO
@AllArgumentConstruct(onConstructor = @_(@Autowired))

View Slide

Про lombok, модели и не только
@Data – POJO (@Getter, @Setter, @ToString, @EqualsAndHashcode)
@Value – immutable POJO
@AllArgumentConstruct(onConstructor = @_(@Autowired))
@RequireArgumentConstructor /@NoArgumentConstructor
@Builder / @Singular
@Delegate – примерно как в груви
@SneakyThrows
@Slf4j / @Log4j / …

View Slide

Теперь давайте разбираться Джэксоном

View Slide

Как Джексон пишет в джейсон
1. Использует Java Getters
a. Методы начинающиеся с Get
2. @JsonIgnore – игнорируем Getter
3. Нет ни одного Getter – падает

View Slide

Как Джексон пишет в объект
1. Нет конструктора с @ConstructProperies
→ выставляет через Setters
→ если нет Setter и есть Getter – выставляет напрямую в филды
→ это все только при наличии пустого конструктора
2. Есть конструктор с @ConstructProperies
→ выставляет значение через него
3. После зачем то вызовет все геттеры
* Но если есть то @JsonIgnore всё по другому
* Это поведение по умолчанию

View Slide

Меняем дифолтное поведение
@JsonIgnoreProperties
@JsonIgnoreType
@JsonIgnore
@JsonProperty

View Slide

Что не так с JSR 310?

View Slide

→ Если вы настраиваете руками:
ObjectMapper mapper = new ObjectMapper()
.registerModule( new ParameterNamesModule())
.registerModule( new Jdk8Module())
.registerModule( new JavaTimeModule());
→ Или так:
mapper.findAndRegisterModules();
Не забыть зависимости:
compile 'com.fasterxml.jackson.module:jackson-module-parameter-names'
compile 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8'
compile 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310'
C последних версий есть поддержка Java8

View Slide

Достаточно одних зависимостей
Если вы работаете с Spring Boot

View Slide

Как Spring MVC работает с Джексоном
Напишите метод который принимает json и класс, а возвращает объект
данного класса
Пробуем использовать objectMapper Jackson2

View Slide

@DateTimeFormat
Ну вы в курсе…
А ещё можно в application.properties

View Slide

Кстати о сериалайзерах
Давайте как то без них, по возможности

View Slide

Задание 2
Микросервис – Теологии
1. Добавлять вопросы по теологии … (CRUD)
2. Получать нужное количество рандомальных вопросов
3. Тест должен проходить
@Test
public void should_return_random_exercise() throws Exception {
mvc.perform(get("/exercise/random?count=3")
.contentType( APPLICATION_JSON)
)
…
Use JpaRepository and @RequestMapping Luke

View Slide

{
"Физика" :3
}
Теология
ваы

View Slide

in: {
"student": "Борисов Евгений",
"sections": [{
"title": "Java",
"exercises": [
]
}, {
"exercises": [{
"answer": "42"
}, {
}]
}]
}

View Slide

compile 'org.springframework.data:spring-data-rest-webmvc'
Подключаем Spring Data Rest

View Slide

Подключаем Spring Data Rest
compile 'org.springframework.data:spring-data-rest-webmvc'
или
compile 'org.springframework.boot:spring-boot-starter-data-rest'

View Slide

Дальше пишем Entity + Repository
Which repositories get exposed by defaults?
Name Description
DEFAULT Exposes all public repository interfaces but considers
@Repository/@RestResource’s `exported flag
ALL Exposes all repositories independently of type visibility and
annotations
ANNOTATION Only repositories annotated with @Repository/@RestResource
are exposed, unless their exported flag is set to false
VISIBILITY Only public repositories annotated are exposed

View Slide

Как поменять стратегию
@Component
public class MyWebConfiguration extends RepositoryRestConfigurerAdapter {
@Override
public void configureRepositoryRestConfiguration(
RepositoryRestConfiguration config) {
config.setRepositoryDetectionStrategy( ALL);
}
}

View Slide

Как задать URL
@Configuration
class CustomRestMvcConfiguration {
@Bean
public RepositoryRestConfigurer repositoryRestConfigurer() {
return new RepositoryRestConfigurerAdapter() {
@Override
configuration.setBasePath( "/api")
}
};
}
}

View Slide

Как задать URL
@Configuration
class CustomRestMvcConfiguration {
@Bean
public RepositoryRestConfigurer repositoryRestConfigurer() {
return new RepositoryRestConfigurerAdapter() {
@Override
configuration.setBasePath( "/api")
}
};
}
}
Или в том же RepositoryRestConfigurerAdapter прописать
в application.properties - spring.data.rest.base-path=/api

View Slide

Spring Data Rest official supports
→Spring Data JPA
→Spring Data MongoDB
→Spring Data Neo4j
→Spring Data GemFire
→Spring Data Cassandra

View Slide

@RepositoryRestResource
@RepositoryRestResource (collectionResourceRel = "people", path = "people")
public interface PersonRepository extends MongoRepository {
@RestResource(path = "byname")
List findByLastName(@Param( "name") String name);
}

View Slide

URL’s и методы
localhost:8080/exercise – список всех (GET)
localhost:8080/exercise/1 – дай человека с айдишником 1 (GET)
localhost:8080/exercise/1 – стереть с айдишником 1 (DELETE)
localhost:8080/exercise/1 – заменить с айдишником 1 (PUT)
localhost:8080/exercise/1 – проапдэйтить с айдишником 1 (PATCH)
localhost:8080/exercise/search/findByName?name=Lanister

View Slide

{
"Физика" :3
}
Теология
ваы

View Slide

Задание 3
Связать сервисы Экзаменатора и Предметы
● Запустить и проверить самим
● Должен отдаваться запрос с ответами другого сервиса
{
"Физика" :3
}

View Slide

--server.port
Конфликт портов решается с помощью relaxed properties
export SERVER_PORT=8081
java -jar --server.port=8081
SPRING_APPLICATION_JSON = '{"server":{"port":8081}}'

View Slide

Шаринг кода
модель/бизнес
логика/инфраструктурный код
● Шарить
● Или не шарить

View Slide

Подход №1 - общий код
Зачем разбивать микросервис на модули?
→ Java API для сервисов
→ фиксация контракта на уровне зависимостей языка
→ утилитарная функция, избавления от бойлерплейта

View Slide

project
|- project-sdk
|- project-app
|- project-...

View Slide

Подход №2 - общий контракт
→ разделение кода и контракта
→ поставка контракта отдельно

View Slide

Обратимся к истории
→ REST подход
○
→ RPC подход
○

View Slide

○ анархия и рекомендации
○

View Slide

○ jax-ws/jax-rpc
○ corba
○ json rpc
○
○

View Slide

○ jax-ws/jax-rpc
○ corba
○ json rpc
○ thrift
○ protobuf/grpc
○ etc

View Slide

Задание 5
● пишем SDK для вызова микросервиса по теологии
● и тесты для него
● тестируем контракт
● тестируем взаимодействие
○ WireMock/Spring MockServer
○ Spring Boot Test
○ Context Scanning behaviour
Тест SDK Тест Контракта Тест Взаимодействия

View Slide

Разбиваем микросервис на модули
Кому отсыпать
наносервисов?

View Slide

Конец 1й части
приходите на Spring Boot Ripper

View Slide

Тренинг с конференции Joker 2017

View Slide

Часть 2
Микросервисы при масштабировании

View Slide

{
"Физика" :3
}
Теология
Энтропия не?

View Slide

{
"Физика" :3
}
Теология
Теорема Пифагора
ваы
Бог
Не грешно ли лезть в атом?

View Slide

Матмематика – сервис
● Сделать новый модуль
● Реализовать метод "/exercise/random"
● Возвращать список автогенерируемых упражнение (как в Теологии)

View Slide

Как воткнуть в Examinator?

View Slide

Как воткнуть в Examinator math-service?
exercises:
urls:
"theology" : "http://localhost:8080/"

View Slide

exercises:
urls:
"math" : "http://localhost:8082/" Потому что на 8081
Examinator

View Slide

exercises:
urls:
"math" : "http://localhost:8082/"
"examinator": "http://localhost:8081/"
"..." : "http://localhost:8083/"
Service Registry в application.yml

View Slide

А как шарить service registry в yml?

View Slide

Service Registry – Eureka

View Slide

{
"Физика" :3
}
Количество вопросов
Теология
Discovery Server

View Slide

{
"Физика" :3
}
Теология
Discovery Server
Eureka Clients
Eureka Server

View Slide

Eureka Server and Client
compile 'org.springframework.cloud:spring-cloud-starter-eureka-server'
compile 'org.springframework.cloud:spring-cloud-starter-eureka'

View Slide

Your own Discovery Server
@EnableEurekaServer
public class EurekaServer {
SpringApplication.run(EurekaServer.class, args);
}
}

View Slide

Переводим на Eureka
● Создаём модуль eureka-server

View Slide

● Интегрируем клиента (examinator-service, theology-service, math-service)

View Slide

● Интегрируем клиента (examinator-service, theology-service, math-service)
compile 'org.springframework.boot:spring-boot-starter-actuator'
@EnableDiscoveryClient vs @EnableEurekaClient
eureka.client.service-url.default-zone: http://127.0.0.1:8761/eureka/

View Slide

@EnableDiscoveryClient
Будет включен по умолчанию при добавлении стартера c Edgware
spring-cloud release train

View Slide

И как это использовать?
Как переделать Examinator, чтобы он соблюдал open close?

View Slide

Кто это у нас там спрятался?
Смотрим какие сервисы загрузились
$ http :8082/health
{
"description": "Remote status from Eureka server",
"status": "DOWN"
}
{
"description": "Spring Cloud Eureka Discovery Client",
"status": "UP"
}

View Slide

Кто это у нас там спрятался?
Выключаем security для управляющий API
management:
security:
enabled: false
Теперь
$ http :8082/health

View Slide

{
"discoveryComposite": {
"discoveryClient": {
"services": [
"examinator-service",
"math-service",
"theology-service"
],
"status": "UP"
},
"eureka": {
"applications": {
"EXAMINATOR-SERVICE": 1,
"MATH-SERVICE": 1,
"THEOLOGY-SERVICE": 1
},
"description": "Remote status from Eureka server",
"status": "UP"
},
"status": "UP"
},
"diskSpace": {
"free": 190254260224,
"status": "UP",
"threshold": 10485760,
"total": 499055067136
},
...

View Slide

Как обратиться к сервисам по имени?
restTemplate.getForObject(
"http://"+serviceName+"/exercice/random?count=" + number,
Exercice[].class
);

View Slide

True Discovery
● Изменить логику резолва сервиса использую имя сервиса
Use @LoadBalanced or LoadBalancerInterceptor Luke

View Slide

Discovery и Load Balancing
Две стороны одного и того же

View Slide

Discovery и Load Balancing
Две стороны одного и того же
Server Side vs Client Side

View Slide

238
Service Client
Registry-aware
HTTP Client
Service Registry
Service Instance 1
Service Instance N
Service Instance ...
Load balance request
Client side discovery
Ribbon +
Eureka Discovery client

View Slide

239
Service Client
Service Registry
Service Instance 1
Service Instance N
Service Instance ...
Load balance request
Router/Proxy
Server side discovery

View Slide

Получили Client Side LB
Нахаляву!

View Slide

Попроще никак?

View Slide

Принципы SOA
242
1. Standardized service contract
2. Loose coupling
3. Encapsulation
4. Reusability
5. Autonomy
6. Statelessness
7. Discoverability

View Slide

Принципы SOA
243
1. Standardized service contract
2. Loose coupling
3. Encapsulation
4. Reusability
5. Autonomy
6. Statelessness
7. Discoverability

View Slide

Fluent annotations
244
@Getter // generate getters
@Setter // generate setters
@Aspect // we are an aspect
@ToString // generate toString()
@EnableWs // SOAP is so enterprisy, we definitely need it
@Endpoint // Seriously, just read above
@EnableWebMvc // we want MVC
@EnableCaching // and we want to cache stuff
@Configuration // this class can configure itself
@RestController // we want some REST
@XmlRootElement // this component is marshallable
@EnableWebSocket // we want web socket, it's so new-generation
@RedisHash("cat") // this class is an entity saved in redis
@EnableScheduling // we want scheduled tasks
@EnableWebSecurity // and some built-in security
@NoArgsConstructor // generate no args constructor
@ContextConfiguration // we want context configuration for unit testing
@SpringBootApplication // this is a Sprint Boot application
@Accessors(chain = true) // getters/setters are chained (ala jQuery)
@EnableAspectJAutoProxy // we want AspectJ auto proxy
@EnableAutoConfiguration // and auto configuration

View Slide

Парадокс централизации
Чтобы эффективно разрабатывать распределённые
приложения, нам нужны очень хорошие
централизованные библиотеки и инструменты
Например: логирование, health-checking, метрики,
обработка типовых ошибок, автодокументирование
245

View Slide

Но: не выносите бизнес-логику или доменные объекты!
Не размывайте бизнес-контекст вашего API
246

View Slide

Управление конфигурацией

View Slide

Your own Config Server
● Создать модуль config-server
compile 'org.springframework.cloud:spring-cloud-config-client'
@EnableConfigServer
spring:
cloud:
config:
server:
git:
uri: https://github.com/lavcraft/spring-boot-and-cloud-workshop-joker2017-configs.git

View Slide

Проблема курица и яйца
Откуда брать координаты eureka?
● из сonfig-server (для всех же одинаковые)
● из локальных настроек (ENV/*.yml/etc)
Откуда брать координаты config-server
● из eureka
● из локальных настроек (ENV/*.yml/etc)

View Slide

App Instance #0
App Instance #N
Config Server
Eureka
Bootstrap Server URL
ИЛИ

View Slide

Config Server Discovery
Через Service Discovery
App Instance #0
App Instance #N
Config Server
По прямой ссылке
Eureka

View Slide

App Instance #0
App Instance #N Eureka
Config Server
register on start
get Config Server by name

View Slide

App Instance #0
Config Server
register on start
return config server instances
location

View Slide

App Instance #0
Config Server
register on start
return config server instances
location
get configs for App

View Slide

По прямой ссылке
App Instance #0
App Instance #N
Config Server
get configs for App
Http Load Balancer

View Slide

Config Client
● интегрируем config-server и *-service через eureka
● включаем/отключаем management.security

View Slide

Обновление на лету
@RefreshScope

View Slide

Начнём с примера
@RestController
@RefreshScope
public class TestController {
@Value("${foo.bar}")
String test;
@GetMapping("/foo")
public String getFooBar() {
return test;
}
}

View Slide

Три простых шага
1. Ставим @RefreshScope над бином который нужно обновлять
2. Обновляем в config server
foo.bar: some val
a. Можно не править а дёрнуть /env если есть actuator
3. Дёргаем у приложения /refresh
a. Для этого нужен actuator

View Slide

А как обновить всё разом?

View Slide

Spring Cloud Bus

View Slide

Теология
Теология
Config Server
ALL APP
Discovery Server
ALL APP

View Slide

Теология
Теология
Queue Config Server
ALL APP
Discovery Server
ALL APP
ALL APP

View Slide

Spring Cloud Bus
dependencyManagement {
imports {
mavenBom 'org.springframework.cloud:spring-cloud-bus:1.3.1.RELEASE'
}
}
dependencies {
compile 'org.springframework.cloud:spring-cloud-starter-bus-amqp'
}

View Slide

Настройки в сonfig server application.yml
spring:
rabbitmq:
host: localhost
port: 5672

View Slide

Теперь достаточно /refresh на config-server
1. Все приложения обновят конфигурации при получении refresh ивента в
rabbitmq

View Slide

Теперь достаточно /refresh на config-server
1. Все приложения обновят конфигу при получении refresh ивента в
rabbitmq
2. Для автоматизации можно использовать config-monitor + git webhook
compile 'org.springframework.cloud:spring-cloud-config-monitor'
3. Не забывать @RefreshScope

View Slide

spring-cloud-config-monitor
GitHub
commit Config Monitor
webhook
Queue
refresh
event

View Slide

spring-cloud-config-monitor
Config Server
GitHub
commit Config Monitor
webhook
Queue
refresh
event
Теология
Теология
Теология
...
auto /refresh on event

View Slide

Spring Cloud Gateway

View Slide

Теология
Теология
Queue
Config Server
ALL APP
Discovery Server
ALL APP
ALL APP

View Slide

Теология
Теология
Queue Config Server
ALL APP
Discovery Server
ALL APP
ALL APP

View Slide

Экзаминатор:8080
Экзаминатор:...

View Slide

Теология
Теология
Gateway Server
Queue Config Server
ALL APP
Discovery Server
ALL APP
ALL APP

View Slide

Reverse Proxy Problem
@EnableZuulProxy
vs
@EnableZuulServer

View Slide

Зависимости Zuul – Gateway
dependencies {
compile 'org.springframework.cloud:spring-cloud-starter-zuul'
}

View Slide

Защити себя сам
281

View Slide

282

View Slide

283
Хочу бегемота!
Rent Service
Payment Service
Security Service Blockchain Service
Insurance Service
5мс

View Slide

284
Rent Service
Payment Service
Insurance Service
300мс

View Slide

285
Rent Service
Payment Service
Insurance Service
300мс

View Slide

286
Rent Service
Payment Service
Insurance Service
300мс

View Slide

287
Rent Service
Payment Service
Insurance Service
300мс

View Slide

288
Circuit Breaker

View Slide

289
Rent Service
Payment Service
Insurance Service
300мс

View Slide

290
Rent Service
Payment Service
Insurance Service
300мс
Open

View Slide

291
Rent Service
Payment Service
Insurance Service
300мс
Half-Open

View Slide

292
Rent Service
Payment Service
Insurance Service
5мс
Half-Open

View Slide

293
Rent Service
Payment Service
Insurance Service
5мс

View Slide

hystrix/apache camel/akka
294

View Slide

295

View Slide

Gateway + Hystrix + Dashboard + Discovery
dependencies {
compile 'org.springframework.boot:spring-boot-starter-actuator'
compile 'org.springframework.cloud:spring-cloud-starter-zuul'
compile 'org.springframework.cloud:spring-cloud-starter-hystrix'
compile 'org.springframework.cloud:spring-cloud-starter-hystrix-dashboard'
}

View Slide

Следи за своим ПО
297

View Slide

Нет трассировки - нет проблем? :)
298

View Slide

X-Request-Id = X-Request-Id ?: new ID
Простой вариант с ServletFilter
299

View Slide

spring-cloud-sleuth/open zipkin
300

View Slide

301
Rent Service
No TraceId
No SpanId
TraceId = X
SpanId = A

View Slide

302
Rent Service
Payment Service
No TraceId
No SpanId
TraceId = X
SpanId = A
TraceId = X
SpanId = B
TraceId = X
SpanId = C

View Slide

303
Rent Service
Payment Service
Blockchain Service
No TraceId
No SpanId
TraceId = X
SpanId = A
TraceId = X
SpanId = B
TraceId = X
SpanId = C
TraceId = X
SpanId = D
TraceId = X
SpanId = D
TraceId = X
SpanId = F

View Slide

304
Rent Service
Payment Service
No TraceId
No SpanId
TraceId = X
SpanId = A
TraceId = X
SpanId = B
TraceId = X
SpanId = C
TraceId = X
SpanId = D
TraceId = X
SpanId = D
TraceId = X
SpanId = E
TraceId = X
SpanId = E
TraceId = X
SpanId = F
TraceId = X
SpanId = G

View Slide

305
Rent Service
Payment Service
No TraceId
No SpanId
TraceId = X
SpanId = A
TraceId = X
SpanId = B
TraceId = X
SpanId = B
TraceId = X
SpanId = C
TraceId = X
SpanId = C
TraceId = X
SpanId = D
TraceId = X
SpanId = D
TraceId = X
SpanId = E
TraceId = X
SpanId = E
TraceId = X
SpanId = F
TraceId = X
SpanId = G

View Slide

306
Rent Service
Payment Service
TraceId = X
SpanId = A
No TraceId
No SpanId
TraceId = X
SpanId = A
TraceId = X
SpanId = A
TraceId = X
SpanId = B
TraceId = X
SpanId = B
TraceId = X
SpanId = C
TraceId = X
SpanId = C
TraceId = X
SpanId = D
TraceId = X
SpanId = D
TraceId = X
SpanId = E
TraceId = X
SpanId = E
TraceId = X
SpanId = F
TraceId = X
SpanId = G

View Slide

307

View Slide

308

View Slide

309
Rent Service
Payment Service

View Slide

310
Rent Service
Payment Service
SpanId = B
Client Send
TraceId = X
SpanId = A

View Slide

311
Rent Service
Payment Service
SpanId = B
Client Send
SpanId = B
Server Received
TraceId = X
SpanId = A
TraceId = X
SpanId = C

View Slide

312
Rent Service
Payment Service
SpanId = B
Client Send
SpanId = B
Server Received
SpanId = B
Server Send
TraceId = X
SpanId = A
TraceId = X
SpanId = C

View Slide

313
Rent Service
Payment Service
SpanId = B
Client Send
SpanId = B
Server Received
SpanId = B
Client Received
SpanId = B
Server Send
TraceId = X
SpanId = A
TraceId = X
SpanId = C

View Slide

documentation → smart documentation
314

View Slide

Not smart
= This is main documentation
This document describes how to be the most fundamental and important
document in the world of documents
...
COPY-PASTE documentation from another document
...
315

View Slide

Not so smart
This document describes how to be the most fundamental and important document
in the world of documents
include::https://raw.github.com/asciidoctor/asciidoctor/master/Gemfile[]
include::../other.adoc[]
include::/home/tolkv/git/docs-0/superdoc.adoc[]
316

View Slide

Really smart
This document describes how to be the most fundamental and important document
in the world of documents
include::https://raw.github.com/asciidoctor/asciidoctor/master/Gemfile[]
include::gradle://gradle-advanced:service-with-deps:1.0/deps.adoc[]
include::gradle://:service/doc.adoc[]
317

View Slide

Payment Service[jar,doc] Insurance Service [jar,doc]
One Point of View
[UberDoc.zip]
Rent Service[jar,doc] Other Service [jar,doc]
Агрегация информации
318

View Slide

Например: логирование, health-checking, метрики,
обработка типовых ошибок, автодокументирование
319

View Slide

Но: не выносите бизнес-логику или доменные объекты!
Не размывайте бизнес-контекст вашего API
320

View Slide

Spring boot/cloud workshop at jpoint 2018

Spring boot/cloud workshop at jpoint 2018

Kirill Tolkachev

More Decks by Kirill Tolkachev

Other Decks in Technology

Featured

Transcript