首页 > 代码库 > YAML

YAML

YAML YAML Aint Markup Language。

YAML是一个类似GNU的递归式定义。GNU对Unix说“No”,YMAL则是对XML说“No”。而在Ruby的世界里,YAML可以说是Ruby流动的血液。YAML 之于Ruby,犹如XML之于Java。
为什么要向XML说“No”呢?因为:

YAML的可读性好。
YAML和脚本语言的交互性好。
YAML使用宿主语言的数据类型。
YAML有一个一致的信息模型。
YAML易于实现。

上面5条也就是XML不足的地方。同时,YAML也有XML的下列优点:
YAML可以基于流来处理;
YAML表达能力强,扩展性好。
总之,YAML试图用一种比XML更敏捷的方式,来完成XML所完成的任务。
YAML示例

首先用一个在Rails开发中一定会遇到的YAML文件——database.yml——作为示例。在你创建一个Rails工程后,Rails会自动给你创建一个这样的文件,它的路径是config/database.yml:
# MySQL (default setup).  Versions 4.1 and 5.0 are recommended.
# 此处省略一些注释。
development:
  adapter: mysql
  database: demo_development
  username: root
  password:
  host: localhost

# Warning: The database defined as ‘test‘ will be erased and
# re-generated from your development database when you run ‘rake‘.
# Do not set this db to the same as development or production.
test:
  adapter: mysql
  database: demo_test
  username: root
  password:
  host: localhost

production:
  adapter: mysql
  database: demo_production
  username: root
  password: 
  host: localhost
似乎很直观,对么?除去注释,会发现有三个组,分别用development、test和production标识。这三个组每个又有adapter、database、username、password和host这些属性。作为一个聪明的程序员,你一定已经意识到空格在这里发挥了作用!
完全正确!空格(注意:Tab不是)在YAML中用来表示代码的结构。上面的YAML文件可以被解析为一个哈希对象,它有三个元素,当然,每个元素又是一个哈希对象,下面是使用YAML::load(File.read(“database.yml”)) 方法获得的对象描述(为了保护视力和大脑,我进行了一些排版):
{
      development=> {adapter => mysql, database => demo_development,
                   ‘username’ => root, ‘password’ => nil, ‘host’ => localhost},
      ‘test’=> {‘adapter’ => mysql, ‘database’ => demo_test,
                   ‘username’ => root, ‘password’ => nil, ‘host’ => localhost},
      ‘production’=> {‘adapter’ => mysql, ‘database’ => demo_production,
                   ‘username’ => root, ‘password’ => nil, ‘host’ => localhost}
}
有了这个,你几乎就已经明白了所有在Rails中能遇到的YAML文件了,Rails中用到的YAML文件几乎永远是这种格式。例如,Rails为每个模型都会生成一个供单元测试使用的夹具(Fixture)文件,也是使用这种格式。
不过,Rails还加入了另外的灵活性。在这些属性中还可以使用Ruby代码!当然,对于数据库配置来说,这似乎用处不大,但是对于单元测试,有时你可能希望某个日期属性是当前测试的日期,那么这个功能就特别有用了。
Rails是怎样做到这个的,其实很简单。它在调用YAML::load方法之前先进行了ERB的解析,把Ruby代码执行后的结果再交给YAML进行加载,就可以得到这个小魔术了。下面是Rails加载数据库配置文件的代码:
YAML::load(ERB.new(IO.read(database_configuration_file)).result)
尽管Rails一般总是这样使用YAML,YAML实际上还有其他的一些用法,我们将在下面进行一些介绍。
YAML语言元素

