Zasady retencji i typy celów
Wybieraj retencję SOURCE, CLASS lub RUNTIME i ograniczaj elementy docelowe za pomocą @Target.
Zasady retencji i typy celów to bezpłatna lekcja Java Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Java Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Java Academy zawiera 4 lekcji w sumie.
Trzy polityki przechowywania
SOURCE: odrzucana przez kompilator (przydatna tylko dla APT). CLASS: zapisywana w plikach .class, niedostępna w czasie wykonywania. RUNTIME: dostępna za pośrednictwem refleksji. Większość adnotacji frameworków używa wartości RUNTIME.
Przechowywanie SOURCE: tylko podczas kompilacji
Adnotacje SOURCE są przetwarzane przez procesory adnotacji, a następnie odrzucane. @Override i @SuppressWarnings mają wartość SOURCE — informują kompilator, ale nie znajdują się w pliku .class.
@Retention(RetentionPolicy.SOURCE)
public @interface GenerateBuilder {}
// APT generates a Builder class when it sees @GenerateBuilder
// The annotation itself disappears from the compiled outputPrzechowywanie CLASS: analiza kodu bajtowego
Adnotacje CLASS są umieszczane w plikach .class na potrzeby narzędzi do analizy kodu bajtowego (PMD, FindBugs, ASM), ale NIE można ich odczytać w czasie wykonywania za pomocą refleksji.
@Retention(RetentionPolicy.CLASS)
public @interface ThreadSafe {}
// Visible in bytecode, invisible to Class.getAnnotation() at runtimePrzechowywanie RUNTIME: przetwarzanie refleksyjne
Adnotacje RUNTIME pozostają dostępne w czasie wykonywania i można je odczytywać za pomocą getAnnotation(). Spring, JUnit, Jackson i Hibernate używają przechowywania RUNTIME.
@Retention(RetentionPolicy.RUNTIME)
public @interface Route {
String path();
String method() default "GET";
}
// At runtime:
Route r = handler.getClass().getMethod("handle").getAnnotation(Route.class);
System.out.println(r.path()); // e.g. "/users"@Target: ograniczanie miejsc zastosowania
@Target używa stałych ElementType do ograniczania miejsc, w których może wystąpić adnotacja. Zastosowanie jej do niedozwolonego elementu powoduje błąd podczas kompilacji.
import static java.lang.annotation.ElementType.*;
@Target({METHOD, CONSTRUCTOR})
@Retention(RetentionPolicy.RUNTIME)
public @interface Measured {}Wszystkie wartości ElementType
Pełna lista: TYPE (klasa/interfejs/enum), FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE, PACKAGE, TYPE_PARAMETER (parametr typu generycznego), TYPE_USE (dowolne użycie typu).
// TYPE_USE: annotate any type reference
@NotNull String name;
List<@NonNull String> items;
public @Valid User createUser(@NotNull String name) { ... }TYPE a TYPE_USE
TYPE dotyczy deklaracji klas, interfejsów i typów enum. TYPE_USE (od Java 8) dotyczy dowolnego użycia typu, w tym typów generycznych, rzutowań i klauzul extends — umożliwiając stosowanie adnotacji zapewniających bezpieczeństwo typów pod względem wartości null.
@Target(ElementType.TYPE_USE)
@interface NonNull {}
// Can be applied to:
List<@NonNull String> list;
@NonNull String result = (@NonNull String) obj;Łączenie wartości Target i Retention
Najbardziej użyteczne adnotacje frameworków łączą przechowywanie RUNTIME z określonymi elementami docelowymi. Przykładem jest adnotacja walidacyjna stosowana wyłącznie do pól.
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Range {
int min() default 0;
int max() default Integer.MAX_VALUE;
}Dziedziczenie adnotacji za pomocą @Inherited
@Inherited to metaadnotacja, która powoduje dziedziczenie adnotacji na poziomie klasy przez podklasy. Nie ma wpływu na adnotacje metod ani pól.
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@interface Framework {}
@Framework class Base {}
class Child extends Base {} // @Framework visible on Child too@Documented: umieszczanie w Javadoc
Zastosuj @Documented, aby adnotacja pojawiała się w wygenerowanej dokumentacji Javadoc elementów, do których ją zastosowano. Bez niej adnotacje są niewidoczne w dokumentacji API.
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Auditable {
String description() default "";
}Odczytywanie informacji o przechowywaniu w czasie wykonywania
Można sprawdzić sposób przechowywania samego typu adnotacji za pomocą getAnnotation(Retention.class) na obiekcie klasy adnotacji.
Retention r = Retry.class.getAnnotation(Retention.class);
System.out.println(r.value()); // RUNTIME, CLASS, or SOURCESzybkie sprawdzenie
Który element ElementType obejmuje deklaracje klas, interfejsów i typów enum?
Podsumowanie
Używaj SOURCE dla narzędzi działających podczas kompilacji, CLASS do analizy kodu bajtowego, a RUNTIME dla frameworków korzystających z refleksji. Ograniczaj zastosowanie za pomocą @Target, aby zapobiegać niewłaściwemu użyciu. Dodaj @Documented do adnotacji API, a @Inherited do adnotacji dotyczących hierarchii klas.
Często zadawane pytania
Czy lekcja „Zasady retencji i typy celów” jest bezpłatna?
Tak — pełny tekst „Zasady retencji i typy celów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Java Academy, przejdź na CoddyKit PRO. Kurs Java Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Zasady retencji i typy celów”?
Wybieraj retencję SOURCE, CLASS lub RUNTIME i ograniczaj elementy docelowe za pomocą @Target. Ćwiczysz Java Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Java Academy?
Nie wymagamy żadnego doświadczenia. Java Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.
Ile czasu zajmuje lekcja „Zasady retencji i typy celów”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Java Academy?
Tak. Każda lekcja Java Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Definiowanie adnotacji: elementy i wartości domyślne
- Zasady retencji i typy celów
- Przetwarzanie adnotacji w czasie działania
- Procesory adnotacji w czasie kompilacji