JBoss学习文档

JBoss是一个免费的开源应用服务器，全面支持J2EE，包括JSP，Servlet，EJB和最新的EJB3.0。为了让J2EE开发人员快速熟悉JBoss，本文将带您开始JBoss之旅，包括下载，安装，部署应用程序和配置数据源。
一、 工具准备：
JDK5.0  JBoss4.0.5GA  Ant 1.7
二、 下载：
可以从www.jboss.org获得JBoss。本文选用的是jboss-4.0.5.GA.zip.
三、 安装：
解压压缩包到一个指定的目录，如：E:\ejbdevelop\jboss-4.0.5.GA，解压完成后，应该生成如下目录：
 bin: 命令和脚本
 client: 客户端jars
 docs: JBoss的文档
 lib: 服务器端jars
 server: 服务器配置文件
建立以下环境变量：
 JAVA_HOME：JDK的安装目录
 JBOSS_HOME：JBoss的安装目录
四、 服务器配置
JBoss提供了三种服务器配置：
 Minimal：最小配置，仅仅包括日志，JNDI服务和URL部署扫描器，你可能会在一个不需要J2EE的应用中使用这种配置，或者以该配置为基础自定义配置。
 Default：缺省配置，包括除了RMI/IIOP和集群的所有J2EE服务。
 All：这种配置包括所有的JBoss服务。
五、 启动
为了启动JBoss，在Windows下：
 打开一个命令行窗口；
 键入：cd %JBOSS_HOME%\bin；
 键入：run [-c default|minimal|all]。
在UNIX下：
 打开一个Shell；
 键入：cd $JBOSS_HOME/bin；
 键入：./run [-c default|minimal|all]。
如果JBoss启动成功，你应该可以看到以下输出：
21:11:16,637 INFO [Server] JBoss (MX MicroKernel) [4.0.5 (build: CVSTag=JBoss_4 _0_5 date=200705041533)] Started in 26s:919ms
一旦服务器启动成功，你就可以通过在浏览器中打开http://localhost:8080/jmx-console/来验证所有的J2EE服务是否都启动了。这是JBoss的管理台，它将显示当前配置下JBoss正在运行的所有服务以及每个服务的详细内容。
JBoss也可以作为NT服务或者Unix服务来运行，可以参考“JBoss 4.0 Quick Start Guide”。
六、 关闭
如果在Windows的命令行窗口或者当前的Unix Shell下运行JBoss，只需要简单的按下Ctrl+C即可关闭JBoss。
如果在Windows下不能看见命令行窗口：
 打开一个新的命令行窗口；
 键入：cd %JBOSS_HOME%\bin；
 键入：shutdown –S或者shutdown --server=url。注意参数S为大写。
如果在Unix Shell的后台运行：
 打开一个Shell；
 键入：cd $JBOSS_HOME/bin；
 键入：./shutdown –S或./shutdown --server=url。
七、 管理
JBoss通过一个基于Web的控制台管理，你只需在浏览器中键入：http://localhost:8080/jmx-console/即可。查看或更改某一服务的配置，只需简单的点击链接。
通过控制台，你还可以使用一些服务的公开的方法，例如，关闭服务器：
 打开控制台；
 卷动到“jboss.system”选项；
 点击链接“type=server”；
 卷动到“void shutdown()”选项；
 点击“Invoke”按钮。
八、 部署应用程序
在JBoss中部署应用程序是再简单不过的了。简单的复制你的应用程序打包文件：.jar，.war或者.ear到服务器缺省的部署目录下，如果JBoss正在运行，将检测到文件，自动解压，然后装载应用程序。
以下是将一个应用部署到一个缺省的服务器配置的例子，在Windows下：
复制JBossDukesBank.ear到%JBOSS_HOME%\server\default\deploy
在Unix下：
复制JBossDukesBank.ear到$JBOSS_HOME/server/default/deploy
在部署过程中，JBoss日志将在控制台窗口输出信息并写入日志，日志文件位于服务器的配置目录。如果部署成功，你应该可以看到以下信息：
22:21:44,730 INFO [MainDeployer] Deployed package: file:/ E:/ejbdevelop/jboss-4.0.5.GA /server/default/deploy/ JBossDukesBank.ear
此外，如果你打开JBoss的管理台，可以在“jboss.j2ee”类别下列出你的应用。
九、 取消已部署的应用
取消已部署的应用程序比部署应用程序更简单。只要简单的从部署目录中删除相应的应用程序文件，JBoss就会检测到文件已被删除，然后取消已部署的应用。
取消部署一个应用时，JBoss日志将在控制台窗口显示信息，并记录到服务器日志。如果取消部署成功，你应该可以看到以下信息：
22:59:41,500 INFO [MainDeployer] Undeployed file:/ E:/ejbdevelop/jboss-4.0.5.GA /server/default/deploy/ JBossDukesBank.ear
十、 数据源
如果你的应用程序将连接到数据库，你可能需要为数据库配置一个数据源。以下是如何配置一个简单的数据源：
如果你使用的数据库JDBC驱动没有在服务器的lib目录中，复制驱动程序到此目录，然后重新启动JBoss。
为你的数据库创建一个数据源描述文件，例如，oracle-ds.xml，可以在JBOSS_HOME/docs/examples/jca中找到该文件。
部署数据源描述文件，方法和部署应用程序相同。
以下是oracle数据源的一个描述文件示例：
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
     <local-tx-datasource>
          <jndi-name>OracleDS</jndi-name>
          <connection-url>jdbc:oracle:thin:@localhost:1521:DB</connection-url>
          <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
          <user-name>system</user-name>
          <password>software</password>
     </local-tx-datasource>
</datasources>
其它的数据源描述文件的示例可以在JBOSS_HOME/docs/examples/jca中找到。
十一、 EJB 3.0
JBoss4.0.5GA对EJB3.0提供了一个很好的支持。但需要安装一个补丁程序，补丁程序的文件名为：jboss-EJB-3.0_RC9_Patch_1.zip。可以在JBoss网站下载到，安装方法很简单，只要打开解压的jboss-EJB-3.0_RC9_Patch_1目录中的INSTALL.html文件，里面有具体的操作说明，只要简单的执行一个Ant就可以了。
十二、 客户端
以下是连接已部署在JBoss中的EJB 3.0的示例：
首先在类路径中创建一个文件jndi.properties，文件内容如下：
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
java.naming.provider.url=localhost:1099
客户端程序的调用只要：
InitialContext ctx = new InitialContext();
PetDAO dao = (PetDAO) ctx.lookup("PetDAOBean/remote");
就可以返回EJB的远程接口了。