Hur man använder anteckningar

"Hej, Amigo!"

"Hej, Rishi."

"Idag ska jag ge dig en djupare introduktion till kommentarer."

"Som du säkert redan vet är kommentarer speciella ord som kan sättas bredvid klasser, fält, metoder och variabler."

"Ja. Jag möter dem väldigt ofta."

"Ibland kallas de också för metadata . Deras primära syfte är att lagra specifik ytterligare information om metoder, fält och klasser."

"Vem lagrar de det åt?"

"Det är en väldigt bra fråga."

"Folk skriver kommentarer, vilket betyder att någon måste behöva dem."

"Anteckningar låter dig lagra ytterligare information om koden och programelementen, men formellt sett är de inte en del av koden."

"Anteckningar kan användas för att generera XML, avgöra om en metod är utfasad, spåra buggar, etc."

"Här är ett exempel på annoteringar i kod:"

@CatInfo(manager=Catmanager.class, unique=true)
class Cat
{
 @Name("Missy")
 private String name;

 @SuppressWarnings(value = "unchecked")
 void getUniqueCatName()
 {

 }
}

"Som du kan se kan data lagras i kommentarer."

"Om en anteckning bara har ett fält som heter värde kan fältnamnet utelämnas:"

@SuppressWarnings("unchecked")
void getUniqueCatName()
{

}

"Om det inte finns några parametrar inom parentesen kan de också utelämnas:"

@Override
void getUniqueCatName()
{

}

"Det är superlätt att skapa din egen anteckning. Att deklarera en anteckning är nästan identisk med att deklarera ett gränssnitt."

@interface CatManager
{
 Class manager();
 boolean unique();
 String name() default "Unknown Cat";
}

"Det finns bara ett par skillnader."

"Först sätter du ett «@»-tecken före ordet gränssnitt ."

"För det andra kan en kommentar ha standardvärden. Du använder ordet standard för att ställa in standardvärden . Se exemplet ovan. Dessa parametrar är valfria och kan utelämnas när du lägger till kommentarer."

"Ah. Allt är lättare än jag trodde. Och jag har undvikit dem som att Robo-Djävulen undviker heligt vatten. Det är inte särskilt trevligt när kod har många saker som du inte helt förstår."

"Åh, det är bra att du påminde mig - jag vill berätta mer om kommentarer som används av kompilatorn."

"Det finns bara 3 sådana kommentarer. Tja, tre hittills."

@Föråldrad.

"Du kan kommentera en klass eller en metod med @Föråldrad. Detta kommer att få kompilatorn att utfärda en varning (en varning är inte ett fel), och IntelliJ IDEA kommer att visa denna metod som genomstruken text. Något i stil med detta  :

Date date = new Date();
int year = date.getYear();

@Åsidosätta.

"Det anses vara en bästa praxis att lägga till @Override-kommentaren till metoder som du åsidosätter."

"Vad är det till för? Visar inte IDEA redan om en metod åsidosätts eller inte?"

"Först och främst finns det IDEA och sedan finns det Java-syntax."

"Och för det andra, hypotetiskt, kan du ha en situation där en basklasss metod byter namn utan en motsvarande ändring av metodnamnet i underklassen. Programmet kommer inte att fungera som förväntat, men ingen kommer att märka det. Den här anteckningen uppfanns för att förhindra att dessa situationer inträffar:"

@Override
void getUniqueCatName()
{

}

@SuppressWarnings.

"Ibland visar kompilatorn många varningar. Och ibland känner vi till «problemen» och väljer medvetet att använda motsvarande kod som skapar dem. Du kan använda den här anteckningen för att dölja några av dessa varningar."

"En programmerare kan använda @SuppressWarnings -kommentaren för att säga till kompilatorn, «Visa inte en varning för det här felet - det är avsiktligt.» Till exempel:"

@SuppressWarnings("unchecked")
void getUniqueCatName()
{

}

"Jag fattar."

"Jag börjar bli lite trött. Jag ska gå och blöta min uttorkade hals. Låt oss fortsätta efter en paus, okej?"

"Säker."