https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide

Before You Start

Upgrade to the latest 1.5.x version

가장 먼저, 1.5.x 의 최신 버전으로 업그레이드를 하라
Review dependencies
dependency management 버전을 1.5.x 와 2.0.x 서로 비교해 봐라
Spring Boot 에서 관리 안하는 디펜던시 (e.g. Spring Cloud) 도 호환 가능한 버전을 살펴봐라
Review custom configuration
모든 사용자 configuration 은 검토해야 한다. 표준 auto-configuration 로 대체 가능하면 이걸로 바꿔라
Review system requirements
Java 8+
Upgrade to Spring Boot 2
최신 Spring Boot 2.0 버전으로 업그레이드 해라 (2.0.0.RELEASE 로 하지 말고)
단계적 업그레이드 추천 (2.0 -> 2.1)
Configuration properties migration
application.yml 에서 이름이 바뀌거나 업데이트 된게 많은데, spring-boot-properties-migrator 해봐라
- startup 시 분석해주거나 런타임시 임시적으로 마이그레이션도 해줌
- 근데, 마이그레이션 할때에만 쓰고, 끝나면 지워라
```
runtime("org.springframework.boot:spring-boot-properties-migrator")
```
  Next steps
Spring Boot 2.0.0 Release Notes
Running Spring Boot on Java 9
Upgrading to Spring Framework 5.0
Building Your Spring Boot Application

Spring Boot Gradle Plugin

Dependency Management

dependency management plugin 을 이제 직접 넣어줘야 함

apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management' // <-- add this to your build.gradle

Building Executable Jars and Wars

bootRepackage task 가 bootJar 와 bootWar 로 나눠짐

Spring Boot Features

Default Proxying Strategy

이제 기본적으로 CGLIB proxying 을 지원 함 (AOP 지원 포함)
- interface-based proxy 를 원하면 spring.aop.proxy-target-class to false
  SpringApplication
  
  Web Environment
spring.main.web-environment -> spring.main.web-application-type
웹 서버 사용을 원하지 않으면
```
spring.main.web-application-type=none
```
Spring Boot Application Events Changes
ApplicationStartedEvent 가 추가 됨
- 애플리케이션 and command-line 러너가 불리기 전, 컨텍스트가 갱신된 후 호출 함
  Externalized Configuration
  
  Relaxed Binding
@ConditionalOnProperty 에서 canonical format 만 써라 (acme.my-property and not acme.myProperty)
RelaxedPropertyResolver 사용 불가

Binder API

MyProperties target = Binder.get(environment)
    .bind("app.acme", MyProperties.class)
    .orElse(null);

Binding on static methods

1.x에서는 됐으나 정적 속성 안됨 (static getter and setter). 의도한 바가 아님
@ConfigurationProperties Validation
@Validated 로 유효성 검사 해라
Configuration Location
spring.config.location -> spring.config.additional-location
Developing Web Applications

Embedded containers package structure
reactive 지원 하려고, 임베디드 컨테이너 패키지 구조가 많이 바뀜
- org.springframework.boot.context.embedded -> org.springframework.boot.web.server
- EmbeddedServletContainerCustomizer -> WebServerFactoryCustomizer
  Servlet-specific server properties
server.* properties -> server.servlet
Web Starter as a Transitive Dependency
이전에는 spring-boot-starter-web 쓰면 무조건 Spring MVC 였는데, WebFlux 지원을 위해 spring-boot-starter-mustache, spring-boot-starter-freemarker and spring-boot-starter-thymeleaf 가 새로 나옴
또한 spring-boot-starter-web or spring-boot-starter-webflux 둘중에 하나 골라라
Template Engines

Thymeleaf
Thymeleaf 3 로 업그레이드
이제 thymeleaf-layout-dialect 이 기본적으로 포함 안됨. layout 을 원하면 직접 디펜던시 추가해라
Mustache Templates Default File Extension
Mustache templates 기본 확장자는 .html 인데 이제는 .mustache 다
- spring.mustache.suffix 로 수정 가능
  Jackson / JSON Support
