简约之美jodd--props属性使用

  Prop是一个超级properties;包含了很多jdk缺失的东西:utf-8支持,宏,分区,profiles,全配置等等。

属性存储在一个或者多个*.props文件,而且它是开放的,支持多种类型的资源。更重要的是,它和java properties是兼容的。

  Props的目标不是提供一个最大限度地配置解决方案,而是提供一个比java properties更好的选择。因此如果在应用中使用到properties,考虑使用Props来替代。

基本规则

下面是介绍props文件格式的一组基本规则。其中的一些规则如下示例:

utf8编码

默认情况下,props文件是utf8编码,也可以使用别的任意编码格式。不管使用哪种编码格式,props加载java properites时仍然使用ISO 8859-1.

去除空白字符

分区名称和属性名称的开头结尾的空白字符将被去除掉,而属性值也会去除开头和结尾的空白字符。

赋值

可以使用"="或者":"进行赋值。

值连接

使用"+="连接同名属性的值(以逗号分隔)。

注解

从";"或者"#"开头到行的结尾来注解。

转义符

使用"\"作为转义符,对字符进行转义(例如 "\#"代表了字符"#","\\"代表"\")。

多行的值(Multi-line values)

如果"\"作为行的连接符,表明下一行仍然是属性的值。

特殊字符

\\uXXXX将被编译为字符,同样\t,\r,\f也会编译为字符。

多行值(Multiline values)

使用三引号作为一种方便的形式来定义多行的值。

注:三引号的语法是一对连续的单引号或者双引号(通常都是成对的用)。

三引号让程序员从引号和特殊字符串的泥潭里面解脱出来,自始至终保持一小块字符串的格式是所谓的WYSIWYG(所见即所得)格式的。

基本用法

Props的使用非常简单。概况的说,Props管理着属性。

    Props p = new Props();
    p.load(new File("example.props"));
    ...
    String story = p.getValue("story");

Props加载属性的方法有多种形式:文件、输入流、字符串、属性Properties。然后通过Props的etValue方法来调用属性值,这个方法通常返回一个字符串的值。

分区

  分区和INI文件的分区非常相似。在Props中,分区仅表示前缀相同的一组键,这组键直到分区结尾或者文件结尾。

  分区名称已[开头,以]结尾。属于该分区的属性在分区的头部之后。分区名称将作为前缀加到分区属性中。分区以空的[]结尾或者新的分区开始或者到文件尾部。

示例如下:

[users.data]
weight = 49.5
height = 87.7
age = 63
[]
comment=this is base property

下面的和上述示例等同:

users.data.weight = 49.5
users.data.height = 87.7
users.data.age = 63
comment=this is base property

因此,分区可以缩短文件,从而使文件更可读。

Profiles

通常情况下,一个应用有不同的环境,因此要求不同组别的属性。例如web应用的测试环境、发布环境。一种组织这些属性的方法是定义不同的profile,在这些profile里同样的键有不同的值。

Props支持属性的Profile。Profile定义在键名内:profile名称以<>包装。一个可以可以有一个或者多个profile定义。同样,profile可以定义在键名的任意地方,甚至在单词的中间;然而,最好还是把它放到键名的尾部。

没有profile的属性是基于属性的,若检索特定profile的属性失败,将会检查基本的属性。

profile可以看着相同属性组的一个“不同的视图”或者“快照”。示例:

db.port=3086

db.url<develop>=localhost
db.username<develop>=root

db.url<deploy>=192.168.1.101
db.username<deploy>=app2499

在上面的示例中,定义了3个键,两个键拥有两个不同的profile(develop/deploy)且没有基本的值。

上文提到,分区是一个键的前缀定义,并且profile可以定义在键名的任意地方,因而分区名称也可以包含profile定义,上述的示例可以改造如下:

db.port=3086

[db<develop>]
url=localhost
username=root

[db<deploy>]
url=192.168.1.101
username=app2499

