JBoss技术支持文档（一）

　　1、本节内容简介

　　本章主要介绍JBOSS（免费的EJB服务器），以及教会大家如何安装Jboss，建立你第一个EJB和客户端。关于什么是EJB，以及如何开发等。这些关于EJB方面有很多书籍进行描述，在此不再阐述。描述信息是运行在windows平台，当然你可以应用在其他支持的平台（如：Linux等）。

　　2、关于JBOSS

　　Jboss支持EJB 1.1和EJB 2.0的规范，它是一个为管理EJB的容器和服务器。类似于Sun’s J2SDK Enterprise Edition（J2EE），但是Jboss核心服务仅是提供EJB服务器。JBOSS不包括serverlers/JSP page 的WEB容器，当然可以和Tomcat或Jetty绑定使用。JBOSS需要比较小的内存和硬盘空间。可以在64M内存以及几兆空间上很好的运行。而Sun’s J2EE需要最少内存为128M，以及31M硬盘空间。JBOSS启动速度要比J2EE快10倍。而且它能内嵌SQL 数据库服务器进行持久性BEAN处理，当启动时会自动启动。（J2EE装载分离CloudScape SQL Server）。

　　其中一个非常好的特性JBOSS能够“热”部署，“热”部署的意思就是在部署BEAN只是简单拷贝BEAN的JAR文件到部署路径下，如果BEAN已经被LOAD，JBOSS卸载它，然后LOAD一个新版本BEAN。如果你需要更多的JBOSS特性，你可以查看关于JBOSS论坛的网站。如果需要支持，可以付费联系JBossGroup LLC。

　　本章一步一步帮助你开始用jboss进行分布式开发：如何建立一个简单的BEAN，以及如何在jboss服务器上部署和在测试。

　　3、必备条件

　　JBOSS是一个纯JAVA编写的，需要一个JAVA系统和JDK1.3兼容。为了能便宜和运行所有的例子，你需要有Ant 1.4或以上版本。在下节将会介绍如何获得和安装。当然你要有开发EJB基础。
　　4、安装ANT

　　我们在很多书上以及网页可能都看见过这个名字，到底它用来作什么的呢？Ant 是一个基于java的build工具。现在已经有了许多的build工具，例如make、gnumake、nmake、jam等，而且这些工具都非常优秀。Ant是一个跨平台的Build工具。之所以Ant能跨平台，是因为Ant不再需要你编写shell命令，Ant的配置文件是基于XML的任务树，能让你运行各种各样的任务，任务的运行是由实现了特定任务接口的对象来完成的。
有两个版本Binary和Source 可以下载最新版本1.5.2。

Binary版： http://ant.apache.org/old-releases/v1.5.2/binaries/
Source版：http://ant.apache.org/old-releases/v1.5.2/source/

　　关于这两个版本的不同之处可以参考http://ant.apache.org/ 。如果下载不了可以向我索取QQ:182244794, Email: [e-mail] 。

　　在下载完Ant后，你解压文件，全部文件会放在一个apache-ant-1.5.2路径下。Ant文档会释放在docs/manual目录下，你可以打开网页docs/manual/index.html来浏览关于ant文档的内容。 我用Windows系统释放在c:/apache-ant-1.5.2路径下。

　　1） 设置ANT_HOME环境变量，指向你的ANT目录。

　　2） 需要设置JAVA_HOME环境变量，指向你的JDK目录。

　　3） 将%ANT_HOME%\bin加入到PATH环境变量中。

　　4） 当你不带任何参数运行ant时，Ant会在当前目录找一个名叫build.xml的文件。如果没找到，会有以下提示：

Buildfile : build.xml does not exist!Build failed

　　为了测试ANT安装是否成功，我建立了一个新的build.xml文件，放在当前的目录下%ANT_HOME%\samples。Build.xml内容如下：

＜!-- Simple Ant build script to test an Ant installation --＞＜br /＞
＜project name="TestInstall" default="run" basedir="."＞＜br /＞
＜target name="init"＞ ＜br /＞
＜available file="ASimpleHelloObject.java" property="ASimpleHelloObject"/＞ ＜br /＞
＜/target＞ ＜br /＞
＜target name="ASimpleHelloObject" unless="ASimpleHelloObject" depends="init"＞ ＜br /＞
＜echo file="ASimpleHelloObject.java"＞＜br /＞
public class ASimpleHelloObject＜br /＞
{＜br /＞
public static void main(String[] args) { ＜br /＞
System.out.println("ASimpleHelloObject.main was called"); }＜br /＞
}＜br /＞
＜/echo＞ ＜br /＞
＜echo message="Wrote ASimpleHelloObject.java" /＞ ＜br /＞
＜/target＞ ＜br /＞
＜target name="compile" depends="ASimpleHelloObject"＞ ＜br /＞
＜javac destdir="." srcdir="." debug="on" classpath="."＞ ＜br /＞
＜include name="ASimpleHelloObject.java"/＞ ＜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:\apache-ant-1.5.2\samples＞ antBuildfile: build.xml
Init :
AsimpleHelloObject:
[echo] Wrote AsimpleHelloObject.java
compile:
[javac] Compiling 1 source file to c:\apache-ant-1.5.2\samples
run :
[java] AsimpleHelloObject.main was called[echo] Ant appears to be successfully installed
BUILDE SUCCESSFUL
Total time :11 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文档》介绍。

