# @Repeatable

`@Repeatable`은 Java 8버전 이후 메타 어노테이션으로, 어노테이션을 반복 적용할 수 있게 한다. Java8 이전에는 반복 적용하고 싶은 어노테이션은 다음과 같이 적용했다.

```java
// case 1
@GreenColor
@BlueColor
@RedColor
public class RGBColor { ... }

// case 2
@Color(colors={"green", "blue", "red"}
public class RGBColor { ... }
```

`@GreenColor`, `@BlueColor`, `@RedColor` 이렇게 각각의 어노테이션을 생성하거나, 배열 매개변수를 받아 구현하였다.

Java 8이후 부터는 `@Repeatable` 어노테이션을 제공해주며, 사용방법은 다음과 같다.

1. Repeatable Annotation 타입을 선언(실 사용할 어노테이션)
   * `@Repeatable`에 Container annotation 전달

     ```java
     @Repeatable(value = Colors.class) // 
     @Retention(RetentionPolicy.RUNTIME)
     public @interface Color {
       String value(); // 
     }
     ```
2. 컨테이너 어노테이션 타입을 포함하여 선언(묶음 값을 관리하는 컨테이너 어노테이션)
   * 컨테이너 어노테이션은 내부 어노테이션을 반환하는 `value()` 메서드를 정의해야한다.

     ```java
     @Target(ElementType.TYPE)
     @Retention(RetentionPolicy.RUNTIME)
     @Documented
     public @interface Colors {
       Color[] value();  
     }
     ```

위와 같이 `@Repeatable` 어노테이션으로 구현하면 다음과 같이 어노테이션을 사용할 수 있다.

```java
@Color("green")
@Color("blue")
@Color("red")
public class RGBColor { ... }
```

이때, 한가지 주의할 점이 있다. 하위 어노테이션(`@Color`)가 한개만 정의된 경우 컨테이너 어노테이션(`@Colors`)로 묶이지 않으므로, 하위 어노테이션(`@Color`)에도 `@Retention(RetentionPolicy.RUNTIME)`를 선언해주어야한다.

## 참고

* <https://jistol.github.io/java/2018/08/31/annotation-repeatable/>
* <https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dahye-jeong.gitbook.io/til/java/advanced/meta-annotation/2021-06-13-repeatable-annotation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.