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

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

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

核心功能

忽略未標注 @ExcelProperty 的字段

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

使用場景

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

代碼示例

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

對比默認行為

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

注意事項

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

常見問題

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

Q：如何導出所有字段（恢復默認行為）？
A：直接移除 @ExcelIgnoreUnannotated 注解即可。

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

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

您可能感興趣的文章: