Generated — 생성된 코드 표시 어노테이션
Generated — 생성된 코드 표시 어노테이션
Generated는 생성된 소스 코드를 표시하는 데 사용되는 어노테이션 인터페이스예요. 한 파일에서 사용자가 작성한 코드와 생성된 코드를 구분하는 데도 사용할 수 있어요.
본문
@Documented
@Retention(SOURCE)
@Target({PACKAGE, TYPE, METHOD, CONSTRUCTOR, FIELD, LOCAL_VARIABLE, PARAMETER})
public @interface Generated
예시
@Generated("com.example.Generator")
@Generated(value = "com.example.Generator",
date = "2017-07-04T12:08:56.235-0700")
@Generated(value = "com.example.Generator",
date = "2017-07-04T12:08:56.235-0700",
comments = "comment 1")
필수 요소
String[] value— 이 요소는 코드 생성기의 이름을 가져야 해요. 이름은 코드 생성기의 완전한 이름(fully qualified name)이에요.
선택 요소
String date— 소스가 생성된 날짜예요.date요소는 ISO 8601 표준을 따라야 해요. 예를 들어2017-07-04T12:08:56.235-0700은 미국 태평양 표준시 시간대의 2017-07-04 12:08:56 현지 시간을 나타내요. 기본값은""이에요.String comments— 코드 생성기가 생성된 코드에 포함하고 싶은 주석을 위한 자리 표시자예요. 기본값은""이에요.
특징
@Retention(SOURCE)이므로 소스 코드에만 존재하고 바이트코드·런타임에는 남지 않아요. 코드 생성 도구가 생성했다는 표시를 남겨서, IDE나 개발자가 사람이 작성한 코드와 자동 생성 코드를 구분할 수 있게 해줘요. value에 생성기 이름을 꼭 넣어야 해요.