YAML學習筆記

一、YAML簡介

YAML，即YAML Ain’t Markup Language的縮寫，YAML 是一種簡潔的非標記語言。YAML以數據為中心，使用空白，縮進，分行組織數據，從而使得表示更加簡潔易讀。

二、YAML語法

1、基本規則

YAML有以下基本規則：

1. 大小寫敏感

1. 使用縮進表示層級關系
2. 禁止使用tab縮進，只能使用空格鍵
3. 縮進長度沒有限制，只要元素對齊就表示這些元素屬于一個層級。
4. 使用#表示注釋

1. 字符串可以不用引號標注

2、數據類型

1. 字符串

#YAML
str: abc

#JSON
{str:'abc'
}

#YAML
#包含特殊字符需要加引號
str: '內容:字符串'

#JSON
{ str:'內容:字符串'
}

#YAML
#單雙引號均可，雙引號不會對特殊符號轉義
s1: '內容\n字符串'
s2: "內容\n字符串"

#JSON
{s1:'內容\\n字符串',s2:'內容\n字符串'
}

1. 布爾值
   布爾值用true和false表示

#YAML
isTrue: true
isTrue: false

#JSON
{isTrue:true,isTrue:false
}

1. 整數
   數值直接以字面形式表示

#YAML
int: 10

#JSON
{int:10
}

1. 浮點數
   數值直接以字面形式表示

float: 1.23
double: 2.34

#JSON
{float:1.23,double:2.34
}

1. Null
   null值用~表示

#YAML
person: ~

{person:null
}

1. 時間
   時間采用ISO8601格式表示

#YAML
iso8601: 2018-05-20t10:59:43.10-05:00

#JSON
{iso8601:new Date('2018-05-20t10:59:43.10-05:00')
}

1. 日期
   日期采用ISO8601的格式yyyy-MM-dd表示

#YAML
date: 2018-05-20

{date:new Date('2018-05-20')
}

注：YAML允許使用兩個感嘆號強制轉換類型

#YAML
str1: !!str 123
str2: !!str true

#JSON
{str1:'123',str2:'true'
}

3、數據結構

1. Map，散列表
使用:表示鍵值對，統一縮進的所有鍵值對屬于一個Map

name: John
age: 18
#也可以寫在一行
{ name: John, age: 18}

#JSON
{'name':'John','age': 18
}

2、List，數組
使用-來表示數組中的一個元素

#YAML
- a
- b
- c
#也可以寫在一行
[a, b, c]

#JSON
['a', 'b', 'c']

3、scalar，純量
數據的最小單位，不可再分割

4、數據結構的嵌套

YAML中的數據結構可以相互嵌套，嵌套方式有如下幾種：
1、Map嵌套Map

#YAML
websites:YAML: yaml.org Ruby: ruby-lang.org Python: python.org Perl: use.perl.org 

#JSON
{ websites: { YAML: 'yaml.org',Ruby: 'ruby-lang.org',Python: 'python.org',Perl: 'use.perl.org' } }

2、Map嵌套List

#YAML
languages:- Ruby- Perl- Python - c

#JSON
{languages:[ 'Ruby','Perl','Python','c'] 
}

3、List嵌套List

#YAML
-- Ruby- Perl- Python 
- - c- c++- java
#或者
- [Ruby,Perl,Python]
- [c,c++,java]

#JSON
[['Ruby','Perl','Python'],['c','c++','java']
]

4、List嵌套Map

#YAML
-name: Johnage: 18
- name: Lucyage: 16

#JSON
[{'name':'John','age':18},{'name':'Lucy','age':16}
]

三、Java對YAML文件的操作

1、SnakeYAML簡介

SnakeYAML是一個完整的YAML1.1規范Processor，支持UTF-8/UTF-16，支持Java對象的序列化/反序列化，支持所有YAML定義的類型。

2、SnakeYAML依賴添加

在pom文件中加入依賴

<dependency><groupId>org.yaml</groupId><artifactId>snakeyaml</artifactId><version>1.21</version>
</dependency>

3、SnakeYAML的使用方法

1. 建立Person類

import lombok.Data;//lombok為一種Java工具框架@Data
public class Person {private String name;private Integer age;
}

2、建立person.yml文件

# person.yml
!!com.demo.Person {age: 24, name: Adam}

3、讀取并解析YAML文件

1. <T> T load(InputStream input)

//獲取YAML中的單個對象
@Test
public void testLoadYaml() throws FileNotFoundException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");Person person = yaml.load(new FileInputStream(ymlFile));System.out.println(person);
}

輸出結果為：

Person(name=Adam, age=24)

//獲取YAML中的單個對象
@Test
public void testLoadYaml2() throws FileNotFoundException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");List<Person> personList = yaml.load(new FileInputStream(ymlFile));System.out.println(personList);
}

輸出結果為：

[Person(name=Adam, age=24), Person(name=Jack, age=24), Person(name=Steve, age=24)]

1. <T> T loadAs(InputStream input, Class<T> type)

//讀取YAML文件并返回一個對應類的對象
@Test
public void testLoadYaml() throws FileNotFoundException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");Person person = yaml.loadAs(new FileInputStream(ymlFile), Person.class);System.out.println(person);
}

輸出結果為：

Person(name=John, age=20)

1. Iterable<Object> loadAll(InputStream input)

//讀取YAML文件并返回一個Iterable接口的子類
@Test
public void testLoadAllYaml() throws FileNotFoundException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");Iterable<Object> people = yaml.loadAll(new FileInputStream(ymlFile));for (Object person : people) {System.out.println(person);}
}

輸出結果為：

[{name=John, age=20}, {name=Steven, age=30}, {name=Jenny, age=18}]

1. void dump(Object data, Writer output)

//將POJO寫入YAML文件
@Test
public void testDumpYaml() throws IOException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");Person person = new Person();person.setName("Adam");person.setAge(24);yaml.dump(person, new FileWriter(ymlFile));
}

輸出結果為：

!!com.liheng.demo.Person {age: 24, name: Adam}
注：dump方法會將YAML文件中的數據覆蓋

1. void dumpAll(Iterator<? extends Object> data, Writer output)

//通過Iterator迭代器批量寫入YAML文件
@Test
public void testDumpAllYaml() throws IOException {Yaml yaml = new Yaml();File ymlFile = new File(System.getProperty("user.dir") + "/src/main/resources/person.yml");Iterable<Object> people = yaml.loadAll(new FileInputStream(ymlFile));List<Person> personList = Lists.newArrayList();for (Object person : people) {LinkedHashMap map = (LinkedHashMap) person;Person p = new Person();p.setName((String) map.get("name"));p.setAge((Integer) map.get("age"));personList.add(p);}yaml.dumpAll(personList.iterator(), new FileWriter(ymlFile));
}

輸出結果為：

!!com.liheng.demo.Person {age: 20, name: John}
--- !!com.liheng.demo.Person {age: 30, name: Steven}
--- !!com.liheng.demo.Person {age: 18, name: Jenny}

?