1128 ~ 1211

# 1128 ~ 1211

# 1201 - Spring REST Docs + Rest Assured

[ build.gradle ]

plugins {
    ...
    // Asciidoctor 플러그인을 적용
    id "org.asciidoctor.jvm.convert" version "3.3.2"
    ...
}

configurations {
    ...
    // asciidoctorExtAsciidoctor를 확장하는 종속성에 대한 구성을 선언
    asciidoctorExt
    ...
}

dependencies {
    ...
    // asciidoctorExt : spring-restdocs-asciidoctor 구성 의존성을 추가
    // snippets을 .adoc로 가리키고 build/generated-snippets 생성되도록 자동으로 구성 
    asciidoctorExt 'org.springframework.restdocs:spring-restdocs-asciidoctor'
    // spring-restdocs-restassured 의존성을 추가
    testImplementation 'org.springframework.restdocs:spring-restdocs-restassured'
    ...
}

ext {
    ...
    // 생성된 스니펫의 출력 위치를 정의하도록 속성을 구성
    set('snippetsDir', file("build/generated-snippets"))
    ...
}

tasks.named('test') {
    outputs.dir snippetsDir
    useJUnitPlatform()
}


tasks.named('asciidoctor') {
    inputs.dir snippetsDir
    // 	asciidoctorExt확장 에 대한 구성 사용을 구성
    configurations 'asciidoctorExt'
    dependsOn test
}

