yaml使用方法

总览

有许多流行的基于文本的协议可用于通过网络交换数据。 这些包括XML，FIX和JSON。 编年史引擎使用YAML具有一些优点和缺点。

文字不是比二进制慢吗？

文本协议比二进制协议慢。 编码数字甚至是unicode字符串的成本都会增加CPU的开销。

尽管文本速度较慢，但​​它比二进制文件具有一个主要优势，那就是人类可读性强。 这使得在不使用框架的情况下更容易描述协议并为接口实现解决方案。

尽管二进制文件比文本文件快，但是您可能会发现文本足够快，在这种情况下，您希望使用的格式尽可能容易使用。

下面列出了序列化和反序列化具有6个不同类型字段的对象的延迟。 TextWire是YAML格式，BinaryWire是二进制格式，RawWire和SBE是其他二进制格式。

有关更多详细信息，请参阅Chronicle-Wire / microbenchmarks

所有时间都以微秒为单位：

通常在这些高百分位数中，常见的Java库通常由于GC暂停而显示出更高的结果。 即使在中等吞吐量下，该延迟抖动也开始变得很重要，例如，如果您每秒处理10,000条消息，则随后的抖动将延迟14-15条消息，而不仅仅是一条消息。

“ + C字节”是指与“历史字节”一起使用以回收缓冲区。

杰克逊有99.99％的好结果，而99.999％是1,405μS。

这些格式是什么样的？

TextWire

此格式具有4字节大小的前缀，该前缀在第一行中解码：

--- !!data
price: 1234
flag: true
text: Hello World!
side: Sell
smallInt: 123
longInt: 1234567890

BinaryWire与文本字段

这就是数据自动转换为文本时的外观。

--- !!data #binary
price: 1234
flag: true
text: Hello World!
side: Sell
smallInt: 123
longInt: 1234567890

BinaryWire与数字字段

这就是数据自动转换为文本时的外观。

--- !!data #binary
3: 1234
4: true
5: Hello World!
6: Sell
1: 123
2: 1234567890

没有元数据的RawWire

00000000 27 00 00 00 00 00 00 00  00 48 93 40 B1 0C 48 65 '······· ·H·@··He
00000010 6C 6C 6F 20 57 6F 72 6C  64 21 04 53 65 6C 6C 7B llo Worl d!·Sell{
00000020 00 00 00 D2 02 96 49 00  00 00 00                ······I· ···

可通过停止位编码进行编组

00000000 18 00 00 00 A0 A4 69 D2  85 D8 CC 04 7B 59 00 0C ······i· ····{Y··
00000010 48 65 6C 6C 6F 20 57 6F  72 6C 64 21             Hello Wo rld!

简单的二进制编码

00000000 29 00 7B 00 00 00 D2 02  96 49 00 00 00 00 00 00 )·{····· ·I······
00000010 00 00 00 48 93 40 01 0C  48 65 6C 6C 6F 20 57 6F ···H·@·· Hello Wo
00000020 72 6C 64 21 00 00 00 00  01 00 00                rld!···· ···

• 为获得完整的结果和不同的导线格式

可读

XML和JSON是派生的文本格式。 它们是SGML和Javascript的简化形式。 这意味着它可以被人类阅读，但并非为此目的而设计。 正如我们将看到的，不专门为人类可读性而设计具有一些优点。

YAML：一种用于人类可读的格式。

正如我们所看到的，YAML的优势在于它是专门为人类可读性而设计的。 这意味着它不那么冗长，并且具有更多的构造。

主要缺点是它是为人类可读性（而不是机器可读性）而设计的。尽管编写程序来以一种有品味的方式排列数据要困难得多，但它丰富的构造集意味着您可以按喜好排列数据。

一个相关的缺点是，由于存在更多支持的选项，其中一些选项留待解释，因此不同的实现可能会彼此不兼容。 例如， 如果需要 ，应将符号放在引号中，并且不同的库对于是否需要使用此类符号有不同的想法。 在规范中，有一些示例，其中带引号的字符串没有用双引号引起来。 也有两个引号，单引号和双引号。

那么为什么要使用YAML？

YAML的优势在于，它至少是为人类阅读而设计的。 它不是最快的格式，尽管它可以足够快，而且是一种易于阅读的格式。 如果将其与XML，JSON或FIX进行比较，则它们不是为提高速度而设计的，也不是特别可读。

协议文件

使用YAML可以轻松记录需要通过网络发送的内容。 我们具有针对不同功能的单元测试，在其中记录以文本形式发送和接收的内容。 我们围绕这些消息添加一些元数据，并具有可以直接包含在我们的文档中的输出。 这意味着我们有信心这是正确的。

作为文本，我们可以包括何时期望消息看起来像，并检测何时即使是很小的更改也很容易改变了消息内容。 这就像检查字符串匹配一样简单。 然后，IDE可以向您显示多行比较，以便您可以看到已更改的确切字段。

对于YAML缓慢，我们该怎么办？

我们使用高级API 编年史电线 ，您可以根据自己的喜好选择确切的电线格式。 这意味着一旦我们检查了文本协议是否有效，便可以切换到使用二进制协议。 我们使用YAML的二进制翻译，但是我们也可以使用RAW数据格式，该格式会剥离所有元数据以实现最大速度。

我们还提供了将“二进制YAML”自动转换为YAML的工具，以进行日志记录和调试。

结论

能够使用YAML进行测试和开发是开发新解决方案的有效方法，并且可以选择将选项转换为Binary形式以提高速度，这是兼具可读性和速度的好方法。

翻译自: https://www.javacodegeeks.com/2015/08/using-yaml-over-the-network.html

yaml使用方法