Quelles sont les annotations Java courantes ?

Annotation

(Tutoriel recommandé : Tutoriel d'introduction à Java)

• À partir de JDK à partir de la version 5.0 , Java a ajouté la prise en charge des métadonnées, c'est-à-dire l'annotation

• L'annotation est en fait une marque spéciale dans le code. Ces marques peuvent être utilisées lors de la compilation et du chargement de la classe et sont lues au moment de l'exécution. , et le traitement correspondant est effectué. En utilisant l'annotation, nous pouvons intégrer des informations supplémentaires dans le fichier source sans modifier la logique d'origine. Les outils d'analyse de code, les outils de développement et les outils de déploiement peuvent utiliser ces informations supplémentaires à des fins de vérification ou de déploiement.

• L'annotation peut être utilisée comme un modificateur et peut être utilisée pour modifier la déclaration des packages, des classes, des constructeurs, des méthodes, des variables membres, des paramètres et des variables locales. Ces informations sont enregistrées dans. Annotation. Paires "nom=valeur".

• En JavaSE, l'utilisation des annotations est relativement simple, comme marquer les fonctions obsolètes, ignorer les avertissements, etc. Les annotations jouent un rôle plus important dans JavaEE/Android, par exemple, elles sont utilisées pour configurer n'importe quel aspect de l'application, remplaçant le code fastidieux et la configuration XML laissés dans l'ancienne version de JavaEE.

• Les futurs modèles de développement sont tous basés sur des annotations, JPA est basé sur des annotations, Spring 2.5 et supérieur sont tous basés sur des annotations, Hibernate3.x et versions ultérieures sont également basés sur des annotations, et maintenant Struts2 Une partie est également basée sur des annotations, et les annotations sont une tendance. Dans une certaine mesure, on peut dire : Framework = Annotations + Réflexion + Design Patterns.

Annotations communes

Lorsque vous utilisez une annotation, ajoutez le symbole @ devant elle et utilisez l'annotation comme modificateur. Utilisé pour décorer les éléments du programme qu'il prend en charge.

Générer des annotations liées à la documentation

• @author indique l'auteur qui a développé ce type de module, utilisé entre plusieurs auteurs, divisé

• @version indique la version de ce module

• @voir Pilotage de référence, c'est-à-dire les sujets connexes

• @depuis quelle version start from Le

• @param ajouté est une description d'un certain paramètre dans la méthode. S'il n'y a pas de paramètres, il ne peut pas être écrit

• <.>@return est une description de la valeur de retour de la méthode. Si le type de valeur de retour de la méthode est nul, vous ne pouvez pas écrire

• @exception pour décrire les exceptions que le La méthode peut lancer. Si la méthode n'utilise pas de lancers pour lancer explicitement des exceptions, vous ne pouvez pas écrire

(Tutoriel vidéo :

Tutoriel vidéo Java)

Remarque :

• @param @return Ces trois balises, @exception, ne sont utilisées que pour les méthodes.

• Exigences de format pour @param : @param Nom du paramètre formel Type de paramètre formel Description du paramètre formel

• Exigences de format pour @return : @return Return Description de la valeur de retour du type de valeur

• Exigences de format @exception : @exception Description de l'exception du type d'exception

• @param et @exception peuvent être combinées en plusieurs

Exemple de code :

/**
 * @author wushanghui
 * @date 2020/7/16 17:51
 * @see Math
 * @version	 1.0
 *
 */
public class JavadocAnnotation {

    /**
     * 程序的主方法，程序的入口
     *
     * @param args String[] 命令行参数
     */
    public static void main(String[] args) {
        System.out.println(getArea(1.0d)); // 3.141592653589793
    }


    /**
     * 求圆面积的方法
     * @since 1.0
     * @param radius double 半径值
     * @return double 圆的面积
     */
    public static double getArea(double radius) {
        return Math.PI * radius * radius;
    }
}

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!