2.3. 文件系统路径
2.3.1. 文件系统路径 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
JBoss EAP 6 使用了文件系统路径的逻辑名称。
domain.xml
、host.xml
和 standalone.xml
配置都包含一个可以声明路径的部分。然后配置的其他部分可以通过逻辑名称引用这些路径,避免了为每个实例声明绝对路径。这有利于配置和管理,因为它允许将专有的主机配置解析为同一的逻辑名称。
例如,日志子系统配置包括对
jboss.server.log.dir
路径的引用,它指向服务器的 log
目录。
例 2.10. 日志目录的相对路路径示例
<file relative-to="jboss.server.log.dir" path="server.log"/>
<file relative-to="jboss.server.log.dir" path="server.log"/>
JBoss EAP 6 自动提供大量的标准路径而无需用户在配置文件进行配置。
值 | 描述 |
---|---|
jboss.home.dir | JBoss EAP 6 的根目录。 |
user.home | 用户的主目录。 |
user.dir | 用户的当前工作目录。 |
java.home | Java 的装路径 |
jboss.server.base.dir | 单独服务器实例的根目录。 |
jboss.server.data.dir | 服务器用于持久性数据文件存储的目录。 |
jboss.server.config.dir | 包含服务器配置的目录。 |
jboss.server.log.dir | 服务器用于日志文件存储的目录。 |
jboss.server.temp.dir | 服务器用于临时文件存储的目录。 |
jboss.controller.temp.dir | 主机控制器用于临时文件存储的目录。 |
用户可以在配置文件里添加
path
元素来添加自己的路径,或覆盖除了上面前 5 个路径外的所有路径。下面的例子展示了相对于独立服务器实例的根目录的新的相对路径声明。
例 2.11. 相对路径的格式
<path name="examplename" path="example/path" relative-to="jboss.server.data.dir"/>
<path name="examplename" path="example/path" relative-to="jboss.server.data.dir"/>
路径声明的结构使用下列属性。
属性 | 描述 |
---|---|
name | 路径的名称。 |
path | 实际的文件系统路径。它将被当作绝对路径,除非指定了 relative-to 属性,此时它会被当作相对该路径的值。 |
relative-to | 可选属性,它指定之前命名路径的名称,或者系统提供的标准路径中的其中一个。 |
domain.xml
配置文件里的 path
元素只要求 name 属性。它不需要包括指定下面例子里所展示的实际文件系统路径的信息。
例 2.12. 域路径示例
<path name="example"/>
<path name="example"/>
这个配置简单地声明一个名为
example
的路径,可供 domain.xml
配置的其他部分引用。example
声明的实际文件系统位置是加入域组的主机实例的 host.xml
配置文件所专有的。如果使用了这个方法,每台主机的 host.xml
里必须有一个 path 元素来指定实际的文件系统路径。
例 2.13. 主机路径示例
<path name="example" path="path/to/example" />
<path name="example" path="path/to/example" />
standalone.xml
里的 path
元素必须包括实际文件系统路径的规格。