　　5、安装JBOSS

　　1) 在安装和运行JBoss 之前，你必须检查是否安装了JDK，需要在PATH环境中，设置JDK的目录。

　　2)、 下载JBoss 服务器。JBoss 是一个压缩文件，你可以下载最新版本。为了能支持Web Server，我用的是Windows平台，所以下载了jboss3.0.6-tomcat4.1.18。你可以到http://prdownloads.sourceforge.net/jboss/ 中直接下载。如果你使用的是Unix/Lunix平台也可以从这个网址下载相应的JBoss 服务器。

　　3)、安装

　　(1) Lunix/Unix下安装

　　a、 你下载了对于Unix/Lunix版本的JBoss 服务器l 用JDK 的JAR工具来解压文件到一个临时目录。

　　b、 设置JBOSS_DIST指向JBoss 解压后最顶级目录。

　　c、 然后到此目录下

cd JBOSS_DIST/bin
sh run.shl

　　运行完后显示信息如下：

bash-2.04$ /bin/sh run.sh
JBOSS_CLASSPATH=:run.jar:../lib/crimson.jar
jboss.home = /tmp/JBoss-2.2.2
Using JAAS LoginConfig: file:/tmp/JBoss-2.2.2/conf/default/auth.conf
Using configuration "default"
[Info] Java version: 1.3.1,Sun Microsystems Inc.
[Info] Java VM: Java HotSpot(TM) Server VM 1.3.1-b24,Sun Microsystems Inc.
[Info] System: Linux 2.2.16-22,i386
[Shutdown] Shutdown hook added
[Service Control] Registered with server
[Service Control] Initializing 24 MBeans
...
[Service Control] Started 24 services
[Default] JBoss 2.2.2 Started in 0m:7s

　　(2) Windows下安装

　　a、 下载jboss3.0.6-tomcat4.1.18.zip, 然后用winzip解压到一个目录，我解压在c:\jboss3.0.6-tomcat4.1.18目录

　　b、 解压后基本上不需要配置，运用bin目录下的run.bat命令。

　　c、 运行run.bat命令，请看后台有没有什么异常抛出。

　　d、 运行成功请访问http://localhost:8083将会出现空白页。访问http://localhost:8080将会出现Tomcat的欢迎页面，如果出现Apache Tomcat/4.1.12 - HTTP Status 500 - No Context configured to process this request的错误，这是正常的，因为你还没有发布.ear或.war应用。当然jboss-3.2.ORC3_tomcat-4.1.18.zip不会出现这样的问题，因为在目录server\default\deploy\中自带了web测试文件webtest.ear 访问http://localhost:8082你可以看到Jboss起动的服务。你可以运行http://localhost:8080/jmx-console就会出现相关页面。

　　(3) Window NT 和2000补充

　　对于NT和Win2k系统如果你要安装NT或Win2k服务的话，可以把jboss加在系统服务中，避免你每次需要到jboss目录下运行run.bat命令，只是当系统启动时，自动启动jboss服务器。

　　a、 首先你需要下载javaservice.exe文件。l 编辑一个批处理文件，自己命名文件名，存入和JavaService.exe相同的目录。我命名为Jboss_Tomcat_Service.bat此文件的内容@echo offecho --------
echo Usage: %0 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 me.echo JDK 1.4 does not come with hotpot server by default, you mustecho install this seperately if you wish to use it.echo Example: %0 ..\jdk ..\jboss30 hotspot
echo --------
if "%1" == "uninstall" goto uninstall
if "%1" == "-uninstall" goto uninstall
if "%1" == "" goto usage
if "%2" == "" goto usage
if "%3" == "" goto usage
if "%1" == "-help" goto usage
if "%1" == "-?" goto usage
if "%1" == "/?" goto usage
:install
JavaService.exe -install JBoss306 %1\jre\bin\%3\jvm.dll -Djava.class.path=%1\lib\tools.jar;%2\bin\run.jar -start org.jboss.Main -stop org.jboss.Main -method systemExit -out %2\bin\out.txt -current %2\bin goto eof
:uninstall
JavaService.exe -uninstall JBoss306
goto eof
:usage
echo -------- To Install JBoss 3.0.6 do
echo Usage: %0 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 1.4 does not come with hotpot server by default, you must echo install this seperately if you wish to use it.
echo Example: %0 ..\jdk ..\jboss30 hotspot
echo --------
echo -------- To Uninstall JBoss 3.0.6 do
echo Usage: %0 uninstall echo --------
goto eof
:eof

　　e、 运行以下命令

Jboss_Tomcat_Service C:\j2sdk1.4.0_02 C:\jboss-3.0.6_tomcat-4.1.18 server
其中C:\j2sdk1.4.0_02是java安装的目录 C:\jboss-3.0.6_tomcat-4.1.18是Jboss安装的目录，server是不变的参数

　　f、将会看到安装成功的命令，你到win2k或NT的Service中看我可以看Jboss306的服务，你可以正常的起动它。然后再查看各种网页（同windows安装相同）如果成功，到此恭喜你，你安装了JBoss服务器。

　　（4）问题

　　如果在在安装了服务，网页显示不正确。你需要多试几次，首先运行
Jboss_Tomcat_Service uninstall

　　然后再运行

Jboss_Tomcat_Service C:\j2sdk1.4.0_02 C:\jboss-3.0.6_tomcat-4.1.18 server。