YAML 是一种简洁的非标记语言(YAML Ain’t Markup Language),YAML以数据为中心,使用空白,缩进,分行组织数据,从而使得表示更加简洁易读, 常用于作为配置文件, 比json更加简洁。
对象和数组可以任意嵌套组合成负责的数据结构。
数据类型: 支持字符串、整数、浮点数、布尔、日期、null、对象、数组
在一个文件中,可同时包含多个文件,并用 ---分隔。选择性的符号"..."可以用来表示文件结尾(在利用流的通信中,这非常有用,可以在不关闭流的情况下,发送结束信号)
--- # 使用冒号:表示键值对, 冒号后面需要有一个空格, key需要顶格写,前面不能有空格 同一缩进的所有键值对属于一个map str: 这是一行字符串 # 字符串默认不使用引号表示 str2: '内容: 字符串' # 如果字符串之中包含空格或特殊字符,需要放在引号之中 str3: '内容n字符串' # 单引号和双引号都可以使用,双引号不会对特殊字符转义 str4: "内容n字符串" # 双引号对特殊字符不转义 str5: 'labor''s day' # 单引号之中如果还有单引号,需要使用单引号转义 # 字符串可以写成多行,从第二行开始,必须有一个单空格缩进。换行符会被转为空格 str6: 这是一段 多行 字符串 str7: | # "|"表示每行末尾都跟一个换行符 Foo Bar str8: > # “>” 最后一行跟一个换行符 Foo Bar str9: | Foo str10: |+ # +表示保留文字块末尾的换行 Foo str11: |- # -表示删除字符串末尾的换行 Foo str12: | # 字符串之中可以插入 HTML 标记 <p style="color: red"> 段落 </p> int: 10 float: 9.99 bool: true # true、false # 时间采用 ISO8601 格式 1点被转成9点 date: 2015-08-23 # 日期 datetime: 2015-08-23T02:02:00.1z # 日期时间 iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式 spaced: 2015-08-23 21:59:43.10 -5 # # 对象:缩进方式 obj: field1: x field2: field21: xx field22: xxx # 对象:行内方式(和json格式差不多) obj2: { field1: 'x', field2: { field21: 'xx', field22: 'xxx' } } # 数组:连字符方式,如果元素也是数组就再使用一层缩进 array: - ele1 - ele2 - - ele31 - ele32 # 行内方式 array2: [ 'ele1', 'ele2', [ 'ele31', 'ele32' ] ] # 数组中的原始是对象 array3: - field1: x field2: xx field3: xxx - field1: x field2: xx field3: xxx set: ? ele ? ele2 # 嵌套方式 nested: field1: x arr: - {field1: x, field2: x, field3: [1, 2, 3]} - {field1: x, field2: x, field3: [2, 3, 4]} arr2: - - a - b - - c - c # 类型转换: 使用两个感叹号跟要转换的基本数据类型,单引号:用于转换自定义对象 #下面是内置类型 #!!int # 整数类型 #!!float # 浮点类型 #!!bool # 布尔类型 #!!str # 字符串类型 #!!binary # 也是字符串类型 #!!timestamp # 日期时间类型 #!!null # 空值 #!!set # 集合 #!!omap, !!pairs # 键值列表或对象列表 #!!seq # 序列,也是列表 #!!map # 键值表 test: !!str 123 # 当键是数组或者对象时需要使用问号来标记 ?[blue, reg, green]: xxx ?{a:xx, b:xx}: xx # 锚点和引用 ref: - &index1 a - b - *index1 ...
yaml转成json的结果对比
{ str: '这是一行字符串', str2: '内容: 字符串', str3: '内容\n字符串', str4: '内容n字符串', str5: 'labor's day', str6: '这是一段 多行 字符串', str7: 'FoonBarn', str8: 'Foo Barn', str9: 'Foon', str10: 'Foonn', str11: 'Foo', str12: '<p style="color: red">n 段落n</p>n', int: 10, float: 9.99, bool: true, date: Sun Aug 23 2015 08:00:00 GMT+0800 (CST), datetime: '2015-08-23T02:02:00.1z', iso8601: Mon Aug 24 2015 10:59:43 GMT+0800 (CST), spaced: Mon Aug 24 2015 10:59:43 GMT+0800 (CST), obj: { field1: 'x', field2: { field21: 'xx', field22: 'xxx' } }, obj2: { field1: 'x', field2: { field21: 'xx', field22: 'xxx' } }, array: [ 'ele1', 'ele2', [ 'ele31', 'ele32' ] ], array2: [ 'ele1', 'ele2', [ 'ele31', 'ele32' ] ], array3: [ { field1: 'x', field2: 'xx', field3: 'xxx' }, { field1: 'x', field2: 'xx', field3: 'xxx' } ], set: { ele: null, ele2: null }, nested: { field1: 'x', arr: [ { field1: 'x', field2: 'x', field3: [ 1, 2, 3 ] }, { field1: 'x', field2: 'x', field3: [ 2, 3, 4 ] } ], arr2: [ [ 'a', 'b' ], [ 'c', 'c' ] ] }, test: '123', '?[blue, reg, green]': 'xxx', '?{a:xx, b:xx}': 'xx', ref: [ 'a', 'b', 'a' ] }
引入依赖
<!-- https://mvnrepository.com/artifact/org.yaml/snakeyaml --> <dependency> <groupId>org.yaml</groupId> <artifactId>snakeyaml</artifactId> <version>1.20</version> </dependency>
实体类
public class Address { private Long id; private String address; } public class UserInfo { private Long userId; private String username; } public class User { private Long id; private String name; private Integer age; private Date birthday; private float height; private double score; private boolean isVip; private String[] hobbies; private List<Address> addresses; private UserInfo userInfo; }
测试
public static void main(String[] args) throws Exception { UserInfo userInfo = new UserInfo(1L, "xiaoming"); Address address = new Address(1L, "上海市浦东新区"); Address address2 = new Address(2L, "北京市朝阳区"); List<Address> addresses = new ArrayList<Address>(); addresses.add(address); addresses.add(address2); User user = new User(1L, "小明", 20, new Date(), 178.88f, 99999.99, true, new String[]{"eat", "drink", "play", "happy"}, addresses, userInfo); Yaml yaml = new Yaml(); // 写入文件 yaml.dump(user, new FileWriter("/Users/mengday/Desktop/user.yml")); // 从文件中读 User user1 = yaml.loadAs(new FileInputStream(new File("/Users/mengday/Desktop/user.yml")), User.class); System.out.println(user1.toString()); }
结果
!!com.example.demo.User addresses: - {address: 上海市浦东新区, id: 1} - {address: 北京市朝阳区, id: 2} age: 20 birthday: 2018-03-13T09:30:38.586Z height: 178.88 hobbies: [eat, drink, play, happy] id: 1 name: 小明 score: 99999.99 userInfo: {userId: 1, username: xiaoming} vip: true User{id=1, name=’小明’, age=20, birthday=Tue Mar 13 17:30:38 CST 2018, height=178.88, score=99999.99, isVip=true, hobbies=[eat, drink, play, happy], addresses=[Address{id=1, address=’上海市浦东新区’}, Address{id=2, address=’北京市朝阳区’}], userInfo=UserInfo{userId=1, username=’xiaoming’}}