JSR-310 dates as ISO-8601 이 기본으로 추가 됨
- 이전으로 돌아가려면 spring.jackson.serialization.write-dates-as-timestamps=true
spring-boot-starter-json 안에 jackson-databind, jackson-datatype-jdk8, jackson-datatype-jsr310, jackson-module-parameter-names 모두 들어 있음
Spring MVC Path Matching Default Behavior Change
suffix path 매칭 로직이 이제 기본적으로 disable
- GET /projects/spring-boot.json 이렇게 쓰지마라. media-type 은 ACCEPT 헤더로 할것
물론, 수동으로 조절 가능
Servlet Filters
default dispatcher types for a Servlet Filter are now DipatcherType.REQUEST
- ASYNC, ERROR, and REQUEST dispatcher types 가 있음
  RestTemplateBuilder
requestFactory(ClientHttpRequestFactory) method -> requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier) method
WebJars Locator
디펜던시 org.webjars:webjars-locator -> org.webjars:webjars-locator-core
Custom DispatcherServlet registration
생략
Security
기본 보안 구성이 간단해졌고, 커스텀 구성도 쉬워짐
Default Security
security auto-configuration 은 노출하지 않고, 가능한한 기본 Spring Security 를 사용 함
static 리소스, 에러 endpoint 도 이제 기본적으로 보안 구성 됨
- /css/, /js/, /images/, /webjars/, /**/favicon.ico
  Default User
password 를 가진 기본 유저를 구성 함
- spring.security.user.* 로 커스터마이징
- 혹은 UserDetailsService Bean 생성 하면 됨
  AuthenticationManager Bean
AuthenticationManager bean 을 노출하고 싶으면, WebSecurityConfigurerAdapter 에서 authenticationManagerBean 메소드를 override 하고 @Bean 을 붙혀라
OAuth2
Spring Security OAuth project -> Spring Security
Actuator Security
Actuator 보안 자동 구성이 없어짐
- management.security.* property

sensitive flag 는 각 endpount 에서 명확하게 구성해라

endpoints.flyway.sensitive=false
endpoints.info.sensitive=true
management.security.roles=MY_ADMIN

http
.authorizeRequests()
.requestMatchers(EndpointRequest.to("health", "flyway")).permitAll()
    .requestMatchers(EndpointRequest.toAnyEndpoint()).hasRole("MY_ADMIN")
    ...

Working with SQL Databases

Spring Data Kay -> CRUD repository methods
Configuring a DataSource
Tomcat -> HikariCP
WARN Message for Implicit 'open-in-view'
spring.jpa.open-in-view 를 명시적으로 enable 안하면 startup 시 WARN 메시지 로그 뜸
- 뷰 렌더링 중에 데이터베이스 쿼리가 수행 될 수 있음
  JPA
이제HibernateJpaAutoConfiguration extend 지원 안함
- 하고 싶으면 HibernatePropertiesCustomizer 로
  Id generator
spring.jpa.hibernate.use-new-id-generator-mappings 는 이제 기본적으로 true
Flyway
설정을 spring.flyway namespace 로 옮김
Flyway 버전 from 3.x to 5.x
Liquibase
설정을 spring.liquibase namespace 로 옮김
Database Initialization
임베디드 data sources 쓸때에만 초기화 해줌
spring.datasource.initialize -> spring.datasource.initialization-mode
Updated Default 'create-drop' Handling
spring.jpa.hibernate.ddl-auto 은 스키마 매니저(Liquibase or Flyway)가 없을 경우에만 내장 데이터베이스를 사용하며, 기본적으로 create-drop 상태
- 스키마 매니저가 감지 되면 none 으로 바뀜
  Working with NoSQL Technologies
  
  Redis
spring-boot-starter-data-redis 사용시 Jedis -> Lettuce 로 바뀜
- 근데 commons-pool2 추가 필요
  Elasticsearch
Elasticsearch has been upgraded to 5.4+.
Caching

Dedicated Hazelcast Auto-configuration for Caching
안습
GuavaCacheManager
안습2 -> Caffeine 쓰세요
RedisCacheManager
Redis CacheManager implementation 이 많이 바뀌어서, 도큐먼트 보세요
Batch
CommandLineRunner 시작시 첫번째 순서는 0 임
Testing

Mockito 1.x
Mockito 1.x is no longer supported for @MockBean and @SpyBean
- spring-boot-starter-test 쓰고 있으면 상관 없음
  EnvironmentTestUtils

EnvironmentTestUtils -> TestPropertyValues

TestPropertyValues.of("acme.first=1", "acme.second=2")
    .and("acme.third=3")
    .applyTo(this.environment);

Creating Your Own Auto-configuration

