快捷導(dǎo)航

Java中@ExcelIgnoreUnannotated注解小結(jié)

更新時間：2025年08月27日 10:14:31 作者：擺爛且佛系

本文主要介紹了Java中@ExcelIgnoreUnannotated注解小結(jié),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

核心功能

忽略未標(biāo)注 @ExcelProperty 的字段

當(dāng)添加 @ExcelIgnoreUnannotated 到類上時，EasyExcel 會 跳過所有未顯式標(biāo)注 @ExcelProperty 的字段，僅處理被 @ExcelProperty 明確標(biāo)記的字段。
如果沒有此注解，EasyExcel 默認(rèn)會嘗試處理實體類中的所有字段（包括未標(biāo)注的字段）。

使用場景

精確控制導(dǎo)出的字段
只導(dǎo)出標(biāo)記了 @ExcelProperty 的字段，忽略其他字段（即使它們是 public 或有無參 getter 方法）。
避免意外數(shù)據(jù)泄露
防止因未顯式忽略敏感字段而導(dǎo)致數(shù)據(jù)被意外導(dǎo)出。
提升性能
減少反射掃描的字段數(shù)量，加快導(dǎo)入/導(dǎo)出速度。

代碼示例

@ExcelIgnoreUnannotated // 僅處理帶 @ExcelProperty 的字段
public class User {
    @ExcelProperty("姓名")
    private String name;
    
    @ExcelProperty("年齡")
    private Integer age;
    
    private String password; // 不會被導(dǎo)出/導(dǎo)入
}

對比默認(rèn)行為

行為	無 @ExcelIgnoreUnannotated	有 @ExcelIgnoreUnannotated
未標(biāo)注 @ExcelProperty 的字段	會被處理（默認(rèn)按字段名匹配 Excel 列）	被忽略
需要導(dǎo)出的字段	必須顯式標(biāo)注 @ExcelIgnore 來忽略	只需標(biāo)注 @ExcelProperty 明確指定

注意事項

與 @ExcelProperty 配合使用
如果類上添加了 @ExcelIgnoreUnannotated，則必須通過 @ExcelProperty 明確指定需要處理的字段，否則這些字段會被完全忽略。
優(yōu)先級高于其他注解
即使字段有其他注解（如 @ColumnWidth），只要沒有 @ExcelProperty，依然會被忽略。
適用于復(fù)雜對象
對于嵌套對象，該注解僅作用于當(dāng)前類的字段，不會影響嵌套類自身的注解規(guī)則。

常見問題

Q：如果忘記加 @ExcelProperty 會怎樣？
A：字段會被完全忽略，可能導(dǎo)致導(dǎo)出數(shù)據(jù)缺失或?qū)霑r字段為 null。

Q：如何導(dǎo)出所有字段（恢復(fù)默認(rèn)行為）？
A：直接移除 @ExcelIgnoreUnannotated 注解即可。

通過使用 @ExcelIgnoreUnannotated，可以更嚴(yán)格地控制 Excel 導(dǎo)入/導(dǎo)出的字段范圍，避免因遺漏注解而導(dǎo)致的數(shù)據(jù)問題。

到此這篇關(guān)于Java中@ExcelIgnoreUnannotated注解小結(jié)的文章就介紹到這了,更多相關(guān)Java @ExcelIgnoreUnannotated內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: