[Session d'étude interne] Bases de l'annotation Java (2017/11/02) ~ En construction ~

0. Introduction

Contenu

• Base d'annotation.

Connaissances préalables

• Syntaxe de base Java
• Comment utiliser les annotations Java

Livres de référence

«Effective Java 2nd Edition» Maruzen Publishing

table des matières

1. Avantages de l'annotation
2. Annotation personnalisée
3. Afficher le contenu de JUnit et de lombok

1. Avantages de l'annotation

Présentation des annotations Java

L'annotation (en anglais: annotation) consiste à ajouter des informations connexes (métadonnées) à certaines données sous forme d'annotation.

• [Annotation-Wikipedia](https://ja.wikipedia.org/wiki/%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7% E3% 83% A7% E3% 83% B3) Citation

• Introduit à partir de Java 5 (sorti en 2004)

Exemple d'annotation (JUnit4)

CalculationTest.java

public class CalculationTest {
    /**Cas de test 1*/
	@Test
	public void sampleTest1() {
		//...
	}
    /**Cas de test 2*/
	@Test
	public void sampleTest2() {
		//...
	}    
}

• Exprimé comme un cas de test avec @ Test
• JUnit Runner exécute uniquement la méthode avec @ Test
• Les annotations ont été introduites à partir de JUnit 4

Si vous ne pouvez pas utiliser d'annotations dans JUnit (JUnit3)

CalculationTest.java

public class CalculationTest extends TestCase{
    /**Cas de test 1*/
	public void testSample1() {
		//...
	}
    /**Cas de test 2*/
	public void testSample2() {
		//...
	}    
}

• Indique qu'il s'agit d'une classe de test en héritant de TestCase

• Le nom de la méthode qui devient le cas de test commence par test ⇒ Modèle de dénomination

• Http://d.hatena.ne.jp/smada564/20110501/1304265351 Référence

Inconvénients des modèles de dénomination

Ne remarquez pas la faute de frappe

• Si la méthode porte le nom tsetSample2 (une faute de frappe), elle ne sera pas exécutée. Pas d'erreur

Les valeurs de paramètre ne peuvent pas être associées

Par exemple, considérons une méthode de test qui s'attend à lancer ʻIllegalArgumentException`.

/**Comment écrire JUnit4*/
@Test(expected = IllegalArgumentException.class)
public void sample() {
	//...
}

/**Exemple lorsque l'annotation ne peut pas être utilisée*/
public void test_IllegalArgumentException_sample() {
	//...
}    

• Moche et vulnérable

• Compile ne peut pas déterminer si une exception existe --Je ne le remarque pas avant de l'exécuter

• Référence de l'article 35 «Effective Java 2nd Edition»

Comparaison de XML et des annotations

Le servlet peut être défini avec une annotation ou XML.

@WebServlet("/Hello")
public class HelloServlet extends HttpServlet {
  //...
}

web.xml

<!--Si vous n'utilisez pas d'annotations, spécifiez dans XML-->
<servlet>
  <servlet-name>Hello</servlet-name>
  <servlet-class>jp.co.sample.HelloServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>Hello</servlet-name>
  <url-pattern>/Hello</url-pattern>
</servlet-mapping>

Caractéristiques des annotations par rapport au XML

• Petite quantité de description
• Complété en un seul fichier
• Pas besoin de modifier les annotations même si le nom de la classe ou le nom de la méthode est changé

⇒ ** Fort contre les changements de source **

• Annotations vs XML, avantages et inconvénients Référence

Annotations de bibliothèque standard

@Override

Une annotation qui indique que la méthode est remplacée.

Book.java

public class Book {
	public Book(String title, String author) {
		this.title = title;
		this.author = author;
	}
	String title;
	String author;

	@Override //Compile Error.Correctement égal(Object obj)
	public boolean equals(Book obj) {
		//Omettre la vérification nulle
		return title.equals(obj.title) && author.equals(obj.author);
	}

}

Au moment de la compilation, notez qu'il n'est pas remplacé (surchargé).

• Référence de l'élément 36 «Effective Java 2nd Edition»
• [Effective Java] Item 36: Always use Override annotation Référence

@Deprecated

Depuis Java9, vous pouvez écrire @Deprecated (since =" 9 ", forRemoval = true)

• Va-t-il être aboli? (pour le retrait)

• Quand sera-t-il aboli? (puisque)

• Quoi de neuf pour les bibliothèques principales dans JDK Référence

@SuppressWarnings

Faites en sorte que l'EDI supprime les messages d'avertissement.

@SuppressWarnings( "unchecked" ) //Exclure les avertissements concernant la vérification de type
@SuppressWarnings( "javadoc" ) //Exclusion des avertissements JavaDoc
public class Book {
	//..
}

• Http://capm-network.com/?tag=Java-%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83 Voir% A7% E3% 83% B3

attribut de valeur

appendice

Annotation standard

Site de référence

http://www.oracle.com/webfolder/technetwork/jp/javamagazine/Java-MA14-Architect-TypeAnnotations.pdf http://www.oracle.com/webfolder/technetwork/jp/javamagazine/Java-MA16-Annotations.pdf