ConditionalOnBean semantic change

ConditionalOnBean 은 OR -> AND
- 기존처럼 할려면 AnyNestedCondition 만들어서 해라
```
class ThisOrThatCondition extends AnyNestedCondition {
```
ThisOrThatCondition() { super(ConfigurationPhase.REGISTER_BEAN); }

@ConditionalOnBean(This.class) static class ThisCondition {

}

@ConditionalOnBean(That.class) static class ThatCondition {

}

}

# Spring Boot Actuator
## Build
* 기존에는 spring-boot-actuator 랑 spring-boot-actuator-autoconfigure 가 있었는데, 앞으로는 spring-boot-starter-actuator 만 추천
## Configuration Keys Structure
* property 이름이 바뀜. 원래 문서 참고
## Base Path
* `/actuator` 가 기본 endpoints
## Audit Event API Change
* 생략
## Endpoints
* HTTP actuator endpoint 를 사용하려면, enabled and exposed 둘다 필요하다
  * Spring Security 와 관련없이 /health and /info 는 노출 됨
  * /shutdown 을 제외한 모든 endpoints 활성화
* 모든 endpoints 노촐하기

management.endpoints.web.exposure.include=*

* /shutdown endpoint 명시적 노출

management.endpoint.shutdown.enabled=true

* env 를 제외한 모든 endpoints 노출하기

management.endpoints.web.exposure.include=* management.endpoints.web.exposure.exclude=env


## Endpoint Format
### Overhaul of the "/actuator/mappings" Actuator Endpoint
* 생략
### Overhaul of the "/actuator/httptrace" Actuator Endpoint
* 생략
## Migrate Custom Endpoints
* 생략. 필요하면 문서 보세요
# Metrics
## Setting up Micrometer
* Actuator 사용중이면 메트릭 자동구성 해줌.
* Prometheus, Atlas or Datadog 등을 위한 디펜던시 제공 함
## Migrating Custom Counters/Gauges
* 생략
## Spring Boot 1.5 Support
* 생략
# Developer Tools
## Hot swapping
* 제거됨. Devtools 쓰세요
## Devtools Remote Debug Tunnel
* tunnelling remote debugging over HTTP 가 제거됨
# Removed Features
* CRaSH support
* Auto-configuration and dependency management for Spring Mobile.
* Auto-configuration and dependency management for Spring Social. Please check the Spring Social project for more details.
* Dependency management for commons-digester.
* Test support in the CLI (i.e. spring test)
# Dependency Versions
The minimum supported version of the following libraries has changed:
* Elasticsearch 5.6
* Gradle 4
* Hibernate 5.2
* Jetty 9.4
* Spring Framework 5
* Spring Security 5
* Spring Integration 5 (see also their migration guide)
* Tomcat 8.5

Pyohwan / english-study

Spring Boot 2.0 Migration Guide #23

Before You Start

Upgrade to the latest 1.5.x version

Review dependencies

Review custom configuration

Review system requirements

Upgrade to Spring Boot 2

Configuration properties migration

Next steps

Building Your Spring Boot Application

Spring Boot Gradle Plugin

Dependency Management

Building Executable Jars and Wars

Spring Boot Features

Default Proxying Strategy

SpringApplication

Web Environment

Spring Boot Application Events Changes

Externalized Configuration

Relaxed Binding

Binding on static methods

@ConfigurationProperties Validation

Configuration Location

Developing Web Applications

Embedded containers package structure

Servlet-specific server properties

Web Starter as a Transitive Dependency

Template Engines

Thymeleaf

Mustache Templates Default File Extension

Jackson / JSON Support

Spring MVC Path Matching Default Behavior Change

Servlet Filters

RestTemplateBuilder

WebJars Locator

Custom DispatcherServlet registration

Security

Default Security

Default User

AuthenticationManager Bean

OAuth2

Actuator Security

Working with SQL Databases

Configuring a DataSource

WARN Message for Implicit 'open-in-view'

JPA

Id generator

Flyway

Liquibase

Database Initialization

Updated Default 'create-drop' Handling

Working with NoSQL Technologies

Redis

Elasticsearch

Caching

Dedicated Hazelcast Auto-configuration for Caching

GuavaCacheManager

RedisCacheManager

Batch

Testing

Mockito 1.x

EnvironmentTestUtils

Creating Your Own Auto-configuration

ConditionalOnBean semantic change