I'm recently using gRPC
with proto3
, and I've noticed that required
and optional
has been removed in new syntax.
Would anyone kindly explain why required/optional are removed in proto3? Such kind of constraints just seem necessary to make definition robust.
syntax proto2:
message SearchRequest {
required string query = 1;
optional int32 page_number = 2;
optional int32 result_per_page = 3;
}
syntax proto3:
syntax = "proto3";
message SearchRequest {
string query = 1;
int32 page_number = 2;
int32 result_per_page = 3;
}
You can find the explanation in this protobuf Github issue:
The usefulness of
required
has been at the heart of many a debate and flame war. Large camps have existed on both sides. One camp liked guaranteeing a value was present and was willing to live with its limitations but the other camp feltrequired
dangerous or unhelpful as it can't be safely added nor removed.Let me explain more of the reasoning why
required
fields should be used sparingly. If you are already using a proto, you can't add a required field because old application's won't be providing that field and applications in general don't handle the failure well. You can make sure that all old applications are upgraded first, but it can be easy to make a mistake and it doesn't help if you are storing the protos in any datastore (even short-lived, like memcached). The same sort of situation applies when removing a required field.Many required fields were "obviously" required until... they weren't. Let's say you have an
id
field for aGet
method. That is obviously required. Except, later you might need to change theid
from int to string, or int32 to int64. That requires adding a newmuchBetterId
field, and now you are left with the oldid
field that must be specified, but eventually is completely ignored.When those two problems are combined, the number of beneficial
required
fields becomes limited and the camps argue over whether it still has value. The opponents ofrequired
weren't necessarily against the idea, but its current form. Some suggested developing a more expressive validation library that could checkrequired
along with something more advanced likename.length > 10
, while also making sure to have a better failure model.Proto3 overall seems to favor simplicity, and
required
removal is simpler. But maybe more convincing, removingrequired
made sense for proto3 when combined with other features, like removal of field presence for primitives and removal of overriding default values.I'm not a protobuf developer and am in no way authoritative on the subject, but I still hope that the explanation is useful.