Mybatis 文档篇 2.1:Configuration 之 Properties

1 Configuration Structure

2 properties

2.1 如何定义?

These are externalizable, substitutable properties that can be configured in a typical Java Properties file instance, or passed in through sub-elements of the properties element.
这些属性是可以外部配置、可替换的,可以在典型的 Java 属性文件中配置,或者通过 properties 元素的子元素进行配置。

  • 在 Configuration XML 中定义
<properties resource="org/mybatis/example/config.properties">
  <property name="username" value="dev_user"/>
  <property name="password" value="F2Fa3!33TYyg"/>
</properties>
  • 在 config.properties 中定义
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/test
  • 在 Java 中定义
Properties prop = new Properties();
prop.setProperty("key", "value");

2.2 在哪里使用?

  • 在 XML 中使用
<dataSource type="POOLED">
  <property name="driver" value="${driver}"/>
  <property name="url" value="${url}"/>
  <property name="username" value="${username}"/>
  <property name="password" value="${password}"/>
</dataSource>

The username and password in this example will be replaced by the values set in the properties elements. The driver and url properties would be replaced with values contained from the config.properties file. This provides a lot of options for configuration.
在这个例子中,username 和 password 将被 properties 元素中的设置的对应值所替换。driver 和 url 将被 config.properties 文件中设置的值替换。这样就为 configuration 提供了诸多选择。

  • 在 Java 类中使用

Properties can also be passed into the SqlSessionFactoryBuilder.build() methods.
Properties 也可以在 SqlSessionFactoryBuilder.build() 方法中使用:

SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, props);
// ... or ...
SqlSessionFactory factory = new SqlSessionFactoryBuilder.build(reader, environment, props);

2.3 顺序?

If a property exists in more than one of these places, MyBatis loads them in the following order:
如果一个属性在多个地方被定义,Mybatis 将按以下顺序加载:

  • Properties specified in the body of the properties element are read first,
    定义在 properties 元素体内的属性将被优先读取;

  • Properties loaded from the classpath resource or url attributes of the properties element are read second, and override any duplicate properties already specified,
    然后根据 properties 的 resource 属性读取类路径属性文件或者通过 properties 元素的 url 属性指定的路径读取属性文件,并且覆盖已读取的同名属性;

  • Properties passed as a method parameter are read last, and override any duplicate properties that may have been loaded from the properties body and the resource/url attributes.
    最后读取通过方法参数传递的属性,并且覆盖掉以上两种方式加载的同名属性。

Thus, the highest priority properties are those passed in as a method parameter, followed by resource/url attributes and finally the properties specified in the body of the properties element.
因此,优先级顺序从高到低依次是:通过方法参数传递的属性-->通过 resource/url 的路径下文件定义的属性-->properties 元素体中定义的属性

2.4 更多关于占位符

Since the MyBatis 3.4.2, your can specify a default value into placeholder as follow:
从 MyBatis 3.4.2 开始,你可以为占位符指定一个默认值:

<dataSource type="POOLED">
  <!-- ... -->
  <!-- 如果 'username' 属性未设置, username 则为默认值 'ut_user' -->
  <property name="username" value="${username:ut_user}"/>
</dataSource>

This feature is disabled by default. If you specify a default value into placeholder, you should be enable this feature by adding a special property as follow:
开启特性:这个特性默认是关闭的。如果你想为占位符指定一个默认值,你应该加入下面这样一个 property 来打开它:

<properties resource="org/mybatis/example/config.properties">
  <!-- ... -->
  <!-- 开启该特性 -->
  <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/> 
</properties>

Also If you are used already the ":" as property key(e.g. db:username) or you are used already the ternary operator of OGNL expression(e.g. ${tableName != null ? tableName : 'global_constants'}) on your sql definition, you should be change the character that separate key and default value by adding a special property as follow:
自定义分隔符:如果你的属性键中已经包含了字符":"(如 db:username)或者你已经在你的 sql 定义中用了 OGNL表达式的三元运算符(如 &{tableName != null ? tableName : 'global_constants'}),你应该通过增加一个指定的 property 来改变分隔键和默认值的字符:

<properties resource="org/mybatis/example/config.properties">
  <!-- ... -->
  <!-- 改变默认的分隔符(使用 "?:" 来分隔)-->
  <property name="org.apache.ibatis.parsing.PropertyParser.default-value-separator" value="?:"/> 
</properties>

然后你就可以像下面这样使用:

<dataSource type="POOLED">
  <!-- ... -->
  <property name="username" value="${db:username?:ut_user}"/>
</dataSource>

最后

说明:MyBatis 官网提供了简体中文的翻译,但个人觉得较为生硬,甚至有些地方逻辑不通,于是自己一个个重新敲着翻译的(都不知道哪里来的自信...),有些地方同官网翻译有出入,有些倔强地保留了自己的,有的实在别扭则保留了官网的,这些都会在实践中一一更正。鉴于个人英文能力有限,文章中保留了官方文档原英文介绍(个别地方加以调整修剪),希望有缘看到这里的朋友们能够有自己的理解,不会被我可能错误或不合理的翻译带跑偏(〃'▽'〃),欢迎指正!

当前版本:mybatis-3.5.0
官网文档:MyBatis
官网翻译:MyBatis 简体中文
项目实践:MyBatis Learn

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,236评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,867评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,715评论 0 340
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,899评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,895评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,733评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,085评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,722评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,025评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,696评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,816评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,447评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,057评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,009评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,254评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,204评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,561评论 2 343