神州数码融信质量管理体系
JBOSS 使用指南
于 编写
编码规范与指南
一． 入门
下载和安装
的目录结构
启动服务器
控制台
停止服务器
中的部署
二． 的配置
日志设置
服务的端口号的修改
的安全设置
!"登录的用户名和密码设置
!"登录的用户名和密码设置
数据源的配置
使用和设置
消息的传递模型
的配置
三． 原理和应用
什么是
规范
基于 来写 "
#$%& 实例
程序代码
配置文件 %'!
将实例部署到
" 的效果
四．( 使用说明
(")%*%'!"+(,的概念
会话 "：
实体 "：
消息驱动 "+-,：
会话 "+'"",
因为客户端需要通过 .-/查找 (0那么 .-/是什么
))'""（无状态 "）开发
))'"" 与 ))12'"" 的区三别
'"" 的生命周期
消息驱动 "+3-%'"",
422 消息的发送与接收+565 消息传递模型,
6*'! 消息的发送与接收+5272消息传递模型,
实体 "+("8)9",
持久化 *%')"!配置文件
实体 "发布前的准备工作
神州数码融信质量管理体系
编码规范与指南
单表映射的实体 "
一．JBOSS 入门
1.下载和安装 JBoss
在下载和安装 之前，请开发者确认一下自己的机器是否安装了最新
版的 。为运行 ，开发者必须提供 虚拟机。在我们
动身之前，请再次检查一下您是否安装了合适的 ，而且 !"#$ 环境
变量是否已经设置好。
用户可以从 网站（%&&'())***+,)+)-*.-)）
免费下载到 应用服务器。其中，可用的二进制版本格式分别
有/'、&,/ 以及+/。 二进制发布版的具体内容与版本格式无关，
用户需要根据各自的平台选择相应的二进制版本。在您下载完成 后，将
它解压到合适的机器位置上。有一点请注意，包含解压目录的完整路径（比如，
0-* 操作系统中的 1,,2.3 目录）上不能够含有空格，因为这将
导致错误的出现。
2.JBoss 的目录结构
安装 会创建下列目录结构：
目录 描述
+
启动和关闭的脚本
4.3&
客户端与通信所需的库（5）
-4
配置的样本文件（数据库配置等）
-4)-&-
在中使用的各种67文件的8。
.+
一些5，启动时加载，且被所有配置
共享。
3,3,
各种配置。每个配置必须放在不同的子目录。
子目录的名字表示配置的名字。
包含9个默认的配置：.，-3:.&和
..，在你安装时可以进行选择。
神州数码融信质量管理体系
编码规范与指南
3,3,)..
的完全配置， 启动 所有服务，包 括集群和
;;#1。
3,3,)-3:.&
的默认配置，它含有大部分应用所需的标
准服务。但是，它不含有服务、服务、或
者其他任何群集服务。
3,3,).
这是启动服务器所要求的最低配置。配
置将启动日志服务、服务器以及部署扫描
器，以找到待部署的（新）应用。对于那些不需要使
用任何其他$$技术，而只是使用自定义服务的场合
而言，则这种6)配置最适合。它仅仅是服务
器，而不包含03+容器、不提供$和<支持。
3,3,)-3:.&)4:
含有指定核心服务的 文件。同时，还包
括核心服务的其他配置文件。
3,3,)-3:.&)-&
这一目录存储持久化数据，即使服务器发生重启其中的数据
也 不 会 丢 失 。 许 多 服 务 将 数据 存 储 在 这 里， 比 如
!"#数据库实例。
3,3,)-3:.&)
-3'.
用户将应用代码（ $%$文件）部署在此处。同
时，&#"目录也用于热部署服务（即，那些能够从运行服
务器动态添加或删除的服务）。因此，用户能够在&#"目
录看到大量的配置文件。尤其是，用户能够看到'控制台
应用（未打包的%文件），本书前面讨论过。服务
器将定期扫描该目录，从而查找是否有组件更新或修改，从
而自动完成组件的重新部署。
3,3,)-3:.&).+
服务器配置所需的文件。用户可以添加自身的库文件，
比如(驱动，等等。
3,3,)-3:.&).
日志信息将存储到该目录。使用)*+,包作为其
日志功能。同时，用户可以在应用中直接使用+,日志记录
功能。
3,3,)-3:.&)&'
供部署器临时存储未打包应用使用，也可以作为其他用途。
3,3,)-3:.&)*,
供编译-使用。
其中，-&、.、&'、*, 目录是 创建的。如果用户没有启动
过 服务器，则这些目录不会被创建。
既然提到了 中的热部署服务主题，接下来在探讨服务器配置问题前
先来看看实际例子。如果还没有启动 ，则请运行它。然后，请再次查看
-3'. 目录（用户必须保证运行了 -3:.& 配置），然后删除 .
3,43=. 文件。通过运行 服务器的控制台能够浏览到如下信息：
9((9;>2#?.<3,43@.3,43A().A
,33-:,>;
然后，再次将 .3,43=. 文件放回原处，用户将通过控制台再次发
现 重新部署了该服务。所以，这就是 的热部署。
神州数码融信质量管理体系
编码规范与指南
3.启动服务器
首先，来看看如何运行 服务器。用户可以在 主安装目录的 +
目录中找到若干个脚本文件。请执行 , 脚本（对于 0-*，则运行
,+&；对于 7=、#<6、B>;6 系统，则运行 ,%）。默认 + 运
行 -3:.& 配置，如果要运行 .. 配置请执行命令 ,C4..。其中，部署和启
动 组件的具体日志信息能够在运行 的控制台浏览到。如下消息表
明， 服务器成功运行：
((D;>2#?<3,3,@64, 3,3.?
+.-(<>8E!!!!-&3EF9G@<&,&3-
F(G
用户可以通过 03+ 浏览器验证 应用服务器是否在运行，其 "881 监
听端口为 （其中，必须保证在启动 时， 端口并没有被其他应
用或服务占用）。通过 03+ 浏览器能够找到相关有用的 资源（译者注：
%&&'()).4.%&(）。
4.JMX 控制台
通过 %&&'()).4.%&()=4.3，即 6 控制台应用，用户能
够浏览到服务器活动视图。图 给出了示例界面。 上述界面给出了 管
理控制台，它提供了构成 服务器的 63 原始视图。我们暂时可
以不用理会控制台的任何内容，但是需要知道控制台能够提供运行中的
应用服务器的大量信息。另外，通过它，用户能够修改、启动、停止 组
件。 比如，请找到 3,43E>;3* 链接，然后单击。该特定 3 提供
了如下服务内容，即能够浏览服务器中 >; 命名空间的结构信息。接下来，请
在该 3 显示页面底端找到 .& 操作，然后单击 3 按钮。3 操
作将返回绑定到 >; 树中的当前名字列表，这对于获得 $ 名字很有帮助，比
如当 $ 应用客户端不能够解析 $ 名字时。
神州数码融信质量管理体系
