The JBoss 4 Application Server Guide (中文翻译)[每日更新]

The JBoss 4 Application Server Guide

JBoss AS 4.0.4

(简体中文)

 

Release 5

Copyright © 2004, 2005, 2006> JBoss, Inc.

1 JBoss 安装与运行

JBoss 是一个免费的符合J2EE1.4认证规范（J2EE 1.4 certified）的应用服务器（Application Server），是市面上使用最广泛的开源应用服务器。高度灵活与易于使用的服务器结构，使得JBoss成为刚刚起步做J2EE的用户们的理想选择，同时也是高级架构师们寻找可定制中间件（customizable middleware）的平台。服务器的二进制文件与源代码都可以从SourceForge库得到。(http://sourceforge.net/projects/jboss)。完备可用的代码使你可以调试服务器，学习其内部工作方式，并创建定制的版本用于个人或商业用途。
本章将为你介绍如何下载和安装JBoss 4.0。你将学习其目录结构并理解什么是关键服务和配置文件。
在安装和运行此服务器前你应该先检查系统，以确保已经开装了可用的Java 1.4 或 1.5。其中Java 1.5 是使用新的简化的EJB3.0技术的必要条件。检查你的Java环境的最简单的方式就是运行java –version 命令，以确保java在你路径下可以执行且适用。
 

 1.1安装JBoss

最新的JBoss发行版本可从JBoss下载页面获得，http://www.jboss.org/products/jbossas/downloads 。在下载到你想安装的版本后，使用JDK jar工具（或其它ZIP解压缩工具）将其解压到指定的本地路径。这与JBoss在系统中安装路径无关。但是要注意，要是把JBoss安装在一个名字有空格的目录下，则可能在基于Sun的VM中发生问题。这是由于文件URL不能正确转义结果URL中的空格的Bug所致。JBoss-4.0.4.tgz存档文件是一个gzipped tar文件需要一个guntar兼容的程序以处理存档文件中的长路径名。Solaris和OS X中当前默认的tar程序是不支持长路径名的。
 

JBoss也提供一个GNU的安装程序可以简化安装过程。另外对于基本安装，安装程序允许你选择安装哪些服务以保护JBoss管理应用程序。使用安装程序创建的定制安装可以大大简化JBoss的安装与配置。
 

安装程序可以使用Java Web Start直接从Web浏览器运行，或者可以下载一个名为jboss-4.0.4-installer.jar的可执行JAR文件。在很多操作系统上，你只需双击JAR文件就可运行了。如果你的系统不支持那样的话，你可以直接从命令行运行安装程序。

当你启动安装后，可以选择服务器的初始配置集，如图-1.1


图-1.1 JBoss 安装程序配置集选择屏幕

初始配置决定了哪些包适用于安装。下面的表格描述了每一种配置集。

表-1.1 JBoss AS 安装程序配置集

名称	描述	说明
default（默认）	基础的J2EE1.4服务器预定义包
all（全部）	完全的J2EE1.4服务器预定义包带有企业扩展如群集和IIOP
minimal（微缩）	一个微缩的JMX微内核	非J2EE1.4 兼容配置
ejb3.0	EJB3.0预定义包，支持完全的EJB3规范带有Tomcat	需要Java1.5运行时，非J2EE1.4兼容配置
ejb3-clustered	EJB3.0预定义包，支持完全的EJB3规范带有Tomcat和群集	需要Java1.5运行时，非J2EE1.4兼容配置
jms	JMS1.1服务器预定义包	非J2EE1.4 兼容配置
tomcat	Servlet2.4容器预定义包	非J2EE1.4 兼容配置

 

在选择配置集之后，你可以进一步定制要安装的服务，削减不需要的选项。在选择配置集时，要清楚你不能添加不在配置集中的包。如果你想要一个简单的Web容器（tomcat配置）并且能够支持JMS（jms配置），就必须选择更大的配置，如default（默认）配置，然后去掉不想要的包。图-1.2展示了包选择屏。

图-1.2 JBoss 安装程序包选择屏

下一屏（图-1.3）允许你定制服务器配置名称。除非你想创建多个配置，一般你都应是用default作为配置名称。

图-1.3 JBoss安装程序配置名称屏

 
安装程序将会引导你进入几个定制安装的屏。第一屏允许你使应用孤立，完全的将所有应用同类载入空间分开。应用孤立在有些情况下会很有用，但是也有一定的代价——在应用之间使用慢的值传递的方式传送数据。有时候，更倾向使用载入器库（Loader Repository）来控制Application-by-Application Basis上的类的共享，而不是使其彻底孤立于服务器。

当从tar/zip文档中安装好JBoss后，所有的JBoss服务都处于开发者友好的状态（Developer-Friendly）的状态，无需认证即可访问大多数的JBoss服务。安装器在安全屏给你一个机会来保护这些服务，如图-1.4。推荐你点击这些选项，以保护所有的服务，并改换admin用户密码的默认值——admin/admin。

图-1.4 JBoss 安装程序安全配置屏

当你从安装程序安装时，得到的是一个稍小些且更适合于你的环境的安装镜像。不过，其目录结构可能与使用tar/zip文件时略有不同。本书中的示例需要使用许多不同的配置，并且假设是完全安装的。不过在正常的JBoss使用时还是推荐使用安装程序进行安装。你需要下载一个完全的镜像，书中的示例才都能运行。

1.2目录结构

安装JBoss时会创建一个jboss-4.0.4的目录包含了服务器启动脚本，JAR文档，服务器配置集和工作目录。你需要知道发行包的大致路径，以便于你放置用于编译代码的JAR包，更新配置，部署代码等。图-1.5 展示了JBoss 服务器的安装目录。

图-1.5 JBoss AS 目录结构
在本书中，我们将引用JBOSS_DIST 目录来指代jboss-4.0.4的顶级目录。图-1.5中展开了显示了default服务器配置文件集，包含了许多子目录，conf，data，deploy，lib，log和tmp等。在一个纯净的安装中，只有conf，deploy和lib目录。有几个地方可能会被覆盖掉。上面显示了org.jboss.system.server.ServerConfig 接口常量和它对应的系统属性字符串。名字以URL结尾的对应了可以使用指定的URL进行远程访问的地方，如HTTP URL对应Web服务器。表-1.2罗列了顶级目录及其功能。
表-1.2 JBoss 顶级目录结构

目录	说明
bin	JBoss中的所有入点JAR文件和启动脚本都置于bin目录中。
client	JBoss外部运行的客户端所需要的JAR文件都置于client目录中。
sever	JBoss服务器配置集文件都位于server目录下。默认服务器配置集是server/default。JBoss舶来了minimal, default和all三种配置集。default 配置集中包含的目录和关键文件在1.3节中有更详尽的讨论。
lib	lib包含了JBoss的启动JAR包，请勿将你自己的库文件放在此处。

表-1.3列出了，服务器配置目录下包含的目录及其功能。

表-1.3 JBoss服务器配置目录结构

目录	说明
conf	conf目录包含了特定服务器配置的jboss-service.xml bootstrap描述符文件。它定义了服务器生命周期内固定的核心服务。
data	data目录用于在文件系统中储存内容的服务。
deploy	deploy目录是热部署服务监视的默认路径，用于动态部署内容。可以通过URLDeploymentScanner URL属性覆盖。
lib	lib是不该被热部署的静态的Java 类库默认位置。所有的JAR包都在启动时载入到共享的类路径。
log	log目录是写日志文件的目录。可以通过conf/log4j.xml配置文件覆盖。
tmp	tmp是JBoss存放临时文件的目录解包的部署。

 

conf和deploy目录中的内容将在下一节中列出。
 

1.3默认服务器配置文件集

 

JBoss_DIST/server目录包含一个或多个配置文件集。default JBoss配置文件集位于JBoss_DIST/server/default目录下。JBoss允许添加多个配置文件集，一个服务器就可以在不同的配置上运行。创建一个新的配置文件集，一般都是先将default文件集拷贝到一个新名字的目录下，然后根据需要修改配置文件集。下图-1.6显示了default配置文件集的内容。

图-1.6默认服务器配置文件集conf和deploy目录展开图

conf目录中的文件将在下面加以解释。
jboss-minimal.xml

这是jboss-service.xml配置文件的一个最小型的例子。minimal配置文件集所使用的jboss-service.xml文件。