інтерфейс:
Взагалі інтерфейс виставляє контракт, не розкриваючи основні деталі реалізації. В об'єктно-орієнтованому програмуванні інтерфейси визначають абстрактні типи, які викривають поведінку, але не містять логіки. Реалізація визначається класом або типом, який реалізує інтерфейс.
@interface: (тип анотації)
Візьмемо нижченаведений приклад, який має багато коментарів:
public class Generation3List extends Generation2List {
// Author: John Doe
// Date: 3/17/2002
// Current revision: 6
// Last modified: 4/12/2004
// By: Jane Doe
// Reviewers: Alice, Bill, Cindy
// class code goes here
}
Замість цього можна оголосити тип анотації
@interface ClassPreamble {
String author();
String date();
int currentRevision() default 1;
String lastModified() default "N/A";
String lastModifiedBy() default "N/A";
// Note use of array
String[] reviewers();
}
який потім може коментувати клас таким чином:
@ClassPreamble (
author = "John Doe",
date = "3/17/2002",
currentRevision = 6,
lastModified = "4/12/2004",
lastModifiedBy = "Jane Doe",
// Note array notation
reviewers = {"Alice", "Bob", "Cindy"}
)
public class Generation3List extends Generation2List {
// class code goes here
}
PS:
Багато приміток замінюють коментарі в коді.
Довідка: http://docs.oracle.com/javase/tutorial/java/annotations/declaring.html