Apache Tapestry - 註解

註解是 Tapestry 利用的一個非常重要的特性，用於簡化 Web 應用程式開發。Tapestry 提供了許多自定義註解。它對類、方法和成員欄位都有註解。如上一節所述，註解也可用於覆蓋某個特性的預設約定。Tapestry 註解分為四大類，如下所示。

元件註解

用於頁面、元件和 Mixin 類。一些有用的註解包括：

• @Property - 應用於欄位。用於將欄位轉換為 Tapestry 屬性。

• @Parameter - 應用於欄位。用於將欄位指定為元件的引數。

• @Environmental - 應用於欄位。用於在不同元件之間共享私有欄位。

• @import - 應用於類和欄位。用於包含資源、CSS 和 JavaScript。

• @Path - 與 @Inject 註解一起使用，根據路徑注入資源。

• @Log - 應用於類和欄位。用於除錯目的。可用於發出元件的事件資訊，例如事件的開始、事件的結束等。

IoC 註解

用於將物件注入 IoC 容器。一些有用的註解包括：

• @Inject - 應用於欄位。用於標記應注入 IoC 容器的引數。它標記應注入元件的欄位。

• @Value - 應用於欄位。與 @inject 註解一起使用，用於注入字面量值而不是服務（這是 @Inject 註解的預設行為）。

資料持有類註解

它用於在類（通常是模型或資料持有類）中為高階元件指定特定於元件的資訊，例如

• Grid（用於建立高階表格資料，例如報表、相簿等，）

• BeanEditForm（用於建立高階表單）

• Hibernate（用於高階資料庫訪問）等。

這些註解被聚合並打包到一個獨立的 jar 中，沒有任何 Tapestry 依賴項。一些註解包括：

• @DataType - 用於指定欄位的資料型別。Tapestry 元件可以使用此資訊在表示層建立設計或標記。

• @Validate - 用於指定欄位的驗證規則。

這些分離使 Tapestry 應用程式能夠使用多層設計。