下面对YAML的语言元素做一个简要介绍:
列表(List)
表示一个列表很简单,在每个条目前加入一个短横线。比如
- Item1
- Item2
- Item3
在Ruby中会被解释为数组对象(Array),上例为:
[“Item1”, “Item2”, “Item3”]
哈希表(Hash)
我们在前面的例子中已经大量使用了哈希表对象。哈希表的键/值之间用冒号(:)进行分隔。
key1 : value1
key2 : value2
key3 : value3
在Ruby中会被解释为如下的哈希对象:
{"key1"=>"value1", "key2"=>"value2", "key3"=>"value3"}
字符串和其它基本类型
YAML会自动判断类型,一般性的文字都会被解释为字符串。在有可能发生歧义的情况下,可以为字符串加上单引号或者双引号(在双引号下转义字符会被转义,转义方式与C语言类似)来避免歧义。
下面是一个例子,包含了字符串、整数、浮点数和日期类型:
1 : 1.0
1.0 : "1.0"
"1.0" : 2006-01-01
它会被解释为:
{1=>1.0, "1.0"=>#<Date: 4907473/2,0,2299161>, 1.0=>"1.0"}
可以看出它的类型被很好的识别出来。
字符串块
字符串可能会占据多行,可以用两种方式来处理这种情况,一种是保留换行符,另外一种则去除换行符。
用| 表示保留换行符:
|
  This is line1.
  This is line2.
  This is line3.
它会被解释为:
"This is line1./nThis is line2./nThis is line3.">表示删除换行符:
>
  Hello, 
  world.
会被解释为:
"Hello,  world."
以上是一些常用的基本类型,当然它们还可以组合为更复杂的结构,比如列表的内容可以是列表本身,也可以是哈希表;哈希表的内容也可以是列表或哈希表,它们可以嵌套使用,来获得非常复杂的结构。
对于重复出现的项目,可以用&进行定义,然后用*进行引用。下面用一个比较完整的例子来说明这些内容(该例子取自http://en.wikipedia.org/wiki/YAML#Sample_Document)。
logEvent:    Purchase Invoice
date:        2007-08-06
customer:
    given:   Dorothy
    family:  Gale

bill-to:  &id001
    street: | 
            123 Tornado Alley
            Suite 16
    city:   East Westville
    state:  KA

ship-to:  *id001   

items:
    - part_no:   A4786
      descrip:   Water Bucket (Filled)
      price:     1.47
      quantity:  4

    - part_no:   E1628
      descrip:   High Heeled "Ruby" Slippers 
      price:     100.27
      quantity:  1

specialDelivery:  >
    Follow the Yellow Brick
    Road to the Emerald City.
    Pay no attention to the 
    man behind the curtain.
它表示Ruby对象如下:
{
  "items"=>[
    {"price"=>1.47, "quantity"=>4, "part_no"=>"A4786", "descrip"=>"Water Bucket (Filled)"}, 
    {"price"=>100.27, "quantity"=>1, "part_no"=>"E1628", "descrip"=>"High Heeled /"Ruby/" Slippers"}
  ], 
  "bill-to"=>{"city"=>"East Westville", "street"=>"123 Tornado Alley/nSuite 16/n", "state"=>"KA"}, 
  "specialDelivery"=>"Follow the Yellow Brick Road to the Emerald City. Pay no attention to the  man behind the curtain.", 
  "date"=>#<Date: 4908637/2,0,2299161>, 
  "ship-to"=>{"city"=>"East Westville", "street"=>"123 Tornado Alley/nSuite 16/n", "state"=>"KA"}, 
  "customer"=>{"given"=>"Dorothy", "family"=>"Gale"}, 
  "logEvent"=>"Purchase Invoice"
}
YAML和JSON
近来火热的JSON可以看作是(几乎是)YAML的一个子集,一般说来,YAML的解析器都可以解析JSON文档。关于JSON的说明可以参见JSON的主页(http://json.org/),这里甚至还提供了一个中文版本的文档(http://json.org/json-zh.html)。
YAML相关资源:
· YAML主页:http://www.yaml.org/
· YAML维基百科:http://en.wikipedia.org/wiki/YAML
· Developerworks上的YAML简介:http://www.ibm.com/developerworks/cn/xml/x-cn-yamlintro/index.html







require yaml

hash = {1 => sqlite3, 2 => postgresql, 3 => mssql, 4 => mysql, 5 => oracle}

# write yaml file
File.open("/home/user002/data.yaml", "wb") {|f| YAML.dump(hash, f) }

# read yaml file
data = http://www.mamicode.com/YAML.load_file("/home/user002/data.yaml", "rb")

yml = YAML.load(File.open(unjs.txt))

 

YAML