程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> JAVA編程 >> J2EE >> 在JBoss AS7中進行項目部署

在JBoss AS7中進行項目部署

編輯:J2EE

AS7的項目部署方式與原有版本相比有了較大變化,本文通過實例來講解AS7中的項目部署方式。

有關JBoss AS7的下載和安裝,請參考藍點上面的另一篇文章:

http://bluedash.Net/spaces/JBoss%20AS%207%20快速上手

部署一個簡單的Web項目

下載安裝完成後,我們用standalone方式來啟動JBoss AS7:

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/bin$ ./standalone.sh 

啟動後,我們試著向AS7中部署一個簡單的項目。首先使用Maven來創建一個簡單的Web工程:

  1. mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp 

生成的項目如下:

.
|-- pom.xml
`-- src
    `-- main
        |-- resources
        `-- webapp
            |-- WEB-INF
            |   `-- web.XML
            `-- index.JSP

使用如下命令將項目打成WAR包:

  1. mvn package 

得到war:

target
`-- my-webapp.war

接下來,我們將這個war部署進AS7。在AS7的根目錄下,有一個名為'standalone'的目錄,當AS7以standalone模式運行時,我們要將項目部署到這裡面,進入到standalone目錄:

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1$ cd standalone 
  2. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone$ ls 
  3. configuration deployments   log 
  4. data          lib           tmp 
  5. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone$  

standalone目錄中包含許多運行所需的內容,比如'configuration'目錄包含了服務器的有關配置,我們稍後會進行說明。現在我們要關心的是'deployments'目錄,我們要將需要部署的項目放在這裡,JBoss AS7會自動掃描這個目錄並進行部署。我們將剛剛制作好的my-webapp.war拷貝至deployments目錄:

  1. liweinan@smart:~/projs/my-webapp/target$ cp my-webapp.war ~/proJS/jboss-7.0.0.CR1/standalone/deployments/ 

此時查看AS7的日志輸出:

  1. 16:12:33,822 INFO  [org.jboss.as.server.deployment] (MSC service thread 1-6) Starting deployment of "my-webapp.war" 
  2. 16:12:36,616 INFO  [org.jboss.web] (MSC service thread 1-4) registering web context: /my-webapp 
  3. 16:12:36,740 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "my-webapp.war" 

從日志中可以看出,項目被成功地部署進了AS7。我們試著訪問下已部署的服務:

可以看到部署成功。

AS7中項目的自動部署及手工部署

我們在上一節通過將項目拷貝至deployments目錄,就實現了AS7對項目的自動掃描及自動部署。實際上AS7還支持手工的部署模式,這樣,我們就可以控制項目的部署及啟動時機。配置AS7的部署模式有兩種方式:一個是通過在配置文件指定,另一個是在AS7運行時,通過管理端來進行實時的配置。

我們首先來看一下配置文件中的內容,JBoss AS7相對以前版本比較,大大簡化了精減了配置文件的數量。原來的*-ds.XML等數據庫的配置文件,都被合並至了統一的配置文件:standalone.XML[3] 。這個文件位於剛才提到的/standalone/configuration目錄當中,詳細講解這個配置文件也不是這篇文章要關注的地方,因此我們只需要了解一下這個配置文件中,與部署有關的這段內容:

  1. <subsystem XMLns="urn:jboss:domain:deployment-scanner:1.0"> 
  2.    <deployment-scanner scan-interval="5000"  
  3.       relative-to="jboss.server.base.dir" path="deployments" /> 
  4. </subsystem> 

可以看到,配置中指定deployment-scanner去掃描deployments目錄,掃描間隔為5秒鐘。

除了在配置文件中進行配置,我們也可以在AS7實時運行時,通過管理端來改變AS7的部署方式。首先是登錄到管理端,使用AS7中bin目錄中帶有的管理端連接程序jboss-admin.sh

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/bin$ ./jboss-admin.sh  
  2. You are disconnected at the moment. Type 'connect' to connect to the server or 'help' for the list of supported commands. 
  3. [disconnected /] connect 127.0.0.1 
  4. Connected to standalone controller at 127.0.0.1:9999 
  5. [[email protected]:9999 /]  

