一.引入 

     上文http://zy19982004.iteye.com/blog/1979208中，提到了註解類JyzTargetPackage可以定義為@Target(ElementType.PACKAGE)，可是在被註解類裡我無論怎麼加，編譯器都報錯，於是引入了package-info.java這個檔案。

二.建立package-info.java

1. "I found that when you create a new package in eclispe there is a check box to check if you want a package-info.java."勾上就行了。
2. 如果不幸的是你已經建立了這個包並在裡面定義了很多類，而eclispe又是不能直接建立一個package-info.java檔案的。只能在包對應資料夾裡，手動建立一個package-info.java，寫上包名，最後重新整理eclispe即可。

三.package-info.java的作用

1. "Package annotations must be in file package-info.java",package-info.java為我們提供了包註解的地方。JyzTargetPackage(http://zy19982004.iteye.com/blog/1979208)苦苦尋找終於找到地方了。
2. 提供包級別的類(或介面)，這些類(或介面)只有本包裡才能訪問，即使是子包也不能訪問。
3. 提供包的整體註釋說明。

 package-info.java

1. /**   
2.  * <b>package-info不是平常類，其作用有三個:</b><br>   
3.  * 1、為標註在包上Annotation提供便利；<br>   
4.  * 2、宣告包的私有類和常量；<br>   
5.  * 3、提供包的整體註釋說明。<br>   
6.  *  
7.  * @author [email protected]  
8. */
9. @JyzTargetPackage(version="1.0")  
10. package com.jyz.study.jdk.annotation;  
11. class PackageInfo{  
12.     publicvoid common(){  
13.         System.out.println("sa");  
14.     }  
15. }  
16. class PackageInfoGeneric<T extends Throwable>{  
17.     private T obj;  
18.     publicvoid set(T obj){  
19.         this.obj = obj;  
20.     }  
21.     publicvoid common(){  
22.         System.out.println(obj + "sa");  
23.     }  
24. }  
25. interface packageInfoInteger{  
26.     publicvoid test();  
27. }  
28. class PackageConstants{  
29.     publicstaticfinal String ERROE_CODE = "100001";     
30. }  

TestPackageInfo.java

1. package com.jyz.study.jdk.annotation;  
2. import java.io.IOException;  
3. /** 
4.  * 測試package-info.java檔案的作用 
5.  * 1、為標註在包上Annotation提供便利；<br>   
6.  * 2、宣告包的私有類和常量；<br>   
7.  * @author [email protected] 
8.  * 
9.  */
10. publicclass TestPackageInfo {  
11.     publicstaticvoid main(String[] args) {  
12.         //1
13.         Package p = Package.getPackage("com.jyz.study.jdk.annotation");  
14.         if(p != null && p.isAnnotationPresent(JyzTargetPackage.class)){  
15.             JyzTargetPackage nav = p.getAnnotation(JyzTargetPackage.class);  
16.             if(nav != null){   
17.                 System.out.println("package version:" + nav.version());  
18.             }  
19.         }  
20.         //2
21.         PackageInfo packageInfo = new PackageInfo();  
22.         packageInfo.common();  
23.         //泛型也能很好的工作，在pakcage-info.java裡定義的類和普通類沒什麼區別
24.         PackageInfoGeneric<Exception> packageInfoGeneric = new PackageInfoGeneric<Exception>();  
25.         packageInfoGeneric.set(new IOException("device io"));  
26.         packageInfoGeneric.common();  
27.         Sub sub = new Sub();  
28.         sub.test();  
29.         System.out.println(PackageConstants.ERROE_CODE);  
30.     }  
31. }  
32. class Sub implements packageInfoInteger{  
33.     @Override
34.     publicvoid test() {  
35.         System.out.println("sub");  
36.     }  
37. }  
38. console output:  
39. package version:1.0
40. sa  
41. java.io.IOException: device iosa  
42. sub  
43. 100001

  需要注意兩點

1. package-info.java裡不能宣告public class(或 interface)
2. 剛開始p.isAnnotationPresent(JyzTargetPackage.class)返回false，後來找到原因JyzTargetPackage沒有加上@Retention(RetentionPolicy.RUNTIME)。