Spring Boot入门教程(零): yaml使用详解

最新推荐文章于 2023-11-24 22:41:33 发布

HerbertZhangZane

最新推荐文章于 2023-11-24 22:41:33 发布

阅读量602

点赞数 1

分类专栏： Spring Boot入门教程文章标签： java spring spring boot yaml

原文链接：https://blog.csdn.net/vbirdbest/article/details/79541807

版权

Spring Boot入门教程专栏收录该内容

6 篇文章 0 订阅

订阅专栏

简介

YAML 是一种简洁的非标记语言(YAML Ain’t Markup Language),YAML以数据为中心，使用空白，缩进，分行组织数据，从而使得表示更加简洁易读，常用于作为配置文件, 比json更加简洁。

YAML 1.2 (3rd Edition): http://yaml.org/spec/1.2/spec.html
js-yaml: https://github.com/nodeca/js-yaml
YAML转化JSON: http://nodeca.github.io/js-yaml/

YAML 的设计目标：

人类容易阅读
可用于不同程序间的数据交换
适合描述程序所使用的数据结构，特别是脚本语言
丰富的表达能力与可扩展性
易于使用

YAML与XML、JSON比较

YAML 与 XML：具有 XML 同样的优点，但比 XML 更加简单、敏捷等
YAML 与 JSON
JSON 可以看作是 YAML 的子集，也就是说 JSON 能够做的事情，YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读，例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式，但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构，例如“关系锚点”可以表示数据引用（如重复数据的引用）

YAML的适用范围

由于实现简单，解析成本很低，YAML特别适合在脚本语言中使用。列一下现有的语言实现：Ruby，Java，Perl，Python，PHP，OCaml，JavaScript。除了Java，其他都是脚本语言.
YAML比较适合做序列化。因为它是宿主语言数据类型直转的，由于兼容性问题，不同语言间的数据流转建议现在不要用YAML.
YAML做配置文件也不错。比如Ruby on Rails的配置就选用的YAML。对ROR而言，这很自然，也很省事.

语法：

大小写敏感
使用缩进表示层级关系
禁止使用tab缩进，只能使用空格键 , 建议使用两个空格
缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
#表示注释，从这个字符一直到行尾，都会被解析器忽略。
字符串可以不用引号，也可以使用单引号或者双引号

数据结构

对象(键值表): 键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）冒号分隔键值对(Key: Value), Key需要顶格写，前面不能有空格，冒号后面需要有一个空格然后再跟值, 相同的缩进属于同一个map 例如age: 12
数组(列表): 一组按次序排列的值，又称为序列（sequence） / 列表（list）
纯量scalar: 数据最小的单位，不可以再分割。
对象和数组可以任意嵌套组合成负责的数据结构。

数据类型: 支持字符串、整数、浮点数、布尔、日期、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: 'Foo\nBar\n',
  str8: 'Foo Bar\n',
  str9: 'Foo\n',
  str10: 'Foo\n\n',
  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' ] }

Java解析

引入依赖

<!-- 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’}}

原文链接：https://blog.csdn.net/vbirdbest/article/details/79541807

HerbertZhangZane

关注

1
点赞
踩
3

收藏

觉得还不错? 一键收藏
0
评论
Spring Boot入门教程(零): yaml使用详解

简介YAML 是一种简洁的非标记语言(YAML Ain’t Markup Language),YAML以数据为中心，使用空白，缩进，分行组织数据，从而使得表示更加简洁易读，常用于作为配置文件, 比json更加简洁。YAML 1.2 (3rd Edition): http://yaml.org/spec/1.2/spec.htmljs-yaml: https://github.com/nod...
复制链接

扫一扫