連接成功後,我們可以查看當前的scanner配置:

  1. [[email protected]:9999 /] /subsystem=deployment-scanner:read-resource(recursive=true) 
  2.     "outcome" => "success", 
  3.     "result" => {"scanner" => {"default" => { 
  4.         "auto-deploy-exploded" => false, 
  5.         "auto-deploy-zipped" => true, 
  6.         "deployment-timeout" => 60L, 
  7.         "name" => "default", 
  8.         "path" => "deployments", 
  9.         "relative-to" => "jboss.server.base.dir", 
  10.         "scan-enabled" => true, 
  11.         "scan-interval" => 5000 
  12.     }}} 

如上所示,和配置文件中對應的配置是一致的。我們可以移除這個自動掃描的scanner:

  1. [[email protected]:9999 /] /subsystem=deployment-scanner/scanner=default:remove 
  2. {"outcome" => "success"} 

此時再次查看:

  1. [[email protected]:9999 /] /subsystem=deployment-scanner:read-resource(recursive=true) 
  2.     "outcome" => "success", 
  3.     "result" => {"scanner" => undefined} 

自動部署用的scanner已經被移除了。此時,我們將只可以用命令來手工部署所需項目,下面是手工部署的命令:

  1. [[email protected]:9999 /] deploy /Users/liweinan/proJS/my-webapp/target/my-webapp.war 
  2. 'my-webapp.war' deployed successfully. 

實驗完成後,我們將剛剛移除的自動部署掃描器恢復回來:

  1. [[email protected]:9999 /] /subsystem=deployment-scanner/scanner=default:add(scan-interval=5000,relative-to="jboss.server.base.dir",path="deployments") 
  2. {"outcome" => "success"} 

這樣,AS7又可以自動掃描deployments目錄下面的項目,並進行自動部署了。實際上,AS7支持用戶添加多個scanner,每一個scanner都可以獨立配置,掃描不同的目錄,設置不同的掃描間隔。通過上面的命令舉一反三即可按照實際需求進行配置。

在AS7中部署一個J2EE項目

接下來我們試著將一個完整的J2EE項目部署進AS7,這個項目包括:

◆ 數據層,使用Hibernate及JPA Annotation來建模,後面連接AS7的數據源

◆ 邏輯層,使用JBoss Seam,EJB3來實現

◆ 表現層:使用JSF

◆ WebService:使用RESTEasy來實現

上面所使用的Hibernate, Seam,RESTEasy等模塊,都是AS7中的默認配置,不需要額外進行配置,因此我們使用這樣的一種技術架構。這個項目看起來用了不少東西,似乎很復雜,其實JBoss社區已經給我們做好了一個demo工程,使用到了上面的所有框架,我們把它直接拿過來用[2] ,使用下面的命令來創建這個項目:

  1. mvn archetype:generate -DarchetypeArtifactId=jboss-Javaee6-webapp -DarchetypeGroupId=org.jboss.weld.archetypes -DarchetypeVersion=1.0.1.Beta1 -DgroupId=net.bluedash -DartifactId=demo -Dversion=1.0-SNAPSHOT 

有關這個項目的詳細解說,在此就不展開了,Weld、EJB3、Hibernate的使用並不是本文的重點,我們仍然把注意力放在AS7的項目部署方面。總之,現在給這個項目進行打包:

  1. mvn package 

需要特別注意的是,編譯這個項目需要Maven的版本至少在3.0以上,2.x是無法正確編譯的,如果你的Maven版本過低,要注意更新版本至Maven 3。

打包完成後,我們將項目拷貝至deployments目錄進行自動部署:

  1. liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ cp /Users/liweinan/proJS/demo/target/demo.war . 

此時服務器日志輸出如下:

  1. 19:31:32,574 INFO  [org.jboss.as.controller] (DeploymentScanner-threads - 2) Service status report 
  2.    New missing/unsatisfied dependencIEs: 
  3.       service jboss.naming.context.Java.jdbc/__default (missing) 

服務器報錯說沒有找到__default這個數據源。這是由於我們在項目中沒有使用AS7中存在的數據源造成的。我們首先要知道AS7中的數據源配置在哪裡,在上一節我們已經了解到,當服務器運行於standalone模式的時候,大部分的配置集中保存在standalone/configuration/standalone.XML當中,我們打開這個文件,看一下數據源配置方面的內容:

  1. <subsystem XMLns="urn:jboss:domain:datasources:1.0"> 
  2.     <datasources> 
  3.         <datasource jndi-name="Java:jboss/datasources/ExampleDS" pool-name="H2DS" enabled="true" jta="true" use-Java-context="true" use-ccm="true"> 
  4.  
  5.         </datasource> 
  6.     </datasources> 
  7. </subsystem> 

