部署規劃是指僅包含特定於 Application Server 的部署描述元的 JAR 檔案。有關這些部署描述元 (例如 sun-application.xml) 的說明,請參閱「Application Server Developer’s Guide」。部署規劃是「JSR 88: J2EE Application Deployment」實作的一部分。使用部署規劃可以部署不包含特定於 Application Server 的部署描述元的應用程式或模組。
若要使用部署規劃進行部署,請指定 asadmin deploy 指令的 --deploymentplan 選項。例如,以下指令將根據 mydeployplan.jar 檔案中指定的規劃來部署 myrosterapp.ear 檔案中的企業應用程式。
$ asadmin deploy --user admin ---deploymentplan mydeployplan.jar myrosterapp.ear |
在企業應用程式 (EAR) 的部署規劃檔案中,sun-application.xml 檔案位於根目錄下。根據以下語法來儲存每個模組的部署描述元:module-name.sun-dd-name,其中 sun-dd-name 取決於模組類型。如果模組包含 CMP 對映檔案,則該檔案命名為 module-name.sun-cmp-mappings.xml。.dbschema 檔案儲存在根層級目錄下,並用磅符號 (#) 替代每個正斜線字元 (/)。下面列示的內容顯示了企業應用程式 (EAR) 的部署規劃檔案的結構。
$ jar -tvf mydeployplan.jar 420 Thu Mar 13 15:37:48 PST 2003 sun-application.xml 370 Thu Mar 13 15:37:48 PST 2003 RosterClient.war.sun-web.xml 418 Thu Mar 13 15:37:48 PST 2003 roster-ac.jar.sun-application-client.xml 1281 Thu Mar 13 15:37:48 PST 2003 roster-ejb.jar.sun-ejb-jar.xml 2317 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.sun-ejb-jar.xml 3432 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.sun-cmp-mappings.xml 84805 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.RosterSchema.dbschema
在 Web 應用程式或模組檔案的部署規劃中,特定於 Application Server 的部署描述元位於根層級目錄下。如果獨立 EJB 模組包含 CMP Bean,則部署規劃包括位於根層級目錄的 sun-cmp-mappings.xml 和 .dbschema 檔案。在下面列示的內容中,部署規劃介紹了 CMP Bean。
$ jar r -tvf myotherplan.jar 3603 Thu Mar 13 15:24:20 PST 2003 sun-ejb-jar.xml 3432 Thu Mar 13 15:24:20 PST 2003 sun-cmp-mappings.xml 84805 Thu Mar 13 15:24:20 PST 2003 RosterSchema.dbschema