原帖地址：http://gladto.iteye.com/blog/728634
背景知識： ?????? 從JDK5開始提供名為Annotation（注釋）的功能，它被定義為JSR-175規范。注釋是以“@注釋名”在代碼中存在的，還可以添加一些參數值，例如：@SuppressWarnings(value="unchecked")。注釋可以附加在package, class, method, field等上面，相當于給它們添加了額外的輔助信息，我們可以通過反射機制編程實現對這些元數據的訪問。如果沒有外部解析工具等對其加以解析和處理的情況，本身不會對Java的源代碼或class文件等產生任何影響，也不會對它們的執行產生任何影響。 JDK5內置的基本注釋
Java代碼
public ?class ?OverrideDemo?{ ??????@Override public ?String?tostring()?{ ?? ????????return ?super .toString(); ?? ????} ?? }??
Java代碼 ?
public ?class ?OverrideDemo?{ ??????@Override ?? public ?String?tostring()?{ ??????????return ?super .toString(); ?? ????} ?? }??
public class OverrideDemo {@Override
public String tostring() {return super.toString();}
}
引用
OverrideTest.java:4: 方法未覆蓋其父類的方法
??????? @Override
???????? ^1 錯誤
Java代碼
public ?class ?DeprecatedDemo?{ ??????public ?static ?void ?main(String[]?args)?{ ?? ?????????DeprecatedClass.DeprecatedMethod(); ?? ????} ?? } ?? ?? class ?DeprecatedClass?{ ?? ????@Deprecated ????public ?static ?void ?DeprecatedMethod()?{ ?? ?????????? ????} ?? }??
Java代碼 ?
public ?class ?DeprecatedDemo?{ ??????public ?static ?void ?main(String[]?args)?{ ?? ?????????DeprecatedClass.DeprecatedMethod(); ?? ????} ?? } ?? ?? class ?DeprecatedClass?{ ??????@Deprecated ?? ????public ?static ?void ?DeprecatedMethod()?{ ?? ?????????? ????} ?? }??
public class DeprecatedDemo {public static void main(String[] args) {DeprecatedClass.DeprecatedMethod();}
}class DeprecatedClass {@Deprecatedpublic static void DeprecatedMethod() {// TODO}
}
引用
注意：DeprecatedDemo.java 使用或覆蓋了已過時的 API。
注意：要了解詳細信息，請使用 -Xlint:deprecation 重新編譯。
引用
DeprecatedDemo.java:6: 警告：[deprecation] SomeClass 中的 DeprecatedMethod() 已過時
??????????????? SomeClass.DeprecatedMethod();
???????????????????????? ^1 警告
Java代碼
class ?DeprecatedClass?{ ??????????? ? ?? @Deprecated ????public ?static ?void ?DeprecatedMethod()?{ ?? ?????????? ????} ?? }??
Java代碼 ?
class ?DeprecatedClass?{ ??????????? ? ?? @Deprecated ??????public ?static ?void ?DeprecatedMethod()?{ ?? ?????????? ????} ?? }??
class DeprecatedClass {/**
* @deprecated 此方法已過時，不建議使用
*/
@Deprecatedpublic static void DeprecatedMethod() {// TODO}
}
Java代碼
import ?java.util.List; ??import ?java.util.ArrayList; ?? public ?class ?SuppressWarningsDemo?{ ?? ????????public ?static ?List?cache?=?new ?ArrayList(); ?? ???????? ?? ????????public ?void ?add(String?data)?{ ?? ????????????cache.add(data); ?? ????????} ?? }??
Java代碼 ?
import ?java.util.List; ??import ?java.util.ArrayList; ??public ?class ?SuppressWarningsDemo?{ ??????????public ?static ?List?cache?=?new ?ArrayList(); ?? ???????? ?? ????????public ?void ?add(String?data)?{ ?? ????????????cache.add(data); ?? ????????} ?? }??
import java.util.List;
import java.util.ArrayList;
public class SuppressWarningsDemo {public static List cache = new ArrayList();//@SuppressWarnings(value = "unchecked")public void add(String data) {cache.add(data);}
}
引用
注意：SuppressWarningsDemo.java 使用了未經檢查或不安全的操作。
注意：要了解詳細信息，請使用 -Xlint:unchecked 重新編譯。
自定義Annotation注釋 2、自定義注釋的實例：
Java代碼
@interface 與interface 之間的不同：? ???? import ?java.lang.annotation.*; ?? ? ? ?? public ?@interface ?Unstable?{ ?? }??
Java代碼 ?
@interface 與interface 之間的不同：? ???? import ?java.lang.annotation.*; ??? ? ?? public ?@interface ?Unstable?{ ??}??
@interface與interface之間的不同： import java.lang.annotation.*;
/**
* 使用annotation來描述那些被標注的成員是不穩定的，需要更改
*/
public @interface Unstable {
}
Java代碼
? ? ?? public ?@interface ?Author?{ ?? ???????? ??????String?value(); ?? }??
Java代碼 ?
? ? ?? public ?@interface ?Author?{ ?????????? ??????String?value(); ?? }??
/**
* 使用Author這個annotation定義在程序中指出代碼的作者
*/
public @interface Author {/** 返回作者名 */String value();
}
Java代碼
? ? ? ?? @Retention public ?@interface ?Reviews?{ ?? ????Review[]?value(); ?? } ?? ? ? ? ? ? ?? public ?@interface ?Review?{ ?? ?????? ?????public ?static ?enum ?Grade?{?EXCELLENT,?SATISFACTORY,?UNSATISFACTORY?}; ?? ??????? ?????Grade?grade(); ?? ?????String?reviewer(); ?? ?????String?comment()?default ?"" ; ?? }??
Java代碼 ?
? ? ? ?? @Retention (RetentionPolicy.RUNTIME) ??public ?@interface ?Reviews?{ ??????Review[]?value(); ?? } ?? ? ? ? ? ? ?? public ?@interface ?Review?{ ???????? ?????public ?static ?enum ?Grade?{?EXCELLENT,?SATISFACTORY,?UNSATISFACTORY?}; ?? ??????? ?????Grade?grade(); ?? ?????String?reviewer(); ?? ?????String?comment()?default ?"" ; ?? }??
/**
* Reviews annotation類型只有一個成員，
* 但是這個成員的類型是復雜的：由Review annotation組成的數組
*/
@Retention(RetentionPolicy.RUNTIME)
public @interface Reviews {Review[] value();
}
/**
* Review annotation類型有3個成員：
* 枚舉類型成員grade、
* 表示Review名稱的字符串類型成員Reviewer、
* 具有默認值的字符串類型成員Comment。
*/
public @interface Review {// 內嵌的枚舉類型public static enum Grade { EXCELLENT, SATISFACTORY, UNSATISFACTORY };// 下面的方法定義了annotation的成員Grade grade();String reviewer();String comment() default "";
}
Java代碼
public ?@interface ?UncheckedExceptions?{? ???????Class[]?value(); ?? }??
Java代碼 ?
public ?@interface ?UncheckedExceptions?{? ???????Class[]?value(); ?? }??
public @interface UncheckedExceptions { Class[] value();
}
Meta-Annotation類型： @Target的用法： 指示注釋類型所適用的程序元素的種類。如果注釋類型聲明中不存在 Target 元注釋，則聲明的類型可以用在任一程序元素上。如果存在這樣的元注釋，則編譯器強制實施指定的使用限制。 例如，以下這個注釋只能用來聲明方法：
Java代碼
@Target ??public ?@interface ?MyAnnotation?{ ?? ??????...? ?? ??}??
Java代碼 ?
@Target (ElementType.METHOD) ????public ?@interface ?MyAnnotation?{ ?? ??????...? ?? ??}??
@Target(ElementType.METHOD)public @interface MyAnnotation {... }
@Retention的用法： 指示注釋類型的注釋要保留多久。如果注釋類型聲明中不存在 Retention 注釋，則保留策略默認為 RetentionPolicy.CLASS，例如：
Java代碼
@?Retention(RetentionPolicy.CLASS) ?? ????public ?@interface ?MyAnnotation?{ ?? ????????...? ?? ????}??
Java代碼 ?
@?Retention(RetentionPolicy.CLASS) ?? ????public ?@interface ?MyAnnotation?{ ?? ????????...? ?? ????}??
@ Retention(RetentionPolicy.CLASS)public @interface MyAnnotation {... }
@Documented的用法： 指示某一類型的注釋將通過 javadoc 和類似的默認工具進行文檔化。應使用此類型來注釋這些類型的聲明：其注釋會影響由其客戶端注釋的元素的使用。如果類型聲明是用 Documented 來注釋的，則其注釋將成為注釋元素的公共 API 的一部分。Documented是一個沒有成員的注釋。 @Inherited的用法： 指示注釋類型自動被子類繼承。 Inherited也是一個沒有成員的注釋。
總結
以上是生活随笔 為你收集整理的@SuppressWarnings 详解 的全部內容，希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔 網站內容還不錯，歡迎將生活随笔 推薦給好友。
