Какую функцию выполняют эти аннотации Java?

Question

Я все еще не понимаю цели аннотации в Java. Первоначально я думал, что они просто служили документацией. Но, глядя на эту документацию от Google App Engine Datastore, я не уверен. @PersistenceCapable (identityType = IdentityType.APPLICATION) больше похож на подпись метода.

Какова цель этого аннотации? Что оно делает?

import java.util.Date; 
import javax.jdo.annotations.IdGeneratorStrategy; 
import javax.jdo.annotations.IdentityType; 
import javax.jdo.annotations.PersistenceCapable; 
import javax.jdo.annotations.Persistent; 
import javax.jdo.annotations.PrimaryKey; 

@PersistenceCapable(identityType = IdentityType.APPLICATION) 
public class Employee { 
    @PrimaryKey 
    @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) 
    private Long id; 

    @Persistent 
    private String firstName; 

    @Persistent 
    private String lastName; 

    @Persistent 
    private Date hireDate; 

    public Employee(String firstName, String lastName, Date hireDate) { 
     this.firstName = firstName; 
     this.lastName = lastName; 
     this.hireDate = hireDate; 
    } 

    // Accessors for the fields. JDO doesn't use these, but your application does. 

    public Long getId() { 
     return id; 
    } 

    public String getFirstName() { 
     return firstName; 
    } 

    // ... other accessors... 
} 

Answer 1

Это метаданные исходного уровня. Это способ добавления информации к коду, который не является кодом, и который легко обрабатывается машиной.

В вашем примере они используются для настройки объектно-реляционного сопоставления для этого типа сущности. Это говорит о том, что, например, поле id должно быть основным ключом для этого объекта, и что firstName, lastName и hireDate должны храниться в базе данных. (Чтобы указать эти поля отдельно от состояния переходного объекта.)

Поддержка GAE для JDO должна знать, какие объекты вы попытаетесь сохранить в базе данных. Он делает это, просматривая классы в вашем коде, ища те, которые аннотируются с помощью @PersistenceCapable.

Обычно они используются для замены того, где вы использовали внешние файлы конфигурации; стандартная библиотека Java имеет инструменты для чтения аннотаций в вашем коде, что значительно упрощает их обработку, чем развертывание собственной настройки файла конфигурации, и вы получаете бесплатную поддержку IDE.

Answer 2

Я думаю, что они исходят из API Java Data Objects. Это API, который частично совпадает с тем, что должен выполнить EJB3. Те же концепции, различный синтаксис и инструменты.

Если вы не знакомы с аннотациями вообще, проверьте Java tutorial.

Answer 3

Аннотации могут быть обработаны с Annotation Processing Tool APIs автогенерацию шаблонного кода.