Java 元數據與注解全面解析：內置注解、元注解與自定義注解實戰

什麼是 Java 元數據（Metadata）

Metadata 意為「關於數據的數據」。Java 注解（Annotation）是元數據的標準化實現，廣泛用於：生成文檔（Javadoc）、追蹤代碼依賴、編譯時格式檢查、替代配置文件（如 Hibernate 注解配置）。

三種基本注解類型

三大內置注解

• @Override：僅用於方法，編譯期驗證重寫正確性
• @Deprecated：標記不建議使用的方法/類
• @SuppressWarnings：抑制特定編譯警告，如 @SuppressWarnings("unchecked")

四大元注解：注解其他注解

自定義注解實戰

1. 簡單標記注解

package com.oreilly.tiger.ch06;
public @interface InProgress { }

2. 使用自定義注解

@com.oreilly.tiger.ch06.InProgress
public void calculateInterest(float amount, float rate) { }

3. 添加成員

public @interface InProgress {
    String value();
}

4. 設置默認值

public @interface GroupTODO {
    public enum Severity { CRITICAL, IMPORTANT, TRIVIAL, DOCUMENTATION }
    Severity severity() default Severity.IMPORTANT;
    String item();
    String assignedTo();
    String dateAssigned();
}

5. 使用默認值 / 改寫默認值

@GroupTODO(
    item = "Figure out interest per month",
    assignedTo = "Brett",
    dateAssigned = "08/04/2004"
)
public void calculateInterest(float amount, float rate) { }

@GroupTODO(
    severity = GroupTODO.Severity.DOCUMENTATION,
    item = "Explain unusual method",
    assignedTo = "Jon",
    dateAssigned = "07/30/2004"
)
public void anotherMethod() { }

總結

Java 注解機制從簡單標記發展為功能完備的元數據體系，配合反射 API 可在運行時讀取注解信息，驅動框架自動化行為（如 Spring、Hibernate、JUnit），是現代 Java 開發的基石技術之一。

1. 上一篇文章： Hibernate 與 Struts 分頁實現策略對比與最佳實踐
2. 下一篇文章： Tomcat 服務器安全加固實戰：從滲透測試到防禦體系構建

Java 相關知識

Struts 1 學習總結：從核心架構到源碼級理解的完整知識圖譜

系列回顧與思維導圖 系列博客側重四大核心問題： Stru

JavaEE Without Ajax：以 JSF Render Kit 實現零 Ajax 代碼的富客戶體驗

背景：Ajax 的雙面刃 優點：局部刷新、更好 UX、

Struts 1.x 系列教程（10）：Validator 驗證框架入門與完整範例

前言 Validator 框架是 Struts 官方外掛，以

WebLogic Portal 性能管理指南

即使是經驗豐富的 Java Web 開發人員，也會對開發門戶