Prefer annotations to naming patterns

최근 Effective Java 2nd Edition 을 읽 고 있 습 니 다.그 중 ITEM 35:PREFER ANNOTATIONS TO NAMING PATTERNS,즉 annotations 로 과거 이름 모드 를 사용 하 는 습관 을 대체 하고 코드 를 올 립 니 다.
 

// Annotation type with a parameter
import java.lang.annotation.*;

/**
 * Indicates that the annotated method is a test method that must throw the
 * designated exception to succeed.
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface ExceptionTest {
	Class<? extends Exception> value();
}



// Program containing annotations with a parameter
public class Sample2 {
	@ExceptionTest(ArithmeticException.class)
	public static void m1() { // Test should pass
		int i = 0;
		i = i / i;
	}

	@ExceptionTest(ArithmeticException.class)
	public static void m2() { // Should fail (wrong exception)
		int[] a = new int[0];
		int i = a[1];
	}

	@ExceptionTest(ArithmeticException.class)
	public static void m3() {
	} // Should fail (no exception)
}



// Program to process marker annotations
import java.lang.reflect.*;

public class RunTests {
	public static void main(String[] args) throws Exception {
		int tests = 0;
		int passed = 0;
		Class<?> testClass = Class.forName("Sample2");
		for (Method m : testClass.getDeclaredMethods()) {
			if (m.isAnnotationPresent(ExceptionTest.class)) {
				tests++;
				try {
					m.invoke(null);
					System.out.printf("Test %s failed: no exception%n", m);
				} catch (InvocationTargetException wrappedEx) {
					Throwable exc = wrappedEx.getCause();
					Class<? extends Exception> excType = m.getAnnotation(ExceptionTest.class).value();
					// note the value is ArithmeticException.class
					// and test if the caused exception is the instance of the excType
					if (excType.isInstance(exc)) {
						passed++;
					} else {
						System.out.printf("Test %s failed: expected %s, got %s%n", m, excType.getName(), exc);
					}
				} catch (Exception exc) {
					System.out.println("INVALID @Test: " + m);
				}
			}
		}
		System.out.printf("Passed: %d, Failed: %d%n", passed, tests - passed);
	}
}

 
ExceptionTest 는 참조 가 있 는 annotation 입 니 다.
테스트 클래스 RunTests 는 주로 Sample 2 클래스 중 어떤 방법 으로 annotation 매개 변 수 를 통 해 지정 한 이상 을 던 지 는 지 테스트 합 니 다.그렇지 않 으 면 failed 입 니 다.
결 과 는 다음 과 같다.
 
Test public static void Sample2.m2() failed: expected java.lang.ArithmeticException, got java.lang.ArrayIndexOutOfBoundsException: 1 Test public static void Sample2.m3() failed: no exception Passed: 1, Failed: 2