tasks.named('bootJar') {
    dependsOn asciidoctor
    // 생성된 문서를 jar static/docs디렉토리에 복사
    copy {
        from "${asciidoctor.outputDir}"
        into 'src/main/resources/static/docs'
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

[ 테스트 클래스 ]

AcceptanceTest

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@ExtendWith({RestDocumentationExtension.class, SpringExtension.class})
public class AcceptanceTest {

    @LocalServerPort
    int port;

    protected RequestSpecification spec;

    @BeforeEach
    public void setUp(RestDocumentationContextProvider restDocumentation) {
        RestAssured.port = port;
        this.spec = new RequestSpecBuilder()
                .addFilter(documentationConfiguration(restDocumentation))
                .build();
    }

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

OrderRestControllerTest

class OrderRestControllerTest extends AcceptanceTest {

    @Test
    void postOrder() {
        // given
        String menuName = "메뉴";

        // when
        ExtractableResponse<Response> response = 주문_생성_요청(menuName, 2);
        OrderModel order = response.as(OrderModel.class);

        // then
        assertThat(response.statusCode()).isEqualTo(HttpStatus.OK.value());
        assertThat(order.getMenuName()).isEqualTo(menuName);
    }

    private ExtractableResponse<Response> 주문_생성_요청(String menuName, Integer quantity) {
        OrderPostRequestDTO dto = new OrderPostRequestDTO(menuName, quantity);

        return RestAssured
                .given(this.spec).log().all()
                .accept(APPLICATION_JSON_VALUE)
                .filter(document("post-order",
                        requestFields(
                                fieldWithPath("order.menuName").type(STRING).description("order menu name"),
                                fieldWithPath("order.quantity").type(NUMBER).description("order quantity")),
                        responseFields(
                                fieldWithPath("order.menuName").type(STRING).description("order menu name"),
                                fieldWithPath("order.quantity").type(NUMBER).description("order quantity"))
                ))
                
                .body(dto)
                .contentType(APPLICATION_JSON_VALUE)
                .when().post("/orders")
                .then().log().all()
                .extract();
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

[ adoc 문서 작성 ]

common.adoc

[[index]]
=== link:./index-docs.html[HOME]

[[common]]
== Common API Docs

=== HTTP Status Code
[cols="2,3,5"]
|===
| Code | Description | Constraint

| 200
| Success
|

| 400
| Bad Request
|
|===

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

order.adoc

= Order API
:doctype: book
:icons: font
:source-highlighter: highlightjs
:toc: left
:toclevels: 3
:sectlinks:

include::{docfile}/../common.adoc[]

== Order API Docs

=== POST /orders
Curl Request
include::{snippets}/post-order/curl-request.adoc[]

Request Headers

Path Parameters

Request Parameters

Request Fields
include::{snippets}/post-order/request-fields.adoc[]

Response Fields
include::{snippets}/post-order/response-fields.adoc[]

HTTP Request
include::{snippets}/post-order/http-request.adoc[]

HTTP Response
include::{snippets}/post-order/http-response.adoc[]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 1205 - Caffeine Cache

# Caffeine vs EhCache

Ehcache는 multi-level 캐시, distributed 캐시, 캐시 리스너 등과 같은 많은 기능을 지원한다.
Caffeine은 Ehcache보다 캐시의 성능이 높으며, 실제로 더 우수한 캐시 제거 전략을 사용한다.(Window TinyLfu 퇴출 정책을 사용, 거의 최적의 적중률을 제공)

# Caffeine 기능

# [ Population Strategy ]

캐시 추가 전략

Caffeine Cache는 아래의 세가지 타입의 캐시로 제작하여 사용할 수 있다.

Manual

Cache<K, V> cache = Caffeine.newBuilder().build()

엔트리를 자동 로드하는 캐시를 생성.

Loading (Synchronously)

LoadingCache<K, V> cache = Caffeine.newBuilder().build(CacheLoader<> loader)

동기 방식으로 loader를 통해 캐시 생성한다.

Asynchronous Loading

AsyncLoadingCache<K, V> cache = Caffeine.newBuilder().buildAsync( ... );

비동기 방식으로 loader를 통해 캐시 생성한다.

# [ Eviction ]

Caffeine Cache는 아래의 세가지 타입으로 캐시를 Evict하는 설정을 할 수 있다.

Size-based

Caffeine.newBuilder().maximumSize(long)

크기 기준으로 캐시를 제거하는 방식은 개발자가 설정한 특정 값을 기준으로, entries의 크기가 그 값을 넘을 떄 entries의 일부분을 제거한다.(Window TinyLfu를 적용하여 가장 최근에 사용되지 않았거나, 자주 사용되어지지 않은 것을 제거)

Time-based

Caffeine.newBuilder().expireAfterAccess(long)
Caffeine.newBuilder().expireAfterWrite(long[, TimeUnit])
Caffeine.newBuilder().expireAfter(Expiry)

expireAfterAccess : (캐시 생성 이후) 해당 값이 가장 최근에 대체되거나 마지막으로 읽은 후 특정 기간이 지나면 각 항목이 캐시에서 자동으로 제거되도록 지정한다.
expireAfterWrite : 캐시 생성 후 또는 가장 최근에 바뀐 후 특정 기간이 지나면 각 항목이 캐시에서 자동으로 제거되도록 지정한다.
expireAfter : 캐시가 생성되거나 마지막으로 업데이트된 후 지정된 시간 간격으로 캐시를 새로 고침한다.

Reference-based

Caffeine.newBuilder().weakKeys().weakValues()
Caffeine.newBuilder().softValues()

Caffeine.weakKeys(), Caffeine.weakValues() : Week References를 사용하여 키를 저장한다. Week References는 키에 대한 다른 강력한 참조(Strong References)가 없는 경우 가비지 수집할 수 있다. 가비지 수집은 identity에만 의존하므로 전체 캐시가 동등성(.equals()) 대신 identity 동일성(==)을 사용하여 키를 비교한다.
Caffeine.softValues() : Soft References를 사용하여 값을 저장한다. Soft References 오브젝트는 메모리 수요에 따라 least-recently-used 방식으로 가비지가 수집된다. 소프트 레퍼런스를 사용하면 퍼포먼스가 영향을 받기 때문에 일반적으로 예측 가능한 최대 캐시 크기를 사용하는 것이 좋다. softValues()를 사용하면 Week References와 마찬가지로 값이 equals 대신 identity(==) equality를 사용하여 비교된다.

# [ Notification of Removal ]

제거되는 캐시 엔트리에 대해 리스너를 달아 추가적인 작업을 할 수 있다.

Caffeine.newBuilder()
.evictionListener((K, V, RemovalCause) -> { /* ... / })
.removalListener((K, V, RemovalCause) -> { / ... */ })
.build();

두 리스너의 차이는 캐시 관련 용어를 이해하면 적절히 사용할 수 있다.

Eviction : 캐시 정책 Policy에 의한 삭제
Invalidation : Caller에 의한 수동 삭제
Removal : invalidation과 eviction, 두 가지를 모두 포함

ex)

Cache<Key, Graph> graphs = Caffeine.newBuilder()
    .evictionListener((Key key, Graph graph, RemovalCause cause) ->
        System.out.printf("Key %s was evicted (%s)%n", key, cause))
    .removalListener((Key key, Graph graph, RemovalCause cause) ->
        System.out.printf("Key %s was removed (%s)%n", key, cause))
    .build();

1
2
3
4
5
6

# [ Compute ]

외부 데이터(리소스)에 접근하며 캐시를 쓸 수 있다.

graphs.asMap().compute(key, (k, v) -> { /* ... */ });

불러온 캐시 데이터를 Map으로 변경한 후 키를 차례로 조작할 수 있다.

graphs.asMap().compute(key, (k, v) -> {
  Graph graph = createExpensiveGraph(key);
  ... // update a secondary store
  return graph;
});

map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

1
2
3
4
5
6
7

# [ Statistics ]

캐시 액세스 통계 정보를 제공한다. 통계 정보를 사용하면 Caffeine.recordStats()를 설정해주면 된다.

Cache.stats() 메소드가 CacheStats를 반환해준다. CacheStats는 아래와 같은 내용을 가진다.

public final class CacheStats {

    // ... 
    private final long hitCount;
    private final long missCount;
    private final long loadSuccessCount;
    private final long loadFailureCount;
    private final long totalLoadTime;
    private final long evictionCount;
    private final long evictionWeight;
    // ... 
    public double hitRate() {/* ... */}
    public long evictionCount() {/* ... */}
    public double averageLoadPenalty() {/* ... */}
    // ... 
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# Caffeine Configuration

dependency

<dependency>
  <groupId>com.github.ben-manes.caffeine</groupId>
  <artifactId>caffeine</artifactId>
  <version>3.0.6</version>
</dependency>

1
2
3
4
5

spring:
  cache:
    caffeine:
      spec: maximumSize=500,expireAfterWrite=5s
    type: caffeine
    cache-names:
      - users
      - books

1
2
3
4
5
6
7
8

@configuration

@Configuration
@EnableCaching
public class CaffeineCacheConfig { /* ... */ }

1
2
3

ex)

@EnableCaching
@Configuration
public class CacheConfig {

    @Bean
    public Caffeine caffeineConfig() {
        return Caffeine
                .newBuilder()
                .maximumSize(10_000)
                .expireAfterWrite(60, TimeUnit.MINUTES);
    }

    @Bean
    public CacheManager cacheManager(Caffeine caffeine) {
        CaffeineCacheManager cacheManager = new CaffeineCacheManager();
        cacheManager.setCaffeine(caffeine);
        return cacheManager;
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 1209 - Java 17

2021년 9월 출시
LTS(Long Term Support)
- 2018년에 등장한 11버전 이후의 새로운 LTS버전
  - (Java 8의 종료 일정(EOL, End of Life)이 Java 11보다 뒤다)

# JDK 17 Release Notes

# [ JEP 356: Enhanced Pseudo-Random Number Generators ]

기본 레거시 랜덤(Java.util.Random) 클래스를 확장, 리팩토링한 RandomGenerator 난수 생성 API가 추가 되었다. 아래와 같은 코드로 자바 17에서 사용 가능한 알고리즘을 확인할 수 있다.

RandomGeneratorFactory.all()
	.map(factory -> String.format("%s: %s", factory.group(), factory.name()))
	.sorted()
	.forEach(System.out::println);

1
2
3
4

LXM: L128X1024MixRandom
LXM: L128X128MixRandom
LXM: L128X256MixRandom
LXM: L32X64MixRandom
LXM: L64X1024MixRandom
LXM: L64X128MixRandom
LXM: L64X128StarStarRandom
LXM: L64X256MixRandom
Legacy: Random
Legacy: SecureRandom
Legacy: SplittableRandom
Xoroshiro: Xoroshiro128PlusPlus
Xoshiro: Xoshiro256PlusPlus

1
2
3
4
5
6
7
8
9
10
11
12
13

# [ JEP 382: New macOS Rendering Pipeline ]

애플사에서 기존의 OpenGL이 아닌 Metal 이라는 새로운 렌더링 API로 대체하는 움직임에 맞춘 대응이다. 향후 MacOS 버전에서 OpenGL API를 제거하는 경우를 대비하기 위함이다. 코드 사용과 직접적인 관련은 없겠으나, MacOS에서 인텔리제이 IDE의 렌더링이 개선되지 않을까 하는 기대가 있다.

# [ JEP 398: Deprecate the Applet API for Removal ]

애플릿(Applet) API는 자바 9에서부터 이미 @Deprecated 선언되었는데, 이번 버전에서는 forRemoval 태깅도 선언되었다.

@Deprecated(since = "9", forRemoval = true)
@SuppressWarnings("removal")
public class Applet extends Panel {
	// ...
}

1
2
3
4
5

# [ JEP 403: Strongly Encapsulate JDK Internals ]

중요한 내부 API를 제외하고는 JDK의 모든 내부 요소를 강력하게 캡슐화한다. 아래와 같은 리플렉션 코드가 더 이상 동작하지 않는다.

var ks = java.security.KeyStore.getInstance("jceks");
var f = ks.getClass().getDeclaredField("keyStoreSpi");
f.setAccessible(true);

1
2
3

# [ JEP 406: Pattern Matching for switch (Preview) ]

자바 14부터 등장했던 내용인데 아직까지 프리뷰(Preview) 기능이다. 실행하려면 명령어 옵션 추가가 필요하다. (Intellij에서는 Language Level 설정을 변경하면 된다.)

아래 예시처럼 instanceof를 사용할 때 캐스팅하는 단계를 간소화할 수 있다.

// AS-IS: 기존의 instanceof 연산자 사용. 캐스팅이 들어간다.
if (o instanceof String) {
    String s = (String) str;
    // ... 변수 s를 사용하는 코드
}

// TO-BE: 형변환 과정을 없애고, 그 변수('s')를 담을 수 있다.
if (o instanceof String s) {
    // ... 변수 s를 사용하는 코드
}

1
2
3
4
5
6
7
8
9
10

그리고 null에 대해서도 조금 더 간편하게 핸들링할 수 있다.

// 기존
static void someMethod(String s) {
    if (s == null) {
        System.out.println("null!");
        return;
    }

    switch (s) {
        case "kim", "taeng" -> System.out.println("Hello~");
        default -> System.out.println("Wow!");
    }
}

// 변경
static void someMethod(String s) {
    switch (s) {
        case null -> System.out.println("null!");
        case "kim", "taeng" -> System.out.println("Hello~");
        default -> System.out.println("Wow!");
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

더 나아가 switch문을 위한 패턴 매칭을 적용할 수 있다. 아래와 같은 형태의 switch코드를 작성할 수 있는데, 파라미터 o값은 Long l에 매칭되어 코드가 실행된다.

Object o = 123L;
String formatted = switch (o) {
    case Integer i -> String.format("int %d", i);
    case Long l -> String.format("long %d", l);
    case Double d -> String.format("double %f", d);
    case String s -> String.format("String %s", s);
    default -> o.toString();
};

1
2
3
4
5
6
7
8

# [ JEP 407: Remove RMI Activation ]

RMI 일부 기능(java.rmi.activation 패키지)이 제거됨.

# [ JEP 409: Sealed Classes ]

자바에서는 상속을 통해서 코드를 재사용할 수 있찌만 너무 부분별한 상속은 코드를 이해하는데 더 어려움을 줄 수 있다. 따라서 상속을 일부 제한하는 방법이 제안되었다. JEP 스펙 문서를 보면 알 수 있듯이 새로운 패러다임이기 때문에 조금 복잡하다. 내용 또한 여러 버전에 거쳐서 Preview로 소개 되었다,

핵심은 "확장(extends) 하거나 구현(implements) 할 수 있는 클래스 또는 인터페이스를 제한한다."라고 생각 하면 된다. 보통 우리 말로는 봉인 클래스 또는 봉인된 클래스로 표기한다. 이제 상속, 구현에 이은 봉인이라는 단어도 사용될거라 예측.

기존에는 상속을 제한하는 방법은 final 키워드를 통해서 사용.

class Person {
}

// `Developer` 클래스는 확장/상속(extends)할 수 없다.
final class Developer extends Person {
}

// `Designer` 클래스는 확장/상속(extends)할 수 없다.
final class Designer extends Person {
}

1
2
3
4
5
6
7
8
9
10

이번에는 다른 컨셉으로, 특정 서브 클래스에게만 확장을 허용하고 다른 클래스에는 봉인(sealed)하는 방법.

// `Person`는 허용된(permits) 서브 클래스만 확장할 수 있다.
sealed class Person
    permits Developer, Designer {
}

// `Developer` 클래스는 봉인이 해제되었다.
non-sealed class Developer extends Person {

}

// 봉인이 해제된 `Student` 클래스는 다른 서브 클래스에서 확장 가능하다.
// 그리고 자기 자신을 Developer 봉인(sealed)할 수 있다. 
sealed class Student extends Developer 
    permits HighSchoolStudent, MiddleSchoolStudent {
    // 이 클래스는 `HighSchoolStudent`, `MiddleSchoolStudent` 클래스만 확장 가능하다.
}

// permitted 서브 클래스는 확장을 못하게 하거나(final),
// 서브 클래스를 가진채로 자신을 봉인하거나(sealed), 봉인을 해제(non-sealed)해야만 한다.
final class HighSchoolStudent extends Student {

}

non-sealed class MiddleSchoolStudent extends Student {

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

봉인 클래스를 사용하려면 아래와 같은 몇가지 규칙이 있다.

sealed 클래스와 permitted된 서브 클래스와 동일한 모듈 또는 패키지에 속해야한다.
모든 permitted 서브 클래스는 sealed 클래스를 확장(extends)해야 한다. 그렇지 않으면 컴파일 오류가 발생한다.
모든 permitted 서브 클래스는 수퍼 클래스에 의해 시작된 봉인을 계속할지 말지 선언해야한다.
- 더이상 확장되지 않도록 final을 적용할 수 있다.
- non-sealed로 선언하여 다른 클래스가 확장하도록 할 수 있다.
- 자기 자신도 봉인(sealed) 클래스로 선언될 수 있다.

# [ JEP 410: Remove the Experimental AOT and JIT Compiler ]

AOT(Ahead-Of-Time), JIT(Just-In-Time) 컴파일러가 제거되었다. 대상은 jdk.aot, jdk.internal.vm.compilerm, jdk.internal.vm.compiler.management 이다.

# [ JEP 411: Deprecate the Security Manager for Removal ]

java.lang.SecurityManager와 일부 클래스에 @Deprecated(forRemoval=true)가 선언됨.

자바 14버전 Preview 중 몇 가지가 정식 반영

# [ JEP 359: Records ]

record는 자바 16에서 스펙이 확정되어 정식 추가됨.

record RecordPoint(int x, int y) {
    // 상속 불가(final 클래스)

    // 각 필드는 private final. 수정 불가
    // x = 5;

    // serialize 할 때는? 필드에 `@JsonProperty`를 붙여준다.

    // static 필드와 메서드 소유 가능
    static int MAX_LENGTH = 25;

    public static int getMaxLength() {
        return MAX_LENGTH;
    }
}

// 사용할 때는? 클래스와 동일하게 `new` 연산자로 인스턴스화한다.
RecordPoint recordPoint = new RecordPoint(2, 3);

// 그런데 getter가 자동 생성!
recordPoint.x();

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# [ JEP 378: Text Blocks ]

JDK 15에 정식 포함.

private void runJEP368() {
    String html = """
            {
                "list": [
                    {
                        "title": "hello, taeng",
                        "author": "taeng"
                    },
                    {
                        "title": "hello, news",
                        "author": "taeng"
                    }
                ]
            }
            """.indent(2);
    // indent 는 자바 12에서 추가된 것인데, 문자열 각 맨 앞 행을 n만큼 띄운다.
    System.out.println(html);
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

변수 매핑

String textBlock = """
        {
            "title": %s,
            "author": %s,
            "id": %d
        }
        """.formatted("hi", "taeng", 2);

System.out.println(textBlock);

1
2
3
4
5
6
7
8
9

1114 ~ 1127 1212 ~ 0101