<aside> 📌 우리는 최초로 API를 만들어 보았습니다. GET API를 만들기 위해 사용했던 어노테이션에 익숙하지 않다면 자바 어노테이션에 대해서 몇 가지 블로그 글을 찾아보세요! 다음 질문을 생각하며 공부해보면 좋습니다! 😊

[질문]

• 어노테이션을 사용하는 이유 (효과) 는 무엇일까?
• 나만의 어노테이션은 어떻게 만들 수 있을까? </aside>

어노테이션(Annotation)이란?

• 사전적으로 주석을 의미함
• 자바의 어노테이션
  • @를 붙여서 사용함
  • 소스코드에 추가해서 사용할 수 있는 일종의 메타 데이터
  • 코드 사이의 특별한 의미, 기능을 수행하도록 하는 기술
  • 어노테이션은 코드의 동작에 직접적인 영향을 미치지 않음

자바의 대표적인 어노테이션 3가지

• @Override

  • 상위 클래스 또는 인터페이스의 메소드를 오버라이드함을 나타냄
  • @Override가 붙은 메소드가 상위 클래스에서 선언된 메소드를 오버라이딩 하는지 확인 ⇒ 오버라이딩 하지 않으면 컴파일 오류 발생

  public class Animal {
      public void display() {
          System.out.println("I am an animal");
      }
  }
  
  public class Dog extends Animal {
      @Override
      public void display() {
          System.out.println("I am a dog");
      }
  }
  

  ---

• @Deprecated

  • 어떤 메소드나 클래스, 필드가 더 이상 사용되지 않고 향후 버전에서 제거될 가능성이 있음을 나타냄
  • @Deprecated가 붙은 요소를 사용 ⇒ 컴파일 경고 발생

  public class Utility {
      @Deprecated
      public void deprecatedMethod() {
          System.out.println("This method is deprecated");
      }
  }
  

  ---

• @SuppressWarnings

  • 컴파일러가 특정 경고 메시지를 무시하도록 지시하는 어노테이션
  • 개발자가 경고를 인지하고 있으나, 특정 이유로 인해 경고를 숨기고 싶을 때 사용됨

     @SuppressWarnings("deprecation")
     public void useDeprecatedMethod() {
          // deprecation warning
          // - suppressed
          objectOne.deprecatedMethod();
      }
  

어노테이션을 사용하는 이유(효과)는 무엇일까?

• 다음과 같은 기능을 제공하여 프로그래밍의 효율성과 정확성을 높이기 때문

  • 컴파일러에게 코드 작성 문법 에러를 체크하도록 정보 제공
  • 소프트웨어 개발 툴이 빌드나 배치 시, 코드를 자동으로 생성할 수 있도록 정보 제공
  • 실행 시(런타임 시), 특정 기능을 실행하도록 정보 제공

• 컴파일러에게 코드 작성 문법 에러를 체크하도록 정보를 제공하는 예시 (@Override)

  • 상위 클래스

    public class AnnotationTest{
    
        public int addTwoNumbers(int number1, int number2) {
            return number1 + number2;
        }
    }
    

  • 하위 클래스

    public class AnnotationTestImpl extends AnnotationTest {
    
        @Override
        public int addTwoNumbers(int number1, int number2) {
            return super.addTwoNumbers(number1, number2);
        }
    }
    

    ---

  • [하위 클래스 수정(오버라이딩 X)]

    public class AnnotationTestImpl extends AnnotationTest {
    		// method does not override or implement a method from a supertype 오류 발생
        @Override
        public int addTwoNumbers(int number1) {
            return number1;
        }
    }
    

    @Override를 사용하였으나, 상위 클래스의 메소드를 오버라이딩하지 않는 경우 ⇒ 컴파일 오류 발생 (오류 내용 :method does not override or implement a method from a supertype)

    <실행 결과>