FAST协议详解4 存在图PMap-526互联

一、概述

存在图是比较基础但又非常重要的一个设定，如果存在图没搞对后面的解析肯定是有问题的。但要说清楚存在图又必须先搞明白各种数据类型、操作符、可空属性，所以存在图虽然在FAST数据流的最前面但又不得不放到最后来说。

二、存在图的基本设定

存在图主要与操作符类型强相关，但又与可空属性和数据类型有一点关系，这里我们以操作符作为主索引，依次进行实例演示。

操作符	可空属性	PMap	说明
DEFAULT默认	False/True	占1位	字段使用DEFAULT操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“默认值”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。
COPY复制	False/True	占1位	字符使用COPY操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值--即复制”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。
INCREMENT递增	False/True	占1位	字符使用INCREMENT操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值+1”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。
TAIL接尾	False/True	占1位	字符使用TAIL操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值”。若PMap中该位值为1，表明有传递值，则该字段解析结果为上一次传输值+接尾部分。
CONSTANT常量	False	不占位	字段使用CONSTANT操作符且可空属性为False时，在PMap中不占位。编码时无论该字段是否有设置值，流中均不传输任何值，解析方只根据预设的常量值解析。
CONSTANT常量	True	占1位	字段使用CONSTANT操作符且可空属性为True时，在PMap中占1位。编码时若该字段有设置值，则PMap中该位值为1，表明字段不为空，应解析为预设值。编码时若该字段未设置值，则PMap中该位值为0，表明字段为空，应解析为null。
NONE无	False/True	不占位	字段使用NONE操作符时，在PMap中不占位。即FAST流中一定会传输该字段值。

三、实例

1、DEFAULT默认操作符

操作符	可空属性	PMap	说明
DEFAULT默认	False/True	占1位	字段使用DEFAULT操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“默认值”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, 2}

msg111= -> {123, 3}

outByteStr=11100000,11111011,10000001,10000000,10100000,10000011,

二进制数据解析如下：

提前说明：需要注意模版ID字段在PMap中须占1位，根据“二、存在图的基本设定”，这里数据字段在PMap中须占1位。

二进制数	解码结果	说明
11100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段第三位是数据字段，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000001	1	根据PMap得知有传输数据字段，故数据字段=1
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明未传输该字段，根据字段属性，数据字段的值应该=2（默认值）
10100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明传输了数据字段
10000011	3	根据PMap得知有传输数据字段，故数据字段=3

问题：将可空属性修改为true如何

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, 2}

msg111= -> {123, null}

outByteStr=11100000,11111011,10000010,10000000,10100000,10000000,

二进制数据解析如下：

二进制数	解码结果	说明
11100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段第三位是数据字段，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000010	1 注：由于字段是可空的，所以需要自减1	根据PMap得知有传输数据字段，故数据字段=1
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明未传输该字段，根据字段属性，数据字段的值应该=2（默认值）
10100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明传输了数据字段
10000000	Null	根据PMap得知有传输数据字段，故数据字段=null

需要注意的是，由于可空属性，不设置该字段值时，也实际传递了10000000，同时PMap中第三位被置1表明传递了值。

问题：其他数据类型结果一致吗？

验证一致

2、COPY复制操作符

操作符	可空属性	PMap	说明
COPY复制	False/True	占1位	字符使用COPY操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值--即复制”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, 2}

outByteStr=11100000,11111011,10110001,10100000,10110010,10000000,

二进制数据解析如下：

二进制数	解码结果	说明
11100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段第三位是数据字段，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10110001	49	根据PMap得知有传输数据字段，故数据字段=“1”
10100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明有传输该字段
10110010	50	根据PMap得知有传输数据字段，故数据字段=“2”
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明未传输该字段，根据操作符COPY得知应复制上一次传输的结果“2”。

3、INCREMENT复制操作符

操作符	可空属性	PMap	说明
INCREMENT递增	False/True	占1位	字符使用INCREMENT操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值+1”。若PMap中该位值为1，表明有传递值，则该字段解析结果以传递值为准。

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, 3}

msg111= -> {123, 4}

outByteStr=11100000,11111011,10000001,10100000,10000011,10000000,

二进制数据解析如下：

二进制数	解码结果	说明
11100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段第三位是数据字段，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000001	1	根据PMap得知有传输数据字段，故数据字段=1
10100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明有传输该字段
10000011	3	根据PMap得知有传输数据字段，故数据字段=3
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明未传输该字段，根据操作符INCREMENT得知应将上一次传输的值+1，既=4。

