JBoss技術支持文檔（一）

　　本節內容簡介

　　本章主要介紹JBOSS（免費的EJB服務器）以及教會大家如何安裝Jboss建立你第一個EJB和客戶端關於什麼是EJB以及如何開發等這些關於EJB方面有很多書籍進行描述在此不再闡述描述信息是運行在windows平台當然你可以應用在其他支持的平台（如Linux等）
　　關於JBOSS

　　Jboss支持EJB 和EJB 的規范它是一個為管理EJB的容器和服務器類似於Suns JSDK Enterprise Edition（JEE）但是Jboss核心服務僅是提供EJB服務器JBOSS不包括serverlers/JSP page 的WEB容器當然可以和Tomcat或Jetty綁定使用JBOSS需要比較小的內存和硬盤空間可以在M內存以及幾兆空間上很好的運行而Suns JEE需要最少內存為M以及M硬盤空間JBOSS啟動速度要比JEE快倍而且它能內嵌SQL 數據庫服務器進行持久性BEAN處理當啟動時會自動啟動（JEE裝載分離CloudScape SQL Server）

　　其中一個非常好的特性JBOSS能夠熱部署熱部署的意思就是在部署BEAN只是簡單拷貝BEAN的JAR文件到部署路徑下如果BEAN已被LOADJBOSS卸載它然後LOAD一個新版本BEAN如果你需
要更多的JBOSS特性你可以查看關於JBOSS論壇的網站如果需要支持可以付費聯系JBossGroup LLC

　　本章一步一步幫助你開始用jboss進行分布式開發如何建立一個簡單的BEAN以及如何在jboss服務器上部署和在測試

　　必備條件

　　JBOSS是一個純JAVA編寫的需要一個JAVA系統和JDK兼容為了能便宜和運行所有的例子你需要有Ant 或以上版本在下節將會介紹如何獲得和安裝當然你要有開發EJB基礎
　　安裝ANT

　　我們在很多書上以及網頁可能都看見過這個名字到底它用來作什麼的呢？Ant 是一個基於java的build工具現在已經有了許多的build工具例如makegnumakenmakejam等而且這些工具都非常優秀Ant是一個跨平台的Build工具之所以Ant能跨平台是因為Ant不再需要你編寫shell命令Ant的配置文件是基於XML的任務樹能讓你運行各種各樣的任務任務的運行是由實現了特定任務接口的對象來完成的
有兩個版本Binary和Source 可以下載最新版本

Binary版 releases/v/binaries/
Source版releases/v/source/

　　關於這兩個版本的不同之處可以參考 如果下載不了可以向我索取QQ: Email:

　　在下載完Ant後你解壓文件全部文件會放在一個apacheant路徑下Ant文檔會釋放在
docs/manual目錄下你可以打開網頁docs/manual/l來浏覽關於ant文檔的內容 我用Windows系統釋放在c:/apacheant路徑下

　　） 設置ANT_HOME環境變量指向你的ANT目錄

　　） 需要設置JAVA_HOME環境變量指向你的JDK目錄

　　） 將%ANT_HOME%\bin加入到PATH環境變量中

　　） 當你不帶任何參數運行ant時Ant會在當前目錄找一個名叫buildxml的文件如果沒找到會有以下提示

Buildfile : buildxml does not exist!Build failed

　　為了測試ANT安裝是否成功我建立了一個新的buildxml文件放在當前的目錄下%ANT_HOME%\samplesBuildxml內容如下


＜! Simple Ant build script to test an Ant installation ＞＜br /＞
＜project name=TestInstall default=run basedir=＞＜br /＞
＜target name=init＞  ＜br /＞
＜available file=ASimpleHelloObjectjava property=ASimpleHelloObject/＞ ＜br /＞
＜/target＞ ＜br /＞
＜target name=ASimpleHelloObject unless=ASimpleHelloObject depends=init＞ ＜br /＞
＜echo file=ASimpleHelloObjectjava＞＜br /＞
public class ASimpleHelloObject＜br /＞
{＜br /＞
public static void main(String[] args) { ＜br /＞
Systemoutprintln(ASimpleHelloObjectmain was called); }＜br /＞
}＜br /＞
＜/echo＞ ＜br /＞
＜echo message=Wrote ASimpleHelloObjectjava /＞ ＜br /＞
＜/target＞ ＜br /＞
＜target name=compile depends=ASimpleHelloObject＞ ＜br /＞
＜javac destdir= srcdir= debug=on classpath=＞ ＜br /＞
＜include name=ASimpleHelloObjectjava/＞ ＜br /＞
＜/javac＞ ＜br /＞
＜/target＞ ＜br /＞
＜target name=run depends=compile＞ ＜br /＞
＜java classname=ASimpleHelloObject classpath= /＞ ＜br /＞
＜echo message=Ant appears to be successfully installed /＞ ＜br /＞
＜/target＞＜br /＞
＜/project＞＜br /＞

　　運行ant 顯示結果如下


c:\apacheant\samples＞ antBuildfile: buildxml
Init :
AsimpleHelloObject:
[echo] Wrote AsimpleHelloObjectjava
compile:
[javac] Compiling source file to c:\apacheant\samples
run :
[java] AsimpleHelloObjectmain was called[echo] Ant appears to be successfully installed
BUILDE SUCCESSFUL
Total time : seconds

