[Notes de démarrage Java] Bases du langage Java (1) : commentaires, identifiants et mots clés

Annotations

Que sont les annotations ?

Les commentaires sont un texte explicatif pour un certain morceau de code, une certaine méthode ou une certaine classe lorsque nous écrivons du code pour faciliter la lecture du code par tout le monde. Le contenu commenté ne sera ni compilé ni exécuté.

Les commentaires Java sont divisés en trois types : les commentaires sur une seule ligne, les commentaires sur plusieurs lignes et les commentaires sur le document.

Commentaires sur une seule ligne et commentaires sur plusieurs lignes

Les commentaires sur une seule ligne commentent une ligne de texte ou de code dans le programme En Java, utilisez "//" pour les commentaires sur une seule ligne. . Les commentaires multilignes peuvent commenter plusieurs lignes de code à la fois. En Java, "/*" est utilisé pour indiquer le début d'un commentaire multiligne et "*/" est utilisé pour indiquer la fin d'un commentaire multiligne. commenter

Exemple :

public class CommentTest{    public static void main(String[] args){        //这是单行注释
        /*
        多行注释第一行
        第二行        */
        //System.out.PRintln("被注释的代码不会编译和运行");
        System.out.println("未被注释的代码");
    }
}

Touches de raccourci de commentaire Eclipse : Ctrl / commentaire sur une seule ligne et décommenter ; Ctrl Maj / ajouter /* */ commentaire ; 🎜>

Commentaire du document

Utiliser le commentaire du document pour ajouter Les annotations peuvent être utilisées pour générer des documents API via l'outil de génération de documents javadoc L'outil javadoc traite uniquement les annotations devant les classes, interfaces, méthodes, Champs, constructeurs et classes internes modifiés avec public et protégés dans le texte source du document.

Les commentaires de la documentation se terminent par "/**"Commencez par"*/". La partie centrale est le commentaire de la documentation, qui sera généré dans la documentation de l'API.

Exemple :

/**
 * 这是一个文档注释的测试类
 * @author ping
 * */public class Test {    
    /** 这是一个Filed */
    public int i;    /**
     * 这是程序的main方法
     * @param args     */
    public static void main(String[] args) {
        
    }
}

Concernant la génération de la documentation JavaAPI, vous pouvez vous référer aux deux articles suivants :

Utiliser la commande javadoc pour générer la documentation d'aide de l'API

Que diriez-vous d'eclipse Générer du javadoc

Identifiants et mots-clés

Délimiteur

Les délimiteurs en Java incluent le point-virgule (;), les accolades ({}), les crochets ([ ] ), parenthèses (()), espaces, points (.), tous les symboles sont des symboles anglais auxquels il faut prêter une attention particulière lors de l'écriture du code.

Point-virgule : en Java, une nouvelle ligne ne peut pas représenter la fin d'une instruction. Seul un point-virgule représente la fin d'une instruction. Par conséquent, théoriquement, plusieurs instructions peuvent être écrites sur une seule ligne, mais cela n'est pas recommandé. cela affectera la lisibilité du code et rendra le code encombré.

Accolades : Une paire d'accolades représente un bloc d'instructions et doit apparaître par paires.

Crochets : utilisés pour les tableaux, utilisés lors de la définition des tableaux et de l'accès aux éléments du tableau. Ils doivent également être utilisés par paires.

Parenthèses : utilisées pour inclure des paramètres formels lors de la définition de méthodes, de l'appel de méthodes et de constructeurs, nécessitant des parenthèses.

Espace : utilisé pour séparer plusieurs parties d'une déclaration.

Points : utilisés comme membres d'objets et de classes.

Identifiant

L'identifiant est un symbole utilisé pour nommer les classes, les méthodes et les variables dans un programme. Les identifiants Java ont les caractéristiques suivantes :

sont sensibles à la casse.

doit commencer par des caractères, des traits de soulignement et des signes dollar, et peut être suivi de quatre éléments : caractères, traits de soulignement, signes dollar et chiffres. Les caractères ne se limitent pas aux caractères anglais, mais peuvent être des caractères de différents pays tels que les caractères chinois.

ne peut pas contenir de symboles spéciaux autres que des traits de soulignement et des espaces.

ne peut pas être un mot-clé en Java.

public class Test{ //Test est un identifiant

public static void main(String[] args){ //main args est également un identifiant int a = 1;
　int A = 1 ; //a et A sont deux identifiants différents int $i = 2; //L'identifiant est correct int 123 = 123; //L'identifiant est incorrect int i123 = 123; /Correct int i.1 = 1; //Error int class = 2; //class est un mot-clé, erreur}
}

Mot-clé

Java contient un total de 48 mots-clés et deux mots réservés (goto/const).

Ce qui précède est [Notes d'introduction Java] Bases du langage Java (1) : commentaires, identifiants et mots-clés Pour plus de contenu connexe, veuillez faire attention au site Web PHP chinois (www.php.cn) !