4、TAIL接尾操作符

操作符	可空属性	PMap	说明
TAIL接尾	False/True	占1位	字符使用TAIL操作符后，在PMap中将占用1位用以表示是否有传输该字段值。若PMap中该位值为0，表明未传递值，则该字段解析结果为“上一次传输的值”。若PMap中该位值为1，表明有传递值，则该字段解析结果为上一次传输值+接尾部分。

上述代码运行结果如下：

msg111= -> {123, 111}

msg111= -> {123, 112}

outByteStr=11100000,11111011,00110001,00110001,10110001,10000000,10100000,10110010,

二进制数据解析如下：

二进制数	解码结果	说明
11100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段第三位是数据字段，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
00110001,00110001,10110001	“111”	根据PMap得知有传输数据字段，故数据字段=“111”
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明未传输该字段，根据操作符TAIL得知应解析为上一次传输的值“111”
10100000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 第三位是数据字段，这里表明有传输该字段值
10110010	“2”	根据操作符TAIL的特性，应将“111”的最后一位替换为“2”，既最终解析结果为“112”

5、DEFAULT默认操作符1

操作符	可空属性	PMap	说明
CONSTANT常量	False	不占位	字段使用CONSTANT操作符且可空属性为False时，在PMap中不占位。编码时无论该字段是否有设置值，流中均不传输任何值，解析方只根据预设的常量值解析。

上述代码运行结果如下：

msg111= -> {123, 2}

outByteStr=11000000,11111011,10000000,10000000,

二进制数据解析如下：

二进制数	解码结果	说明
11000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段对于CONSTANT操作符的字段，不占用PMap位，直接解析出预设值2
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 对于CONSTANT操作符的字段，不占用PMap位，直接解析出预设值2
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123 对于CONSTANT操作符的字段，不占用PMap位，直接解析出预设值2

问题：CONSTANT是否可以在编码时不设置值

上述代码运行结果如下：

msg111= -> {123, 2}

outByteStr=11000000,11111011,10000000,10000000,

可见编码时无论是否设置值，解码都会解码成预设的值，且FAST流中不会传输该字段值。

问题：在编码时是否可以设置与预设值不一样的？

答：实践证明不行，会报错

6、DEFAULT默认操作符2

操作符	可空属性	PMap	说明
CONSTANT常量	True	占1位	字段使用CONSTANT操作符且可空属性为True时，在PMap中占1位。编码时若该字段有设置值，则PMap中该位值为1，表明字段不为空，应解析为预设值。编码时若该字段未设置值，则PMap中该位值为0，表明字段为空，应解析为null。

上述代码运行结果如下：

msg111= -> {123, 2}

outByteStr=11100000,11111011,10100000,10100000,

上述代码运行结果如下：

msg111= -> {123, null}

outByteStr=11000000,11111011,10000000,10000000,

7、NONE无操作符

操作符	可空属性	PMap	说明
NONE无	False/True	不占位	字段使用NONE操作符时，在PMap中不占位。即FAST流中一定会传输该字段值。

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, 2}

msg111= -> {123, 3}

outByteStr=11000000,11111011,10000001,10000000,10000010,10000000,10000011,

二进制数据解析如下：

二进制数	解码结果	说明
11000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000001	1	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为1
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123
10000010	2	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为2
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123
10000011	3	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为3

问题：可空情况的处理

上述代码运行结果如下：

msg111= -> {123, 1}

msg111= -> {123, null}

msg111= -> {123, 3}

outByteStr=11000000,11111011,10000010,10000000,10000000,10000000,10000100,

二进制数据解析如下：

二进制数	解码结果	说明
11000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明有传输该字段
11111011	123	根据PMap得知有传输模版ID字段，故模版ID=123
10000010	1	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为2-1=1（可空字段要自行-1）
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123
10000000	Null	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为null（可空字段0就是null）
10000000	PMap	PMap第一位是停止位第二位是模版ID，这里表明未传输该字段，则模版ID值沿用上一次的结果=123
10000100	3	对于NONE操作符字段，不看PMap，一定会传输值，故这里数据字段解析为4-1=3（可空字段要自行-1）

四、回顾

通过实例分析可见，PMap其实与操作符强相关，且大部分操作符都会使字段在PMap中占1位，占位目的是为了通过0和1来标识字段是否传输值，比如copy操作符，如对应PMap位为1则表明不传输该字段值，则解码时自动复制上一次解码结果。

FAST

PMap

fast pmap

操作符tutorial fast pmap