@SuppressWarnings 注解

@SuppressWarnings: 抑制編譯器警告

如下，可以看到idea中有警告的顏色標注

當我們不希望看到這些警告的時候，可以使用 SuppressWarnings注解來抑制警告信息

在{" "} 中，可以寫入你希望抑制(不顯示)警告信息

在idea中可以看到這些警告的信息，然后根據(jù)下面的屬性介紹依次填入對應(yīng)的抑制警告的參數(shù)，如：

• rawtypes，抑制與使用raw類型相關(guān)的警告

• unchecked，抑制與未檢查的作業(yè)相關(guān)的警告

• unused，抑制與未用的程式碼及停用的程式碼相關(guān)的警告

可以從下面的警告參數(shù)中找到對應(yīng)的警告參數(shù)即可?？梢钥吹骄嫒勘灰种屏?/p>

當然，也可以直接選擇參數(shù) all，警告就全部會被抑制

關(guān)于SuppressWarnings 作用范圍是和放置的位置相關(guān)

比如 @SuppressWarnings放置在 main方法，那么抑制警告的范圍就是 main，通常我們可以放置具體的語句、方法、 類。

• @SuppressWarnings注解的常見的值
• unchecked是忽略沒有檢查的警告
• rawtypes是忽略沒有指定泛型的警告(傳參時沒有指定泛型的警告錯誤)
• unused是忽略沒有使用某個變量的警告錯誤
• @SuppressWarnings可以修飾的程序元素，查看 @Target

查看源碼：

(1) 放置的位置就是 TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE

(2) 該注解類有數(shù)組 String[] values() ，設(shè)置一個數(shù)組比如 {"rawtypes", "unchecked", "unused"}

生成@SupperssWarnings時，不用背，直接點擊左側(cè)的黃色提示，就可以選擇(注意可以指定生成的位置)

@SuppressWarning 中的屬性介紹以及屬性說明

• all：抑制所有警告
• boxing：抑制與封裝/拆裝作業(yè)相關(guān)的警告
• cast：抑制與強制轉(zhuǎn)型作業(yè)相關(guān)的警告
• dep-ann：抑制與淘汰注釋相關(guān)的警告
• deprecation：抑制與淘汰的相關(guān)警告
• fallthrough：抑制與switch陳述式中遺漏break相關(guān)的警告
• finally：抑制與未傳回finally區(qū)塊相關(guān)的警告
• hiding：抑制與隱藏變數(shù)的區(qū)域變數(shù)相關(guān)的警告
• incomplete-switch：抑制與switch陳述式(enum case)中遺漏項目相關(guān)的警告
• javadoc：抑制與javadoc相關(guān)的警告
• nls：抑制與非nls字串文字相關(guān)的警告
• null：抑制與空值分析相關(guān)的警告
• rawtypes：抑制與使用raw類型相關(guān)的警告
• resource：抑制與使用Closeable類型的資源相關(guān)的警告
• restriction：抑制與使用不建議或禁止參照相關(guān)的警告
• serial：抑制與可序列化的類別遺漏serialVersionUID欄位相關(guān)的警告
• static-access：抑制與靜態(tài)存取不正確相關(guān)的警告
• static-method：抑制與可能宣告為static的方法相關(guān)的警告
• super：抑制與置換方法相關(guān)但不含super呼叫的警告
• synthetic-access：抑制與內(nèi)部類別的存取未最佳化相關(guān)的警告
• sync-override：抑制因為置換同步方法而遺漏同步化的警告
• unchecked：抑制與未檢查的作業(yè)相關(guān)的警告
• unqualified-field-access：抑制與欄位存取不合格相關(guān)的警告
• unused：抑制與未用的程式碼及停用的程式碼相關(guān)的警告

@SuppressWarnings 注解常見用法

使用場合

@SuppressWarnings注解，主要用于抑制編譯器報出的warning信息。

比如在idea中，如果某個方法的返回值沒有被使用，idea在語法檢查時，會把這個方法標記為陰影狀態(tài)，鼠標懸停后會顯示對應(yīng)的原因。

如果此時我覺得這個返回值是必要的，只是暫時還沒用到，就可以加一個@SuppressWarnings注解，抑制警告信息。

當然，不是每時每刻都需要解決warning。一般會在提交代碼前做一個檢查，例如用idea的gui提交到git倉庫時，默認會對我們的修改做一個檢查，如果有warning信息會提示我們修改。

注解介紹

@SuppressWarnings注解可標注于類、屬性、方法、參數(shù)構(gòu)造函數(shù)、局部變量上。

一般需滿足最小范圍原則，即如果警告信息來自于某個方法時，則將此注解標注與該方法上，而不要標注于范圍更大的類上。

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    
    String[] value();
}

注解只有一個value值，用于接收warning的類型，下面列舉常見的value。

value常見取值

UnusedReturnValue

作用：抑制  “方法的返回值未被使用”警告

示例：

 
    @SuppressWarnings("UnusedReturnValue")    
    int batchInsert(@Param("lists") List<T>lists, Class<T>clazz);

unused

作用：抑制“方法或者變量未被使用”警告

示例：

    @SuppressWarnings("unused")
    public <T> String getByPrimaryKey(Object key, Class<T> clazz) {

unchecked

作用：抑制“未經(jīng)檢查的類型轉(zhuǎn)化”警告

示例：

all

作用：抑制所有的報錯

盡量遵守“最小范圍”原則，一般情況下不要用。

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論