List 嵌套 Map
Excel list 中嵌套 map 的规范说明。
纵向 list 中的嵌套
纵向 list 中的横向 map
HelloWorld.xlsx 中的 worksheet ItemConf：
| ID | Name | Prop1ID | Prop1Value | Prop2ID | Prop2Value |
|---|---|---|---|---|---|
| [Item]uint32 | string | map<int32, Prop> | int64 | int32 | int64 |
| Item’s ID | Item’s name | Prop1’s ID | Prop1’s value | Prop2’s ID | Prop2’s value |
| 1 | Apple | 1 | 10 | 2 | 20 |
| 2 | Orange | 3 | 30 | ||
| 3 | Banana |
生成结果：
hello_world.proto
// --snip--
option (tableau.workbook) = {name:"HelloWorld.xlsx" namerow:1 typerow:2 noterow:3 datarow:4};
message ItemConf {
option (tableau.worksheet) = {name:"ItemConf"};
repeated Item item_list = 1 [(tableau.field) = {layout:LAYOUT_VERTICAL}];
message Item {
uint32 id = 1 [(tableau.field) = {name:"ID"}];
string name = 2 [(tableau.field) = {name:"Name"}];
map<int32, Prop> prop_map = 3 [(tableau.field) = {name:"Prop" key:"ID" layout:LAYOUT_HORIZONTAL}];
message Prop {
int32 id = 1 [(tableau.field) = {name:"ID"}];
int64 value = 2 [(tableau.field) = {name:"Value"}];
}
}
}
ItemConf.json
{
"itemList": [
{"id": 1, "name": "Apple", "propMap": {"1": {"id": 1, "value": "10"}, "2": {"id": 2, "value": "20"}}},
{"id": 2, "name": "Orange", "propMap": {"3": {"id": 3, "value": "30"}}},
{"id": 3, "name": "Banana", "propMap": {}}
]
}
纵向 keyed-list 中的纵向 map
HelloWorld.xlsx 中的 worksheet ItemConf：
| ID | Name | PropID | PropValue |
|---|---|---|---|
| [Item]<uint32> | string | map<int32, Prop> | int64 |
| Item’s ID | Item’s name | Prop’s ID | Prop’s value |
| 1 | Apple | 1 | 10 |
| 2 | Orange | 1 | 20 |
| 2 | Banana | 2 | 30 |
生成结果：
hello_world.proto
// --snip--
option (tableau.workbook) = {name:"HelloWorld.xlsx" namerow:1 typerow:2 noterow:3 datarow:4};
message ItemConf {
option (tableau.worksheet) = {name:"ItemConf"};
repeated Item item_list = 1 [(tableau.field) = {key:"ID" layout:LAYOUT_VERTICAL}];
message Item {
uint32 id = 1 [(tableau.field) = {name:"ID"}];
string name = 2 [(tableau.field) = {name:"Name"}];
map<int32, Prop> prop_map = 3 [(tableau.field) = {key:"PropID" layout:LAYOUT_VERTICAL}];
message Prop {
int32 prop_id = 1 [(tableau.field) = {name:"PropID"}];
int64 prop_value = 2 [(tableau.field) = {name:"PropValue"}];
}
}
}
ItemConf.json
{
"itemList": [
{"id": 1, "name": "Apple", "propMap": {"1": {"propId": 1, "propValue": "10"}}},
{"id": 2, "name": "Orange", "propMap": {"1": {"propId": 1, "propValue": "20"}, "2": {"propId": 2, "propValue": "30"}}}
]
}
纵向 list 中的 incell map
HelloWorld.xlsx 中的 worksheet ItemConf：
| ID | Props |
|---|---|
| [Item]uint32 | map<int32, string> |
| Item’s ID | Item’s props |
| 1 | 1:sour,2:sweet,3:delicious |
| 2 | 1:sour,2:sweet |
| 3 | 1:sour |
生成结果：
hello_world.proto
// --snip--
option (tableau.workbook) = {name:"HelloWorld.xlsx" namerow:1 typerow:2 noterow:3 datarow:4};
message ItemConf {
option (tableau.worksheet) = {name:"ItemConf"};
repeated Item item_list = 1 [(tableau.field) = {layout:LAYOUT_VERTICAL}];
message Item {
uint32 id = 1 [(tableau.field) = {name:"ID"}];
map<int32, string> props_map = 2 [(tableau.field) = {name:"Props" layout:LAYOUT_INCELL}];
}
}
ItemConf.json
{
"itemList": [
{"id": 1, "propsMap": {"1": "sour", "2": "sweet", "3": "delicious"}},
{"id": 2, "propsMap": {"1": "sour", "2": "sweet"}},
{"id": 3, "propsMap": {"1": "sour"}}
]
}
横向 list 的第一个字段
横向 list 中的横向 map
HelloWorld.xlsx 中的 worksheet ItemConf：
| Reward1Item1ID | Reward1Item1Num | Reward1Item2ID | Reward1Item2Num | Reward1Name | Reward2Item1ID | Reward2Item1Num | Reward2Name |
|---|---|---|---|---|---|---|---|
| [Reward]map<int32, Item> | int32 | int32 | int32 | string | int32 | int32 | string |
| Item1’s ID | Item1’s num | Item2’s ID | Item2’s num | Reward’s name | Item1’s ID | Item1’s num | Reward’s name |
| 1 | 10 | 2 | 20 | Lotto | 10 | 100 | Super Lotto |
生成结果：
hello_world.proto
// --snip--
option (tableau.workbook) = {name:"HelloWorld.xlsx" namerow:1 typerow:2 noterow:3 datarow:4};
message ItemConf {
option (tableau.worksheet) = {name:"ItemConf"};
repeated Reward reward_list = 1 [(tableau.field) = {name:"Reward" layout:LAYOUT_HORIZONTAL}];
message Reward {
map<int32, Item> item_map = 1 [(tableau.field) = {name:"Item" key:"ID" layout:LAYOUT_HORIZONTAL}];
message Item {
int32 id = 1 [(tableau.field) = {name:"ID"}];
int32 num = 2 [(tableau.field) = {name:"Num"}];
}
string name = 2 [(tableau.field) = {name:"Name"}];
}
}
ItemConf.json
{
"rewardList": [
{"itemMap": {"1": {"id": 1, "num": 10}, "2": {"id": 2, "num": 20}}, "name": "Lotto"},
{"itemMap": {"10": {"id": 10, "num": 100}}, "name": "Super Lotto"}
]
}
横向 list 中的 predefined struct map
common.proto 中预定义的 Item：
message Item {
int32 id = 1 [(tableau.field) = {name:"ID"}];
int32 num = 2 [(tableau.field) = {name:"Num"}];
}
HelloWorld.xlsx 中的 worksheet ItemConf：
| Reward1Item1ID | Reward1Item1Num | Reward1Item2ID | Reward1Item2Num | Reward1Name | Reward2Item1ID | Reward2Item1Num | Reward2Name |
|---|---|---|---|---|---|---|---|
| [Reward]map<int32, .Item> | int32 | int32 | int32 | string | int32 | int32 | string |
| Item1’s ID | Item1’s num | Item2’s ID | Item2’s num | Reward’s name | Item1’s ID | Item1’s num | Reward’s name |
| 1 | 10 | 2 | 20 | Lotto | 10 | 100 | Super Lotto |
生成结果：
hello_world.proto
// --snip--
import "common.proto";
option (tableau.workbook) = {name:"HelloWorld.xlsx" namerow:1 typerow:2 noterow:3 datarow:4};
message ItemConf {
option (tableau.worksheet) = {name:"ItemConf"};
repeated Reward reward_list = 1 [(tableau.field) = {name:"Reward" layout:LAYOUT_HORIZONTAL}];
message Reward {
map<int32, protoconf.Item> item_map = 1 [(tableau.field) = {name:"Item" key:"ID" layout:LAYOUT_HORIZONTAL}];
string name = 2 [(tableau.field) = {name:"Name"}];
}
}
ItemConf.json
{
"rewardList": [
{"itemMap": {"1": {"id": 1, "num": 10}, "2": {"id": 2, "num": 20}}, "name": "Lotto"},
{"itemMap": {"10": {"id": 10, "num": 100}}, "name": "Super Lotto"}
]
}