简介
Yaml是一种“是一个可读性高并且容易被人类阅读,容易和脚本语言交互,用来表达资料序列的编程语言。”类似于XML但比XML更简洁,适合编写配置文件。
基本语法规则
- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键,只允许使用空格
- 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
支持的数据结构
- 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
- 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list)
- 纯量(scalars):单个的、不可再分的值
对象(键值对)
对象的一组键值对,使用冒号结构表示:
animal: pets
数组
一组连词线开头的行,构成一个数组:
- Cat
- Dog
- Goldfish
纯量
纯量是最基本的、不可再分的值:
- 字符串
- 布尔值
- 整数
- 浮点数
- Null
- 时间
- 日期
数值直接以字面量的形式表示:
number: 12.30
布尔值用true和false表示:
isSet: true
时间采用 ISO8601 格式:
iso8601: 2001-12-14t21:59:43.10-05:00
日期采用复合 iso8601 格式的年、月、日表示:
date: 1976-07-31
字符串默认不使用引号表示:
str: 这是一行字符串
如果字符串之中包含空格或特殊字符,需要放在引号之中:
str: '内容: 字符串'
单引号和双引号都可以使用,双引号不会对特殊字符转义:
s1: '内容\n字符串'
s2: "内容\n字符串"
YAML 允许使用两个感叹号,强制转换数据类型:
e: !!str 123
f: !!str true
复合结构
对象和数组可以结合使用,形成复合结构:
languages:
- Ruby
- Perl
- Python
websites:
YAML: yaml.org
Ruby: ruby-lang.org
Python: python.org
Perl: use.perl.org
java 操作 yaml 文件
java 中用封装好的类库 org.yaml.snakeyaml.Yaml 操作yaml。
加载yaml 文件,读取内容
public void load() throws FileNotFoundException{
//初始化Yaml解析器
Yaml yaml = new Yaml();
File f=new File("test.yaml");
//读入文件
// load方法支持String,InputStream,Reader作为输入
Object result= yaml.load(new FileInputStream(f));
System.out.println(result.getClass());
System.out.println( result);
}
test.yaml 文件内容
a: 1
b: 2
输出
class java.util.LinkedHashMap
{a=1, b=2}
一个yaml文件中可以存入多组配置并使用loadAll进行读取,多组之间使用三个横杠分开
public void loadall() throws FileNotFoundException {
Yaml yaml = new Yaml();
File f = new File("test.yaml");
Iterable<Object> result = yaml.loadAll(new FileInputStream(f));
for (Object obj : result) {
System.out.println(obj.getClass());
System.out.println(obj);
}
}
loadAlll()返回的是一个Iterable,每个对象的解析是在遍历到的时候进行的是懒加载的。
test.yaml 文件内容
a: 1
b: 2
---
c: 3
输出
class java.util.LinkedHashMap
{a=1, b=2}
class java.util.LinkedHashMap
{c=3}