当检索上述值时,可以指定活跃的profile:

    String url = props.getValue("db.url", "develop");
    String user = props.getValue("db.username", "develop");

注意:一个profile可以同时定义多次。profile的顺序非常重要!当键定义到多个活跃的profile时,将返回第一个的值(第一个匹配的profile的值)。

你也可以仅仅检索基本属性(忽略profile)--使用getBaseValue()方法。基本属性不属于任何profile。

默认的活跃profile

通常,在一个应用的生命周期中,只有一组profile是活跃的。不需要每次在调用getValues()时都传递此活跃的profile。Props支持在外部定义这个所谓的活跃profile,这个定义在加载属性的props文件中。

在使用getValue(String)检索属性时,活跃的profile就是默认的profile。活跃profile以@profiles的特殊属性键定义。例如:

key1=hello
key1<one>=Hi!

@profiles=one

则下面的java代码:

String value = props.getValue("key1");

将会返回值“Hi!”,因为活跃profile是"one".

活跃profile也可以通过java代码设置,方法是:setActiveProfiles().

内部profile

  有这样一种场景:两个或者多个profile共享大部分配置,而只有很少一部分属性是不同的。为避免在每个profile中重复定义所有的属性,可以使用内部profile定义哪些不同的属性。Props首先检索内部profile的键,然后检索基本属性,示例如下:

key1<one>=Hi!
key2<one>=...
....
key100<one>=...

key1<one.two>=Hola!

上述示例定义了两个profiles,第一个名称为"one",包含了100个键值对。第二个profile是一个名称为one.two的内部profile。它包含一个属性(key1)---但上层profile所有属性都是可用的!当使用java代码调用上述属性:props.getValue("key1", "one.two")时将会怎样呢?

Props将会

  在内部名为one.two的profile中检索属性

  如果没有找到,Props检查上一层的profile:one。

  如果还检索不到,没有更上一层的profile了,Props检索基本属性。

内部profile可用有很多层。

Props最大的优点是支持宏。宏是一些键值的引用,别的键可用使用该值。宏以{}包装。示例如下:

key1=Something ${foo}
...
foo=nice

key1的值是“Something nice”。宏可用引用任意存在的属性键,不管它们定义在哪里。

同样也支持嵌套的宏,示例如下:

key1=**${key${key3}}**
key3=2
key2=foo

key1的值是"**foo**".

宏和profile

宏通常使用当前活跃或者提供的profile来解析。若当前的profile改变了,宏的值通常也会改变。

这种行为由标志位useActiveProfilesWhenResolvingMacros来控制。例子如下:

root=/app
root<foo>=/foo
data.path=${root}/data

data.path的值在profile设置为active时是多少?因为foo是活跃的,root的值变为/foo,因此data.path的值为/foo/data.

若我们关闭所有的profile而只使用基本属性,data.path的值时/app/data.

也可以显示的设置宏的profile:

root=/app
root<foo>=/foo
data.path=${root<foo>}/data

上述例子中,宏root将一直使用foo profile而不管当前选定的profile,因而data.path的值将一直是"/foo/data".

多行值

多行的值可以通过三引号定义。中间的都看做值:

email.body=‘‘‘
    Hello $n,

    welcome!
‘‘‘

注意:多行的值的空白将不会对剪短!因此上述示例中的值将包含5行。

遍历和键的顺序

Props中的键是有顺序的!因此可以根据属性文件中键的顺序遍历所有的键。不用如下代码:

foo.1=value1
foo.2=value2
...

你可以遍历props如下:

 Props props = ....
 Iterator<PropsEntry> it = p.iterator();

遍历的顺序和props定义的顺序一致。

更进一步,可以通过增加profile来过滤检索或者/和分区遍历。你可以这样写:

    Iterator<PropsEntry> it = p.entries()
            .section("one.two")
            .profile("prof1", "prof2")
            .iterator();

