хрень, но не уверен, что после переписывания будет не хрень. 
                  
                  
                  
                  
                  
                  сейчас есть такая тупая и топорная реализация простого GRPC API:
                  
                  
                  service Fabex {
                  
                  
                      rpc GetByTxId(Entry) returns (stream Entry);
                  
                  
                      rpc GetByBlocknum(Entry) returns (stream Entry);
                  
                  
                      rpc GetBlockInfoByPayload(Entry) returns (stream Entry);
                  
                  
                  }
                  
                  
                  
                  
                  
                  message Entry {
                  
                  
                      string channelid = 1;
                  
                  
                      string txid = 2;
                  
                  
                      string hash = 3;
                  
                  
                      string previoushash = 4;
                  
                  
                      uint64 blocknum = 5;
                  
                  
                      string payload = 6;
                  
                  
                      int64  time = 7;
                  
                  
                  }
                  
                  
                  
                  
                  
                  Везде, как видно, используется одно и то же сообщение  Entry, но когда мы вызываем GetByTxId, то заполняем только поле txid (GetByTxId(pb.Entry{Txid:"b10e65732"})), когда вызываем GetByBlocknum, то заполняем поле Blocknum соответственно. Не очень умно, да?
                  
                  
                  
                  
                  
                  Но если я сделаю микро-месседжи для каждой функции, будет тоже как-то не очень:
                  
                  
                  
                  
                  
                  service Fabex {
                  
                  
                      rpc Explore(RequestRange) returns (stream Entry);
                  
                  
                      rpc GetByTxId(TxID) returns (stream Entry);
                  
                  
                      rpc GetByBlocknum(Blocknum) returns (stream Entry);
                  
                  
                      rpc GetBlockInfoByPayload(Payload) returns (stream Entry);
                  
                  
                  }
                  
                  
                  
                  
                  
                  message RequestRange {
                  
                  
                      int64 startblock = 1;
                  
                  
                      int64 endblock = 2;
                  
                  
                  }
                  
                  
                  
                  
                  
                  message Entry {
                  
                  
                      string channelid = 1;
                  
                  
                      string txid = 2;
                  
                  
                      string hash = 3;
                  
                  
                      string previoushash = 4;
                  
                  
                      uint64 blocknum = 5;
                  
                  
                      string payload = 6;
                  
                  
                      int64  time = 7;
                  
                  
                  }
                  
                  
                  message TxID {
                  
                  
                      string value = 1;
                  
                  
                  }
                  
                  
                  
                  
                  
                  message Blocknum {
                  
                  
                      string value = 1;
                  
                  
                  }
                  
                  
                  
                  
                  
                  message Payload {
                  
                  
                      string payload = 1;
                  
                  
                  }
                  
                  
                  
                  
                  
                  А ведь API будет расширяться, и количество таких микро-месседжей будет множиться.
                  
                  
                  
                  
                  
                  Какой вариант считаете лучше?
                  
                  
                
сразу падает в глазa singular getter. Я обычно в случае API делают plural getter, потому-что их можно оптимизировать batch’ами
Обсуждают сегодня