[Java] 12. java.base 모듈 (6) - 11, 12

12.11 리플렉션

    - 자바는 클래스와 인터페이스의 메타 정보(패키지 정보, 타입 정보, 멤버 정보 등)를 Class 객체로 관리함

    -> 리플렉션(reflection) : 이러한 메타 정보를 프로그램에서 읽고 수정하는 행위

    * 프로그램에서 Class 객체를 얻는 방법 - 셋 중 어느 방법을 사용하더라도 동일한 Class 객체 얻음
        1) Class clazz = 클래스이름.class;                                    //클래스로부터 얻기 1
        2) Class clazz = Class.forName("패키지...클래스이름"); //클래스로부터 얻기 2
        3) Class clazz = 객체참조변수.getClass();                        //객체로부터 얻기

1. 패키지와 타입 정보 얻기

    - 패키지와 타입 (클래스, 인터페이스) 이름 정보를 얻기 위한 메소드

메소드	용도
Package getPackage()	패키지 정보 읽기
String getSimpleName()	패키지를 제외한 타입 이름
String getName()	패키지를 포함한 전체 타입 이름

2. 멤버 정보 얻기

    - 타입(클래스, 인터페이스)가 가지고 있는 멤버 정보를 얻는 메소드 (모두 java.lang.reflect 패키지에 존재)

메소드	용도
Constructor[ ] getDeclaredConstructors()	생성자 정보 읽기
Field[ ] getDeclaredFields()	필드 정보 읽기
Method[ ] getDeclaredMethods()	메소드 정보 읽기

3. 리소스 경로 얻기

    - Class 객체는 클래스 파일(~.class)의 경로 정보를 가지고 있음
        -> 이 경로를 기준으로 상대 경로에 있는 다른 리소스 파일의 정보 얻을 수 있음

메소드	용도
URL getResource(String name)	리소스 파일의 URL 리턴 (경로 정보가 담긴 URL 객체 리턴)
InputStream getResourceAsStream(String name)	리소스 파일의 InputStream 리턴 (파일의 내용을 읽을 수 있도록)

String photo1Path = clazz.getResource("photo1.jpg").getPath();
//C:\...\bin\photo1.jpg

    - getPath() : URL 객체의 메소드로 절대 경로를 리턴함

 

12.12 어노테이션

    - 어노테이션 : 코드에서 @로 작성되는 요소
                        - 클래스 또는 인터페이스를 컴파일하거나 실행할 때 어떻게 처리해야 할 것인지를 알려주는 설정 정보

    1) 컴파일 시 사용하는 정보 전달 (예: @Override - 컴파일러가 메소드 재정의 검사를 하도록 설정함)
    2) 빌드 툴이 코드를 자동으로 생성할 때 사용하는 정보 전달
    3) 실행 시 특정 기능을 처리할 때 사용하는 정보 전달

1. 어노테이션 타입 정의와 적용

    - 어노테이션도 하나의 타입임 -> 어노테이션 사용을 위해서는 먼저 정의부터 해야 함
       (인터페이스 정의와 유사함 - @interface  뒤에 사용할 어노테이션 이름이 온다)

public @interface AnnotationName {

}

@AnnotationName

    - 어노테이션은 속성을 가질 수 있음 : 타입, 이름으로 구성, 이름 뒤에 괄호 붙임

public @interface AnnotationName {
    String prop1();
    int prop2() default 1;
}

@AnnotationName(prop1 = "값");
@AnnotationName(prop1 = "값", prop2 = 3);

    - 어노테이션은 기본 속성인 value를 가질 수 있음
    - 코드에서 사용할 때에는 값만 기술, 그러면 value 속성에 자동으로 대입됨
    - 하지만 value 속성과 다른 속성의 값을 동시에 주고자 할 때에는 속성 이름을 반드시 명시

public @interface AnnotationName {
    String value();
    int prop2() default 1;
}

@AnnotationName("값");

@AnnotationName(value = "값", prop2 = 3);

 

2. 어노테이션 적용 대상

    - ElementType 열거 상수로 정의된, 적용할 수 있는 대상의 종류 (어떤 대상-클래스/메소드 등-에 설정 정보를 적용할 것인지)

ElementType 열거 상수	적용 요소
TYPE	클래스, 인터페이스, 열거 타입
ANNOTATION_TYPE	어노테이션
FIELD	필드
CONSTRUCTOR	생성자
METHOD	메소드
LOCAL_VARIABLE	로컬 변수
PACKAGE	패키지

    - @Target 어노테이션 : 적용 대상을 지정할 때 사용
        - 기본 속성 value는 ElementType 배열을 값으로 가짐 : 적용 대상을 복수 개로 지정하기 위해!

