---------------------- ASP.Net+Android+IO開發S、.Net培訓、期待與您交流！ ----------------------

註解（annotation）是jdk1.5的新特性

瞭解註解及java提供的幾個基本註解

1）  先通過@SuppressWarnings的應用讓大家直觀地瞭解註解：

通過System.runFinalizersOnExit（true）；的編譯警告引出

@SuppressWarnings（“deprecation”）--->壓制警告

2）@Deprecated--->（過時的方法，對於不再使用的方法，可能別人或別的地方有呼叫這個方法，不能刪除完事）

         直接在剛才的類中增加一個方法，並加上@Deprecated標註，在另外一個類中呼叫這個方法。

3）@Override--->提示覆蓋

         Publicboolean equals（Reflect other）方法與HashSet結合講解。

總結：註解相當於一種標記，加了註解就等於打上了某種標記，沒加，則等於沒有某種標記，以後，javac編譯器，開發工具和其他程式可以用反射來了解你的類及各種元素上有無何種標記，看你有什麼標記，就去幹相應的事。標記可以加在包，類，欄位，方法，方法的引數以及區域性變數上。

看java.lang包，可看到JDK中提供的最基本的annotation

·定義一個最簡單的註解：public @interface MyAnnotation{}

·把它加在某個類上：@MyAnnotation public class Annotation Test{}

·用反射進行測試Annotation Test的定義上是否有@MyAnnotation。

·格局反射測試的問題，引出@Retention元註解的講解，其三種取值：

RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME：分別對應：java原始檔、class檔案、記憶體中的位元組碼。

         思考：@Override、@SuppressWarnings和@Deprecated這三個註解的屬性值分別是什麼？答：分別為class，class，runtime。

·演示和講解@Target元註解

         Target的預設值為任何元素，設定Target等於ElementType.METHOD，原來加在類上的註解就報錯了，改用陣列方式設定{ElementType.METHOD,ElementType.TYPE}就可以了。

·元註解以及其列舉屬性值不用記，只要會看JDK通過那幾個基本註解的API幫助文件的定義或其原始碼，按圖索驥即可查到，或者直接看java.lang.annotation包下面的類。

為註解增加基本屬性

·什麼是註解的屬性？

         一個註解相當於一個胸牌，如果你胸前貼了胸牌，就是傳智部落格的學生，否則，就不是。如果還想區分出是傳智部落格哪個班的學生，這時候可以為胸牌再增加一個屬性來進行區分。加了屬性的標記效果為：@MyAnnotation（color = “red”）

·定義基本型別的屬性和應用屬性：

         在註解類中增加Stringcolor（）；

         @MyAnnotation（color = “red”）

·用反射方式獲得註解對應的例項物件後，再通過該物件呼叫屬性對應的方法。

MyAnnotation a =（MyAnnotation）AnnotationTest.class.getAnnotation(MyAnnotation.class);

System.out.println(a.color());

可以認為上面這個@MyAnnotation是MyAnnotation類的一個例項物件。

·為屬性指定預設值

         Stringcolor（）default “yellow”

·value屬性：

         Stringvalue（） default “zxx”；

         如果註解中有一個名稱value的屬性，且你只想設定value屬性（即其他屬性都採用預設值或者你只有一個value屬性），那麼可以省略value = 部分，例如：@MyAnnotation（“lhm”）。

為註解增加高階屬性。

·陣列型別的屬性

1)      int[] arrAttr() default{1,2,3};

2)      @MyAnnotation(arrayAttr = {2,3,4}

3)      如果陣列屬性中只有一個元素，這時候屬性值部分可以省略大括號。

·列舉型別的屬性。

1）  Enum Test.TrafficLamp lamp（）；

2）  @MyAnnotation（lamp = EnumTest.TrafficLamp.GREEN）

·註解型別的屬性：

1）  MetaAnnotation annotationAttr（）[email protected]（“xxxx”）；

2）  @MyAnnotation（annotation Attr = @MetaAnnotation（“yyy”））

3）  可以認為上面這個@MyAnnotation是MyAnnotation類的一個例項物件，同樣的道理，可以認為上面這個@MetaAnnotation是MetaAnnotation類的一個例項物件。呼叫程式碼如下：

MetaAnnotationma = myAnnotation.AnnotationAttr();

System.out.println(ma.value（）);

·註解的詳細語法可以通過看java語言規範瞭解，即看java的language specification。

import java.lang.reflect.Method;

import javax.jws.soap.InitParam;

@ItcastAnnotation([email protected]("flx"),color="red",value="abc",arrayAttr=1)
public class AnnotationTest {

	/**
	 * @param args
	 */
	@SuppressWarnings("deprecation")//一個註解相當於一個類，這裡是一個例項物件。
	@ItcastAnnotation("xyz")
	public static void main(String[] args) throws Exception{
		// TODO Auto-generated method stub
		System.runFinalizersOnExit(true);
		if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
			ItcastAnnotation annotation = (ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
			System.out.println(annotation.color());
			System.out.println(annotation.value());
			System.out.println(annotation.arrayAttr().length);
			System.out.println(annotation.lamp().nextLamp().name());
			System.out.println(annotation.annotationAttr().value());
		}
		
		Method mainMethod = AnnotationTest.class.getMethod("main", String[].class);
		ItcastAnnotation annotation2 = (ItcastAnnotation)mainMethod.getAnnotation(ItcastAnnotation.class);
		System.out.println(annotation2.value());
	}

	@Deprecated
	public static void sayHello(){
		System.out.println("hi,傳智播客");
	}
}

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import cn.itcast.day1.EnumTest;

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface ItcastAnnotation {
	String color() default "blue";
	String value();
	int[] arrayAttr() default {3,4,4};
	EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;
	MetaAnnotation annotationAttr() default @MetaAnnotation("lhm");
}

---------------------- ASP.Net+Android+IO開發S、.Net培訓、期待與您交流！ ----------------------