JBoss3学习笔记

目 录

一． 运行环境 二． 准备工作 三． 安装 四． 配置实例xPetStore

• 1. 创建JBOSS“xpetstore”服务
• 2. 配置JMS
• 3. 配置JDBC
• 4. 配置JavaMail
• 5. 启动JBOSS
• 6. 指定xPetStore的应用服务器
• 7. 指定数据库
• 8. Build源代码
• 9. 发布应用
• 10. 初始化数据库
• 11. 运行应用
• 12. 意外错误排除

五． 结束语

--------------------------------------------------------------------------------

一． 运行环境
操作系统：Windows 2000

应用服务器：Jboss3.x

数据库：MySQL4.x

虚拟机： SUN JDK1.4.x

--------------------------------------------------------------------------------

二． 准备工作
1．请安装JDK1.4.x版本，设置JAVA_HOME变量，并把 “{%JAVA_HOME%}/bin” 加入Path中。

2．请下载Jboss3.x。主站地址 http://www.jboss.org/ 。

3．请下载并安装MySQL4.x。主站地址 http://www.mysql.org/ 。

4. 请下载xpetstore3.x。主页地址 http://xpetstore.sourceforge.net/ 。

--------------------------------------------------------------------------------

三． 安装
1． 把压JBOSS下载文件解压。本文假设解压后路径为 C:/Work/jboss-3.2.2RC2。

2． 设置JBOSS_HOME变量。进行命令窗口，运行bin目录下的run.bat命令。请注意后台有没有抛出异常。

3． 约半分钟后启动完毕，请访问 http://localhost:8080/jmx-console/ 。如果成功显示页面，说明安装成功。

4． 进行命令窗口，运行bin目录下的 shutdown.bat -S 命令可以停止JBOSS。

--------------------------------------------------------------------------------

四． 配置实例xPetStore
1. 创建JBOSS“xpetstore”服务
在JBOSS_HOME/server/下新建目录xpetstore，并把JBOSS_HOME/server/default下的内容拷贝到xpetstore下。

2. 配置JMS
Create JBOSS_HOME/server/xpetstore/deploy/jms/jbossmq-destinations-xpetstore-service.xml to create JMS queues queue/order and queue/mail.

This xml file should look like this:

     queue/order jboss.mq:service=DestinationManager   queue/mail jboss.mq:service=DestinationManager  
3. 配置JDBC
Copy the JDBC driver to JBOSS_HOME/server/xpetstore/lib。

Create JBOSS_HOME/server/xpetstore/deploy/mysql-ds.xml. (Do NOT change the hsqldb-ds.xml, keep it.)

Edit mysql-ds.xml to create the datasource java:/xpetstoreDS。

JBOSS_HOME/server/xpetstore/deploy/mysql-ds.xml should look like this:

    xpetstoreDS jdbc:mysql://localhost/xpetstore com.mysql.jdbc.Driver thatway thatway 5 HsqlDbRealm  
4. 配置JavaMail
Create the Mail-Sesion java/:Mail.

Make sure that JBOSS_HOME/server/xpetstore/deploy/mail-service.xml look like this:

   Mail your-user-name your-password             
5. 启动JBOSS
cd JBOSS_HOME/bin run.bat -c xpetstore
6. 指定xPetStore的应用服务器
Download and unzip the xpetstore3.1.x file.

Edit the file XPETSTORE_HOME/conf/as/appserver.properties and set the property app.server=jboss. You may want to review XPETSTORE_HOME/conf/as/jboss.properties to make sure that all the properties are properly set.

7. 指定数据库
Edit the file XPETSTORE_HOME/conf/db/database.properties and set the property db.name=mysql.

Edit the file XPETSTORE_HOME/conf/db/mysql.properties to configure the database.You must set the following properties:

db.driver db.url db.user db.password db.classpath
PS: Don't change the hibernate properties.

8. Build源代码
cd XPETSTORE_HOME/xpetstore-servlet , run build.bat :

build.bat
This command will :

Generate Java code in XPETSTORE_HOME/xpetstore-servlet/build/java

Generate the deployment descriptors at XPETSTORE_HOME/xpetstore- servlet/build/META-INF and XPETSTORE_HOME/xpetstore- servlet/build/WEB-INF

Compile the source code and build .jar, .war and .ear files at XPETSTORE_HOME/dist

经测试，事实上这样build是不足够的，在发布运行的过程中会出错。但考虑到官方文件是这样说的，并且这些的确是正确的主要步骤。之所以不能运行，完全是“意外”问题。因此，我们暂且跳过，到运行时再把步骤补全。

9. 发布应用
build.bat deploy
10. 初始化数据库
build.bat db
11. 运行应用
http://localhost:8080/xpetstore-servlet/

12. 意外错误排除
第一次build的过程会抛出xpetstore-servlet/build/META-INF not found的错误。此时，可以手工在相应目录建立META-INF文件夹。再运行build。

再发布时会抛出错误：Exception processing TLD at resource path /META-INF/taglib.tld。此时，可以手工将XPETSTORE_HOME/lib/main/com.opensymphony.module.webwork/webword.jar/META-INF中的taglib.tld 拷贝到XPETSTORE_HOME/xpetstore-servlet/web/META-INF目录下。（META-INF是手工建立的）。再编辑XPETSTORE_HOME/xpetstore-servlet/build.xml，在“WAR”栏加入以下语句把taglib.tld拷贝进war中。再运行build。

     
发布时还会提出错误，主要原因是Hibernate getConnection时不能通过JBOSS的安全验证。此时，要修改JBOSS_HOME/server/xpetstore/conf/login_config.xml和JBOSS_HOME/server/xpetstore/deploy/mydql_ds.xml。

先说login_config.xml。参照HsqlDbRealm段，添加如下代码。

        jboss.jca:service=LocalTxCM,name=xpetstoreDS    
再到mysql_ds.xml。修改security-domain值。

MysqlDbRealm

注意1：修改login-config.xml需要重启JBOSS才生效；修改mysql.xml则不必。

注意2：调试的过程中必然会多次重启JBOSS，如果xpetstore还没有发布成功的话，重启前请删除deploy目录下的xpetstore发布文件。

五． 结束语
至此，我们的痛苦就结束了。请访问 http://localhost:8080/xpetstore-servlet/ 看一看自己辛劳的成果。

此番配置有两个目的，一是熟悉JBOSS，二是便于学习xpetstore源代码。第一个目标我们是达到了，但第二个目标现在才开始，所以让我们一起共勉，继续努力。