다트] metadata - 메타 데이터

메타 데이터

코드에 추가 정보를 제공하려면 메타데이터를 사용한다.

 

메타데이터 주석은 @ 문자로 시작하고, 컴파일 타임 상수(예: @deprecated)에 대한 참조나 상수 생성자 호출(예: @Deprecated('Use turnOn instead') )이 뒤따른다.

 

모든 Dart 코드에서 사용할 수 있는 네 가지 주석이 있다:

• @Deprecated
• @deprecated
• @override
• @pragma
• @override

 

다음은 @Deprecated 주석을 사용하는 예제다:

class Television {
  /// Use [turnOn] to turn the power on instead.
  @Deprecated('Use turnOn instead')
  void activate() {
    turnOn();
  }

  /// Turns the TV's power on.
  void turnOn() {...}
  // ···
}

 

메시지를 지정하지 않으려면 @deprecated를 사용할 수 있다.  하지만 항상 @Deprecated에 메시지를 지정하는 것을 권장한다.

 

 

 

사용자 정의 메타 데이터

사용자 정의 메타 데이터 주석도 정의할 수 있다. 다음은 두 개의 인수를 받는 @Todo 주석을 정의하는 예제다:

class Todo {
  final String who;
  final String what;

  const Todo(this.who, this.what);
}

그리고 다음은 @Todo 주석을 사용하는 예제다:

@Todo('Dash', 'Implement this function')
void doSomething() {
  print('Do something');
}

 

메타데이터는 라이브러리, 클래스, 타입 정의, 타입 매개변수, 생성자, 팩토리, 함수, 필드, 매개변수, 변수 선언 앞이나 import 또는 export 지시문 앞에 나타날 수 있다.