可以看到,AS7默認自帶了一個數據源,綁定在Java:jboss/datasources/ExampleDS這個JNDI名稱之上,我們要在demo項目中使用這個數據源。打開demo項目中的數據源配置文件:

  1. liweinan@smart:~/proJS/demo$ vi src/main/resources/META-INF/persistence.XML  

將其中的JNDI數據源配置內容:

  1. <jta-data-source>jdbc/__default</jta-data-source> 

修改成AS7中提供給我們的數據源:

  1. <jta-data-source>Java:jboss/datasources/ExampleDS</jta-data-source> 

保存後,使用mvn package命令將項目重新打包,然後將新的項目的war拷貝到AS7的deployments目錄。但是在拷貝之間請稍等一下!我們看一下目前deployments目錄中的內容:

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone/deployments$ ls 
  2. README.txt      demo.war        demo.war.failed 

可以看到,此時deployments目錄中有一個demo.war.failed文件,這個文件被稱為 "Mark File",即標記文件,它的文件名與項目文件名相同,但同時帶有一個後綴。AS7用這樣的Mark File來完成兩個任務,一個是表示待部署項目的狀態,另一個是在自動部署的基礎上,給用戶提供一些手工控制部署的能力。此時的demo.war.failed這個Mark File顯然是表示狀態的,failed說明demo.war剛剛部署失敗的情況。

理解了Mark File,我們可以將新的war拷貝至deployments目錄了:

  1. liweinan@smart:~/projs/jboss-7.0.0.CR1/standalone/deployments$ cp /Users/liweinan/proJS/demo/target/demo.war . 

拷貝完成後,就把deployments目錄裡面之前有問題的demo.war給覆蓋掉了。此時AS7是不會自動重新部署這個項目的,這是出於可靠性考慮,AS7不會未經用戶明確指定,就把一個已有的同名項目的部署狀態覆蓋掉,即使它是部署失敗的。此時我們就要用Mark File來控制AS7的部署了,我們建立一個名為demo.war.dodeply的空文件,使AS7重新部署demo.war這個項目:

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone/deployments$ touch demo.war.dodeploy 

此時,AS7便開始重新部署項目了。如果你的手足夠快,此時看一下deployments中的內容

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone/deployments$ ls 
  2. README.txt           demo.war.dodeploy    demo.war.isdeploying 
  3. demo.war             demo.war.failed 

會發現多出一個demo.war.isdeploying,表明項目正在部署。等部署完成後,deployments目錄中的內容就變成了:

  1. liweinan@smart:~/proJS/jboss-7.0.0.CR1/standalone/deployments$ ls 
  2. README.txt        demo.war          demo.war.deployed 

這樣,新的項目便部署完成了,如果沒有操作上的失誤的話,這個項目已經可以可以訪問到了:

小結

本文講解了AS7下面的自動部署、手工部署的方法,同時講解了管理端下面與部署相關的一些命令,以及standalone.XML配置文件中的一些內容;最後,我們講解了Mark File的使用方法。希望通過本文,可以幫助大家進行AS7更為深入的學習和使用。

備注

[1] JBoss AS7 包含standalone及domain兩種運行方式。有關JBoss AS7的domain運行方式,請參考藍點上面的這篇文章:

http://bluedash.Net/spaces/JBoss%20AS7中的新概念-域

[2] 關於這個項目的詳細說明,請參考藍點上面的另一篇文章:

http://bluedash.Net/spaces/Java%20EE%206%20入門

[3] domain運行模式下面的配置模式有所不同,請參考這篇文章:

http://bluedash.Net/spaces/JBoss%20AS7中的新概念-域

[4] 如果要對AS7的部署進行更深入的了解和學習,需要參考AS7的管理員手冊的相關章節:

https://docs.jboss.org/author/display/AS7/Admin+Guide#AdminGuide-DeploymentScanner

原文鏈接:http://bluedash.iteye.com/blog/1282169

【編輯推薦】

  1. 揭開Java EE開發框架之謎
  2. 紅帽的PaaS平台OpenShift支持Java EE 6
  3. 簡單介紹Java EE容器
  4. 詳細介紹Java EE開發四大常用框架
  5. 初學者如何開發出高質量Java EE系統
【責任編輯:小林 TEL:(010)68476606】
  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved