4.4. 配置文件

Hasor 支持两种格式的配置文件，这两种文件的内容都要求使用 UTF-8 编码。

  • Xml格式（建议文件名 xx-hconfig.xml）

  • properties属性文件（建议文件名 xx-hconfig.properties）

提示

关于配置文件的态度

  • 拥抱约定优于配置，但是不鼓吹零配置。

  • 提倡 Xml 结构化配置，同时也拥抱属性文件。

作为 Hasor 的 xml 配置文件最少内容如下

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <config xmlns="http://www.hasor.net/sechma/main">
  3.     ...
  4. </config>

作为 Hasor 的 properties 配置文件最少内容是空：

  1.     ...

4.5. 读取配置文件

有如下配置文件，读取它的内容：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <config xmlns="http://www.hasor.net/sechma/main">
  3.     <!-- Demo 项目源码所处包 -->
  4.     <hasor debug="false">
  5.         <loadPackages>net.test.project.*</loadPackages>
  6.     </hasor>
  7.     <hasor-jdbc>
  8.         <!-- 名称为 localDB 的内存数据库，数据库引擎使用 HSQL -->
  9.         <dataSource name="localDB" dsFactory="net.test.C3p0Factory">
  10.             <driver>org.hsqldb.jdbcDriver</driver>
  11.             <url>jdbc:hsqldb:mem:aname</url>
  12.         </dataSource>
  13.     </hasor-jdbc>
  14. </config>

  • 如果想读取：debug=”false” 对应的表达式为：hasor.debug

  • 如果想读取：net.test.project.* 对应的表达式为：hasor.loadPackages

  • 如果想读取：org.hsqldb.jdbcDriver 对应的表达式为：hasor-jdbc.dataSource.driver

AppContext appContext = Hasor.create().mainSettingWith("simple-hconfig.xml").build();
Settings settings = appContext.getInstance(Settings.class);
String driver = settings.getString("hasor-jdbc.dataSource.driver");

4.6. 配置冲突

这种情况我们要尽量回避，以避免带来麻烦。举例Xml：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="http://www.hasor.net/sechma/main">
    <hasor debug="false">
        <debug>true</debug>
    </hasor>
</config>

配置文件中 hasor 节点下面有两个节点，一个是元素节 debug，一个是属性节点 debug。

根据 Hasor 配置文件的读取规则，这两个节点的最终表达式均为：hasor.debug。这种情况就称之为配置冲突，一旦出现配置冲突，读取配置的结果就会遇到麻烦。