上述代码仅仅遍历给定分区和给定profile的属性。

由于引入了profile,可以将一个键定义在属性文件的多个地方。例如,你可以为两个不同的profile定义一个特定的值。在这种情况下,将不能确定键的正确顺序:是第一个检索到的键还是它所在位置获取的值?你可以通过使用skipDuplicatesByValue和skipDuplicatesByPosition()来控制。

复制操作符

假定你有一定数量的属性,即默认情况下,和不同种类的数目一样,示例如下:

com.jodd.action1=value1
com.jodd.action2=value2
...
org.jodd.action1=value1
org.jodd.action2=value2
...
net.jodd.... # etc

Props支持你使用复制操作符(<=)来最小化重复的属性,上述属性可以写成如下形式:

[actions]
action1=value1
action2=value2
...

[]
org.jodd <= actions

[com]
jodd <= actions

[net.jodd]
<= actions

上述示例显示了使用复制操作的三种不同方法,没有使用分区,使用部分分区和完全使用分区。使用这三种方法的哪一种都可以,你可以任意选择一种。

注意:复制的值设置为宏,因此上述所有复制的属性也等同于:

org.jodd.action1=${actions.action1}
com.jodd.action1=${actions.action1}
....

配置

使用几种配置设置可以很好的对Props进行调优:

  新行转义值

    当行结尾符(EOL)需要转义时,指定一个新的字符串。默认值是空的字符串,故多行的值和单行的值连接起来。如果新行转义值被设置为,例如"\n"时,多行的值将以多行的形式保存。

  截左侧值

    如果需要从左边剪断的话,设置此值。

  截右侧值

    如果需要从右边剪断的话,设置此值。

  新行忽略前面的空白值

    若值分割为多行(以转义EOL)时需要忽略主要的空白值时定义此值。默认值时true,因此下面的多行属性:

key1=line1     line2line3

将被读成line1line2line3(连接成的)

  跳过空的属性

    跳过空的属性的标志位。

  连接重复的属性

    一旦设置,重复的属性键将不会覆盖旧的键,而是连接并且通过逗号分隔。

  多行值

    默认启用,利用一种更便利的方式来书写多行的值,以三引号(和python一样)来书写。三引号内的所有字符认作一个值,因此新行不需要转义。

源码如下:

/**
     * Value that will be inserted when escaping the new line.
     */
    protected String escapeNewLineValue = StringPool.EMPTY;

    /**
     * Trims left the value.
     */
    protected boolean valueTrimLeft = true;

    /**
     * Trims right the value.
     */
    protected boolean valueTrimRight = true;

    /**
     * Defines if starting whitespaces when value is split in the new line
     * should be ignored or not.
     */
    protected boolean ignorePrefixWhitespacesOnNewLine = true;

    /**
     * Defines if multi-line values may be written using triple-quotes
     * as in python.
     */
    protected boolean multilineValues = true;

    /**
     * Don‘t include empty properties.
     */
    protected boolean skipEmptyProps = true;

参考文献:

http://jodd.org/doc/props.html

时间: 2024-10-06 02:35:47

简约之美jodd--props属性使用的相关文章

简约之美Jodd-http--应用一箩筐

Jodd-http是一个微型的.简约的http client,然而简单而且方便.使用它可以轻松的实现发送请求和读取响应.它的目标就是日常应用变的非常简单,从而简化开发人员的工作. 了解Jodd-http的最好方法就是示例程序. 简单的GET方法 HttpRequest httpRequest = HttpRequest.get("http://jodd.org"); HttpResponse response = httpRequest.send(); System.out.print

126平温馨简约 邂逅美的家:装修公司:家庭装修:装饰公司:品牌装饰公司

