Jaką funkcję mają te adnotacje Java?

Question

Nadal nie jestem jasny w sprawie adnotacji w Javie. Początkowo myślałem, że służą tylko jako dokumentacja. Ale patrząc na tę dokumentację z Google App Engine Datastore, nie jestem tego taki pewien. @PersistenceCapable (identityType = IdentityType.APPLICATION) wygląda bardziej jak podpis metody.

Jaki jest cel tego typu adnotacji? Co to robi?

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

Są to metadane poziomu źródła. Są sposobem na dodawanie informacji do kodu, który nie jest kodem, i który jest łatwo obrabiany maszynowo.

W twoim przykładzie są używane do konfigurowania mapowania obiektowo-relacyjnego dla tego typu obiektu. Mówi się, że na przykład pole id powinno być kluczem podstawowym dla tego obiektu, a te firstName, lastName i hireDate powinny być przechowywane w bazie danych. (Aby odróżnić te pola od pewnego przejściowego stanu obiektu.)

Obsługa GAE dla JDO musi wiedzieć, jakie obiekty będziesz próbował przechowywać w bazie danych. Robi to, przeglądając klasy w kodzie, szukając tych, które są oznaczone adnotacją @PersistenceCapable.

Zwykle są one używane do zastępowania wcześniej używanych zewnętrznych plików konfiguracyjnych; standardowa biblioteka Java ma narzędzia do odczytywania adnotacji w kodzie, co znacznie ułatwia ich przetwarzanie niż samodzielne instalowanie plików konfiguracyjnych i zapewnia bezpłatną obsługę IDE.

Answer 2

Myślę, że te pochodzą z interfejsu API Java Data Objects. Jest to API, które w pewnym stopniu pokrywa się z tym, co ma osiągnąć EJB3. Te same pojęcia, inna składnia i narzędzia.

Jeśli nie są zaznajomieni z adnotacji w ogóle, sprawdzić Java tutorial.

Answer 3

adnotacje mogą być przetwarzane z Annotation Processing Tool APIs do automatycznego generowania kodu boilerplate.