@Target ( {ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
//클래스, 필드, 메소드에 적용 가능
//생성자에는 적용 불가능 - @Target에 CONSTRUCTOR가 없으므로!
public @interface AnnotationName {
}

@AnnotationName //클래스에 적용
public class ClassName {
    @AnnotationName //필드에 적용
    private String fieldName;
    
    //@AnnotationName - 불가능
    public ClassName() {}
    
    @AnnotationName //메소드에 적용
    public void methodName() {}
}

3. 어노테이션 유지 정책

    - @AnnotationName을 언제까지 유지할 것인가
    - @Retention 어노테이션을 사용해 유지 정책을 지정함
        - 기본 속성인 value는 RetentionPolicy 열거 상수 값을 가짐

RetentionPolicy 열거 상수	어노테이션 적용 시점	어노테이션 제거 시점
SOURCE	컴파일할 때 적용	컴파일한 후에 제거됨
CLASS	메모리로 로딩할 때 적용	메모리로 로딩된 후에 제거됨
RUNTIME	실행할 때 적용	계속 유지됨

@Target ( {ElementType.TYPE, ElementType.FIELD, ElementType.METHOD} )
@Retention ( RetentionPolicy.RUNTIME )
public @interface AnnotationName {
}

4. 어노테이션 설정 정보 이용

    - 어노테이션은 아무런 동작을 가지지 않는 설정 정보일 뿐임
        -> 이 설정 정보를 이용해 어떻게 처리할 것인지는 애플리케이션의 몫임!

    - 리플렉션을 이용해 적용 대상으로부터 어노테이션의 정보를 얻어내는 메소드들

리턴 타입	메소드명(매개변수)	설명
boolean	isAnnotationPresent(AnnotationName.class)	지정한 어노테이션이 적용되었는지 여부
Annotation	getAnnotation(AnnotationName.class)	지정한 어노테이션이 적용되어 있음 -> 어노테이션을 리턴 그렇지 않다면 -> null 을 리턴
Annotation[ ]	getDeclaredAnnotations( )	적용된 모든 어노테이션을 리턴

    - 적용 대상을 METHOD, 유지 정책을 RUNTIME으로 하고, 구분선에 대한 설정 정보를 속성으로 가지고 있는 @PrintAnnotation

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target( {ElementType.METHOD} )
@Retention(RetentionPolicy.RUNTIME)
public @interface PrintAnnotation {
    String value() default "-"; //선의 종류
    int number() default 15;    //출력 횟수
}

public class Service {
    @PrintAnnotation
    public void method1() {
        System.out.println("실행 내용 1");
    }
    
    @PrintAnnotation("*")
    public void method2() {
        System.out.println("실행 내용 2");
    }
    
    @PrintAnnotation(value="#", number=20)
    public void method3() {
        System.out.println("실행 내용 3");
    }
}

    - 실행 클래스인 PrintAnnotationExample에서는 Service 클래스에 선언된 메소드를 리플렉션해서 @PrintAnnotation의 설정 정보를 얻어낸 후, 구분선을 출력하고 해당 메소드를 호출시킴

import java.lang.reflect.Method;

public class PrintAnnotationExample {
    public static void main(String[] args) throws Exception {
        Method[] declaredMethods = Service.class.getDeclaredMethods();
        for(Method method : declaredMethods) {
            //PrintAnnotation 얻기
            PrintAnnotation printAnnotation = method.getAnnotation(PrintAnnotation.class);
            
            //설정 정보를 이용해서 선 출력
            printLine(PrintAnnotation);
            
            //메소드 호출
            method.invoke(new Service());
            
            //설정 정보를 이용해서 선 출력
            printLine(printAnnotation);
        }
    }
    
    public static void printLine(PrintAnnotation printAnnotation) {
        if(printAnnotation != null) {
            //number 속성값 얻기
            int number = printAnnotation.number();
            for(int i = 0; i<number; i++) {
                //value 속성값 얻기
                String value = printAnnotation.value();
                System.out.print(value);
            }
            System.out.println();
        }
    }
}

--------------- 실행 내용 1 --------------- ############### 실행 내용 3 ############### *************** 실행 내용 2 ***************

    - Service.class.getDeclaredMethods()로 가져온 메소드 순서 때문에 실행내용 1, 3, 2 이렇게 나옴