　　到此你安裝的ANT以及環境已經設置成功如果有以下警告
Warning: JAVA_HOME environment variable is not set If build fails because sun* classes could not be found you will need to set the JAVA_HOME environment variable to the installation directory of java

　　表示你需要設置JAVA_HOME環境指定你安裝的JDK 目錄如何運用Ant 中的各種命令我會在以後編寫《ANT文檔》介紹
　　安裝JBOSS

　　) 在安裝和運行JBoss 之前你必須檢查是否安裝了JDK需要在PATH環境中設置JDK的目錄

　　) 下載JBoss 服務器JBoss 是一個壓縮文件你可以下載最新版本為了能支持Web Server我用的是Windows平台所以下載了jbosstomcat你可以到 中直接下載如果你使用的是Unix/Lunix平台也可以從這個網址下載相應的JBoss 服務器

　　)安裝

　　() Lunix/Unix下安裝

　　a 你下載了對於Unix/Lunix版本的JBoss 服務器l 用JDK 的JAR工具來解壓文件到一個臨時目錄

　　b 設置JBOSS_DIST指向JBoss 解壓後最頂級目錄

　　c 然後到此目錄下

cd JBOSS_DIST/bin
sh runshl

　　運行完後顯示信息如下

bash$ /bin/sh runsh
JBOSS_CLASSPATH=:runjar:/lib/crimsonjar
jbosshome = /tmp/JBoss
Using JAAS LoginConfig: file:/tmp/JBoss/conf/default/nf
Using configuration default
[Info] Java version: Sun Microsystems Inc
[Info] Java VM: Java HotSpot(TM) Server VM bSun Microsystems Inc
[Info] System: Linux i
[Shutdown] Shutdown hook added
[Service Control] Registered with server
[Service Control] Initializing MBeans

[Service Control] Started services
[Default] JBoss Started in m:s

　　() Windows下安裝

　　a 下載jbosstomcatzip 然後用winzip解壓到一個目錄我解壓在c:\jbosstomcat目錄

　　b 解壓後基本上不需要配置運用bin目錄下的runbat命令

　　c 運行runbat命令請看後台有沒有什麼異常拋出

　　d 運行成功請訪//localhost:將會出現空白頁訪//localhost:將會出現Tomcat的歡迎頁面如果出現Apache Tomcat/ HTTP Status No Context configured to process this request的錯誤這是正常的因為你還沒有發布ear或war應用當然jbossORC_tomcatzip不會出現這樣的問題因為在目錄server\default\deploy\中自帶了web測試文件webtestear 訪//localhost:你可以看到Jboss起動的服務你可以運//localhost:/jmxconsole就會出現相關頁面

　　() Window NT 和補充

　　對於NT和Wink系統如果你要安裝NT或Wink服務的話可以把jboss加在系統服務中避免你每次需要到jboss目錄下運行runbat命令只是當系統啟動時自動啟動jboss服務器

　　a 首先你需要下載javaserviceexe文件l 編輯一個批處理文件自己命名文件名存入和JavaServiceexe相同的目錄我命名為Jboss_Tomcat_Servicebat此文件的內容@echo offecho
echo Usage: % jdk_home tomcat_home (classic/hotspot/server)echo NOTE: You MAY NOT use spaces in the path names If you know howecho to fix this please tell meecho JDK does not come with hotpot server by default
you mustecho install this seperately if you wish to use itecho Example: % \jdk \jboss hotspot
echo
if % == uninstall goto uninstall
if % == uninstall goto uninstall
if % == goto usage
if % == goto usage
if % == goto usage
if % == help goto usage
if % == ? goto usage
if % == /? goto usage
:install
JavaServiceexe install JBoss %\jre\bin\%\jvmdll Djavaclasspath=%\lib\toolsjar;%\bin\runjar start orgjbossMain stop orgjbossMain method systemExit out %\bin\outtxt current %\bin goto eof
:uninstall
JavaServiceexe uninstall JBoss
goto eof
:usage
echo To Install JBoss do
echo Usage: % jdk_home jboss_home (classic/hotspot/server)
echo NOTE: You MAY NOT use spaces in the path names If you know how echo to fix this please tell me
echo JDK does not come with hotpot server by default
  you must echo install this seperately if you wish to use it
echo Example: % \jdk \jboss hotspot
echo
echo To Uninstall JBoss do
echo Usage: % uninstall echo
goto eof
:eof

　　e 運行以下命令

Jboss_Tomcat_Service C:\jsdk_ C:\jboss_tomcat server
其中C:\jsdk_是java安裝的目錄 C:\jboss_tomcat是Jboss安裝的目錄server是不變的參數

　　f將會看到安裝成功的命令你到wink或NT的Service中看我可以看Jboss的服務你可以正常的起動它然後再查看各種網頁（同windows安裝相同）如果成功到此恭喜你你安裝了JBoss服務器

　　（）問題

　　如果在在安裝了服務網頁顯示不正確你需要多試幾次首先運行
Jboss_Tomcat_Service uninstall

　　然後再運行

Jboss_Tomcat_Service C:\jsdk_ C:\jboss_tomcat server
From:http://tw.wingwit.com/Article/program/Java/ky/201311/28067.html