Meta Veri (Metadata)

Metadata, kodunuz hakkında ek bilgiler vermek için kullanılır. Bir metadata açıklaması, derleme zamanı sabiti bir referansla başlar (@deprecated gibi) veya bir sabit yapılandırıcısına bir çağrıyla devam eder.

Dört metadata anotasyonu Dart dilinde genel olarak kullanılabilir: @Deprecated, @deprecated, @override ve @pragma. @override kullanımı için örnekler için bir sınıfı genişletme konusuna bakın. İşte @Deprecated anotasyonunun kullanımına dair bir örnek:

class Televizyon {
  /// Gücü açmak için [turnOn] kullanın.
  @Deprecated('turnOn kullanın')
  void etkinlestir() {
    turnOn();
  }

  /// Televizyonun gücünü açar.
  void turnOn() {...}
  // ···
}

@deprecated kullanmak istemiyorsanız bir mesaj belirtmek zorunda değilsiniz. Ancak, her zaman @Deprecated ile bir mesaj belirtmenizi öneririz.

Kendi metadata anotasyonlarınızı tanımlayabilirsiniz. İşte iki argüman alan @Todo anotasyonunu tanımlayan bir örnek:

class Todo {
  final String kim;
  final String ne;

  const Todo(this.kim, this.ne);
}

Ve işte bu @Todo anotasyonunu kullanmanın bir örneği:

@Todo('Dash', 'Bu fonksiyonu implement et')
void birSeyYap() {
  print('Bir şey yap');
}

Metadata, bir kütüphane, sınıf, typedef, tür parametresi, constructor, factory, fonksiyon, alan, parametre veya değişken bildirimi ve bir import veya export direktifi öncesinde görünebilir.