126平温馨简约 邂逅美的家 设计师石吉祥   电话15127722651 业主:独立设计一直不在我们的考虑范围内,就怕不是同一公司的设计和施工在后期的沟通上会有问题.最后决定去罗澜装饰看看完全是因为设计风格和热情可爱的设计师~哈哈,当然啦~罗澜装饰的设计费也是一度让我们相当矛盾.可是约谈后,真心觉得那是一个认真贴心的设计师.当下就决定拍板罗澜装饰了!交完定金后直接量房!(之前磨磨蹭蹭犹豫来犹豫去的我们这次决定的尤其快!) 至于装修风格,其实最初想的是现代简约,后来被设计师的几个作品迷住了,想说

React的state属性与props属性

state属性和props属性是隶属于React的component的两个重要属性 在React中,每一个class(类)和面向对象的函数一样,都有一个构造函数constructor(),可以对对象.属性等进行初始化,因此要初始化state,可以将其放在:   state属性     constructor(){ //初始化对象.属性等 } import React from 'react'; export default class BodyIndex extends React.Compon

react基础:插值 ,Props属性

一:插值插值语法是{},在大括号中可以书写任意的表达式,Js内置的方法,定义 的方法,运算符,语句等等{/*在jsx语法中书写注释一定要写在插值符号中*/} 必须是/**/ 且必须放到{}中eg: 二:Props属性两个相同div,给其中的一个添加一个类,这个div展示的样式就不一样的,因为他具有这个属性就叫class区别于其他的div同理来说对于完全一致的组件,展示完全一致,如果给其中一个添加一些属性,这个组件展示的结果就可以能会不同了,因此react提出组件属性的概念,可以对组件添加一些属性

2015年第10本:《简约之美,软件设计之道》

<简约之美>这本书是够简约的,100页,还有不少的留白处.现在的出版商流行<xxx之美>之风,看过了<数学之美>.<架构之美>.<数据之美>……好几本这样名字的书.这本书一开始好像在从哲学的角度来分析软件设计中什么才是最重要的,想把软件设计纳入科学的领域.书中新的内容不多,但有几个观点还是给我留下了深刻的印象,更多地是强调软件维护的重要性. “花更多的时间把程序写简单,相比一开始随意拼凑些代码再花大量的时间去理解,要快得多.” 所以需要不断地重构

React(六)Props属性

state 和 props 主要的区别在于 props 是不可变的,而 state 可以根据与用户交互来改变.这就是为什么有些容器组件需要定义 state 来更新和修改数据. 而子组件只能通过 props 来传递数据. (1)使用Props属性 class Mainextends React.Component { render() { return ( <div> <Name name={'yulingjia'} /> </div> ); } } class Name

组件的props属性和state状态

props属性: 我使用代码来说明React中props属性: // Profile.jsx import React from 'react' ; export default Class Profile extends React.Component { // render 是这个组件渲染的Vitrual DOM结构 render() { return ( <div className-"profile-component"> </*this.props就是传入的

创建组件的方法,组件的props属性、state属性的用法和特点,父子组件传值,兄弟组件传值

1.创建组件的方法   函数组件   class组件 1.1 函数组 无状态函数式组件形式上表现为一个只带有一个 `render()` 方法的组件类,通过函数形式或者 `ES6` 箭头 `function`的形式在创建,并且该组件是无state状态的.具体的创建形式如下 1 import React from 'react '; 2 3 //定义一个React组件 4 function App() { 5 return ( 6 <div> 7 hello React... 8 </div

RN Props属性

Props属性 - Props is short for “properties.” {pic}外围有一层括号,我们需要用括号来把pic这个变量嵌入到 JSX 语句中.括号的意思是括号内部为一个 js 变量或表达式,需要执行后取值.因此我们可以把任意合法的 JavaScript 表达式通过括号嵌入到 JSX 语句中. 自定义的组件也可以使用props.通过在不同的场景使用不同的属性定制,可以尽量提高自定义组件的复用范畴.只需在render函数中引用this.props,然后按需处理即可 原文地址