APT-sid (märkuste töötlemise tööriistu) kasutatakse lähtekoodifailide annotatsioonide töötlemiseks ja lisakoodi genereerimiseks nende annotatsioonide põhjal. Selles artiklis käsitleme APT installimist ja kasutamist Javas. Samuti anname koodi samm-sammult selgituse ja süveneme APT juurutamisega seotud seotud teekidesse ja funktsioonidesse.
APT installimine
Eeltingimusena peab teil olema teie süsteemi installitud Java arenduskomplekt (JDK). Kui olete JDK installinud, võite hakata kasutama APT-d, kuna see on JDK-ga komplektis, täpsemalt JDK 5 ja sellele järgnevad versioonid. Kui teie süsteem on juba JDK-ga konfigureeritud, võite jätkata järgmise jaotisega, et saada teavet APT kasutamise kohta oma Java-projektides.
APT kasutamine Javas
APT kasutamise mõistmiseks Javas vaatame läbi kohandatud märkuste protsessori loomise. See hõlmab kolme peamist sammu:
1. Looge märkus
2. Loo annotatsiooni jaoks protsessor
3. Kasutage annotatsiooni Java klassis
// Step 1: Create an annotation
import java.lang.annotation.*;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.SOURCE)
public @interface CustomAnnotation {
String value() default "Default value";
}
Siin lõime vaikeväärtusega uue märkuse nimega "CustomAnnotation".
// Step 2: Create a processor for the annotation
import javax.annotation.processing.*;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.TypeElement;
@SupportedAnnotationTypes("CustomAnnotation")
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class CustomAnnotationProcessor extends AbstractProcessor {
@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
// Process the annotations
}
}
See kohandatud protsessor laiendab klassi "AbstractProcessor" paketis "javax.annotation.processing" ja töötleb "CustomAnnotation". Protsessi meetod on koht, kus kirjutatakse märkuste põhjal loodud kood.
// Step 3: Use the annotation in a Java class
@CustomAnnotation(value = "Sample value")
public class AnnotatedClass {
// Class implementation
}
Siin kasutatakse annotatsiooni kohandatud väärtusega Java klassis nimega "AnnotatedClass".
Seotud raamatukogud ja funktsioonid
Java programmeerimiskeele märkused
- javadoc: Javadoc on Java jaoks standardne dokumentatsioonigeneraator. Seda saab konfigureerida kasutama kohandatud doklete, mis on sarnased annotatsiooniprotsessoritega.
- JSR 269: Java keele spetsifikatsioon sisaldab standardset API-liidest märkuste töötlemiseks (JSR 269), mis võimaldab Java arendajatel annotatsioonidega programmiliselt suhelda.
- Google Auto: avatud lähtekoodiga teekide kogum märkmete töötlejate juurutamiseks ja koodi genereerimiseks kompileerimise ajal.
APT-ga seotud funktsioonid
- AbstractProcessor: põhiklass kohandatud annotatsiooniprotsessorite kirjutamiseks, mis tuleb konkreetsete märkuste töötlemise loogika rakendamiseks alistada.
- Sõnumid: JSR 269 pakutav utiliidiklass vigadest, hoiatustest ja muudest teadetest teavitamiseks annotatsiooni töötlemise ajal.
- Fail: JSR 269 utiliidiklass uute lähte-, klassi- või abifailide loomiseks loodud koodi või metaandmete salvestamiseks.
Kokkuvõtteks võib öelda, et APT kasutamine Java projektides võimaldab arendajatel kasutada annotatsioonide võimsust koodi genereerimiseks ja analüüsimiseks, parandades projekti hooldatavust ja loetavust. Selles artiklis mainitud tööriistade ja teekide abil saavad arendajad luua kohandatud märkuste protsessoreid, mis vastavad nende konkreetsetele nõuetele.