---
title: "走进JBoss (1)"
author: "mmdev"
date: "2004-02-29T13:24:00Z"
tags: []
slug: "jboss-1"
draft: false
lastmod: "2004-02-29T13:24:00Z"
id: 1006752
url: "https://mmdev.iteye.com/blog/1006752"
---

JBoss是一个免费的开源应用服务器，全面支持J2EE，包括JSP，Servlets，EJB。为了让J2EE开发人员快速熟悉JBoss，本文将带您开始JBoss之旅，包括下载，安装，部署应用程序和配置数据源。

&lt;?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" /&gt;

**工具准备**

为了运行JBoss，你需要准备以下工具：

u JDK 1.3.1或更高。

为了在JBoss上开发应用程序，你可能还需要以下开发工具：

u Ant 1.5，一个Java Build Tool。

u XDoclet 1.1.2，一个用于生成代码的Javadoc插件。

u JBoss Project Template

**下载**

可以从[www.jboss.org](http://www.jboss.org/)获得JBoss，JBoss现在有两种供你选择：标准版，包括用于Web页和Servlets的Jetty，和另一个用Tomcat替换Jetty的版本。

在写作本文时，JBoss 3.2.1是最新的稳定版本。

**安装**

解压压缩包到一个指定的目录，例如jboss-3.2.1，解压完毕后，应该生成如下目录：

u bin：命令和脚本

u client：客户端jars

u docs：JBoss的文档

u lib：服务器端jars

u server：服务器配置文件

第二步，建立以下环境变量：

u JBOSS\_HOME：设置为JBoss的安装目录。

u JAVA\_HOME：设置为JDK的安装目录。

**服务器配置**

JBoss提供了3种服务器配置：

u Minimal：最小配置，仅仅包括日志，JNDI服务和URL部署扫描器，你可能会在一个不需要J2EE的应用中使用这种配置，或者以该配置为基础自定义配置。

u Default：缺省配置，包括除了RMI/IIOP和集群的所有J2EE服务。

u All：这种配置包括所有的JBoss服务。

**启动**

为了启动JBoss，在Windows下：

u 打开一个命令行窗口；

u 键入：cd %JBOSS\_HOME%\\bin；

u 键入：run \[-c default|minimal|all]。

在UNIX下：

u 打开一个Shell；

u 键入：cd $JBOSS\_HOME/bin；

u 键入：./run \[-c default|minimal|all]。

如果JBoss启动成功，你应该可以看到以下输出：

21:11:16,637 INFO \[Server] JBoss (MX MicroKernel) \[3.2.1 (build: CVSTag=JBoss\_3 \_2\_1 date=200305041533)] Started in 26s:919ms

一旦服务器启动成功，你就可以通过在浏览器中打开[http://localhost:8080/jmx-console/](http://localhost:8080/jmx-console/)来验证所有的J2EE服务是否都启动了。这是JBoss的管理台，它将显示当前配置下JBoss正在运行的所有服务以及每个服务的详细内容。

JBoss也可以作为NT服务或者Unix服务来运行，可以参考“JBoss 3.0 Quick Start Guide”。

**关闭**

如果在Windows的命令行窗口或者当前的Unix Shell下运行JBoss，只需要简单的按下Ctrl+C即可关闭JBoss。

如果在Windows下不能看见命令行窗口：

u 打开一个新的命令行窗口；

u 键入：cd %JBOSS\_HOME%\\bin；

u 键入：shutdown –S或者shutdown --server=url。

如果在Unix Shell的后台运行：

u 打开一个Shell；

u 键入：cd $JBOSS\_HOME/bin；

u 键入：./shutdown –S或./shutdown --server=url。

**管理**

JBoss通过一个基于Web的控制台管理，你只需在浏览器中键入：[http://localhost:8080/jmx-console/](http://localhost:8080/jmx-console/)即可。查看或更改某一服务的配置，只需简单的点击链接。

通过控制台，你还可以使用一些服务的公开的方法，例如，关闭服务器：

u 打开控制台；

u 卷动到“jboss.system”选项；

u 点击链接“type=server”；

u 卷动到“void shutdown()”选项；

u 点击“Invoke”按钮。

**部署应用程序**

在JBoss中部署应用程序是再简单不过的了。简单的复制你的应用程序打包文件：.jar，.war或者.ear到服务器缺省的部署目录下，如果JBoss正在运行，将检测到文件，自动解压，然后装载应用程序。

以下是将一个应用部署到一个缺省的服务器配置的例子，在Windows下：

u 复制rotmachine.ear到%JBOSS\_HOME%\\server\\default\\deploy

在Unix下：

u 复制rotmachine.ear到$JBOSS\_HOME/server/default/deploy

在部署过程中，JBoss日志将在控制台窗口输出信息并写入日志，日志文件位于服务器的配置目录。如果部署成功，你应该可以看到以下信息：

&lt;?xml:namespace prefix = st1 ns = "urn:schemas-microsoft-com:office:smarttags" /&gt;&lt;time minute="21" hour="22"&gt;&lt;span lang="EN"&gt;22:21&lt;/span&gt;&lt;/time&gt;:44,730 INFO \[MainDeployer] Deployed package: file:/C:/jboss-3.2.1/server/default/deploy/rotmachine.ear

此外，如果你打开JBoss的管理台，可以在“jboss.j2ee”类别下列出你的应用。

**取消已部署的应用**

取消已部署的应用程序比部署应用程序更简单。只要简单的从部署目录中删除相应的应用程序文件，JBoss就会检测到文件已被删除，然后取消已部署的应用。

取消部署一个应用时，JBoss日志将在控制台窗口显示信息，并记录到服务器日志。如果取消部署成功，你应该可以看到以下信息：

&lt;time minute="59" hour="22"&gt;&lt;span lang="EN"&gt;22:59&lt;/span&gt;&lt;/time&gt;:41,500 INFO \[MainDeployer] Undeployed file:/C:/jboss-3.2.1/server/default/deploy/rotmachine.ear