interface:
Em geral, uma interface expõe um contrato sem expor os detalhes subjacentes da implementação. Na Programação Orientada a Objetos, as interfaces definem tipos abstratos que expõem o comportamento, mas não contêm lógica. A implementação é definida pela classe ou tipo que implementa a interface.
@interface: (tipo de anotação)
Veja o exemplo abaixo, que tem muitos comentários:
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
}
Em vez disso, você pode declarar um tipo de anotação
@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();
}
que pode anotar uma classe da seguinte maneira:
@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:
muitas anotações substituem comentários no código.
Referência: http://docs.oracle.com/javase/tutorial/java/annotations/declaring.html