模組 meta 資料設定

請利用這個頁面來指示 Java Platform Enterprise Edition (Java EE) Enterprise Bean (EJB) 部署描述子、Web 模組部署描述子，或 JCA 資源配接器保存檔 (RAR) 模組，以忽略指定部署資訊的註釋。

如果要檢視這個管理主控台頁面，請按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式 > application_name > 模組 meta 資料。這個頁面與應用程式安裝和更新精靈的「模組 meta 資料」頁面相同。

如果您的應用程式含有 Java EE 5 或更新版本的模組，您可以在「模組 meta 資料」頁面中，選擇鎖定一或多個模組的部署描述子。如果您勾選 metadata-complete 屬性勾選框（將 metadata-complete 屬性設為 true），並且鎖定部署描述子，產品會將完整的模組部署描述子寫成 XML 格式，註釋中的部署資訊也包括在內。

註釋是將 meta 資料新增到 Java 類別的標準機制。您可以利用 meta 資料來簡化 Java EE 5 或更新版本構件的開發和部署。在引進 Java 語言註釋之前，部署描述子是 Java EE 元件所用的標準機制。這些部署描述子對映至 XML 格式，有助於持續保存。如果選擇鎖定部署描述子，產品會將 Java EE 註釋型 meta 資料與 XML 型的現有部署描述子 meta 資料合併起來，並且持續保存結果。

當應用程式包含大量的 Java 類別時，註釋的部署處理時間可能會增加。如果要將效能的影響降至最低，您可以使用下列其中一種方法：

決定模組是否需要使用 Java EE 5 或 6。如果模組不需要使用 Java EE 5 或 6，則不會掃描 Java 類別內的註釋。
如果模組使用 Java EE 5 或更新的版本，且不包含任何註釋，請使用模組描述子中的 metadata-complete 屬性。這個屬性會停用模組的註釋處理，但 Java EE 5 或更新版本的模組仍可能放在描述子檔案中。如果您要移轉應用程式，但是不新增註釋，請考慮使用此屬性值。
重組應用程式，將公用程式 Java 保存檔 (JAR) 放入共用程式庫中，不過前題是那些 JAR 檔沒有註釋資訊。如果無法設定 metadata-complete 屬性，請考慮這種方法。
將 WEB-INF/lib 目錄中的 JAR 檔移至企業保存檔 (EAR) 的根目錄。巢狀保存檔，例如在 EAR 檔內的 Web 應用程式保存檔 (WAR) 裡面又有 JAR 檔，因為有多個壓縮層次，因此要在其中仔細搜尋會非常複雜。

模組

指定已安裝（或部署）之應用程式中的模組名稱。

參考資訊	值
資料類型	String

URI

指定模組的位置（相對於 EAR 檔根目錄）。

參考資訊	值
資料類型	String

metadata-complete 屬性

指定是否將完整的模組部署描述子寫成可延伸標記語言 (XML) 格式，註釋中的部署資訊也包括在內。

依預設，不會勾選 metadata-complete 屬性勾選框，因此該產品不會將註釋資料寫出到模組部署描述子。

如果您的模組沒有 metadata-complete 屬性，或 metadata-complete 屬性設為 false，您可以勾選一個勾選框，指示產品將註釋資料寫出到模組部署描述子。

避免困難：如果您的 Java EE 5 或更新版本的應用程式使用註釋和共用程式庫，請不要選取 metadata-complete 屬性。當應用程式使用註釋和共用程式庫時，若將 metadata-complete 屬性設為 true，會使得產品在部署描述子中將 @EJB 註釋不正確地呈現為 <ejb-ref>，而不是 <ejb-local-ref>。如果是 Web 模組，將 metadata-complete 屬性設為 true，可能導致發生 InjectionException 錯誤。如果您必須勾選 metadata-complete 屬性（將 metadata-complete 屬性設為 True），請利用下列方法來避免發生錯誤：不使用共用程式庫、將共用程式庫置於應用程式伺服器的 classes 或 lib 目錄下，或者在部署描述子中完整指定 meta 資料。gotcha

選取勾選框之後，您便無法取消選取（清除）這個勾選框，模組不會再出現於這個頁面的模組清單中。如果您選取所有勾選框，這個頁面的鏈結將不再出現於企業應用程式設定頁面中。

參考資訊	值
資料類型	布林
預設值	false（取消選取）

檔名： urun_rapp_metadata_lockdd.html