wrappers.proto 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157
  1. // Protocol Buffers - Google's data interchange format
  2. // Copyright 2008 Google Inc. All rights reserved.
  3. // https://developers.google.com/protocol-buffers/
  4. //
  5. // Redistribution and use in source and binary forms, with or without
  6. // modification, are permitted provided that the following conditions are
  7. // met:
  8. //
  9. // * Redistributions of source code must retain the above copyright
  10. // notice, this list of conditions and the following disclaimer.
  11. // * Redistributions in binary form must reproduce the above
  12. // copyright notice, this list of conditions and the following disclaimer
  13. // in the documentation and/or other materials provided with the
  14. // distribution.
  15. // * Neither the name of Google Inc. nor the names of its
  16. // contributors may be used to endorse or promote products derived from
  17. // this software without specific prior written permission.
  18. //
  19. // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20. // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21. // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22. // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  23. // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24. // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  25. // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26. // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27. // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28. // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  29. // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30. //
  31. // Wrappers for primitive (non-message) types. These types were needed
  32. // for legacy reasons and are not recommended for use in new APIs.
  33. //
  34. // Historically these wrappers were useful to have presence on proto3 primitive
  35. // fields, but proto3 syntax has been updated to support the `optional` keyword.
  36. // Using that keyword is now the strongly preferred way to add presence to
  37. // proto3 primitive fields.
  38. //
  39. // A secondary usecase was to embed primitives in the `google.protobuf.Any`
  40. // type: it is now recommended that you embed your value in your own wrapper
  41. // message which can be specifically documented.
  42. //
  43. // These wrappers have no meaningful use within repeated fields as they lack
  44. // the ability to detect presence on individual elements.
  45. // These wrappers have no meaningful use within a map or a oneof since
  46. // individual entries of a map or fields of a oneof can already detect presence.
  47. syntax = "proto3";
  48. package google.protobuf;
  49. option cc_enable_arenas = true;
  50. option go_package = "google.golang.org/protobuf/types/known/wrapperspb";
  51. option java_package = "com.google.protobuf";
  52. option java_outer_classname = "WrappersProto";
  53. option java_multiple_files = true;
  54. option objc_class_prefix = "GPB";
  55. option csharp_namespace = "Google.Protobuf.WellKnownTypes";
  56. // Wrapper message for `double`.
  57. //
  58. // The JSON representation for `DoubleValue` is JSON number.
  59. //
  60. // Not recommended for use in new APIs, but still useful for legacy APIs and
  61. // has no plan to be removed.
  62. message DoubleValue {
  63. // The double value.
  64. double value = 1;
  65. }
  66. // Wrapper message for `float`.
  67. //
  68. // The JSON representation for `FloatValue` is JSON number.
  69. //
  70. // Not recommended for use in new APIs, but still useful for legacy APIs and
  71. // has no plan to be removed.
  72. message FloatValue {
  73. // The float value.
  74. float value = 1;
  75. }
  76. // Wrapper message for `int64`.
  77. //
  78. // The JSON representation for `Int64Value` is JSON string.
  79. //
  80. // Not recommended for use in new APIs, but still useful for legacy APIs and
  81. // has no plan to be removed.
  82. message Int64Value {
  83. // The int64 value.
  84. int64 value = 1;
  85. }
  86. // Wrapper message for `uint64`.
  87. //
  88. // The JSON representation for `UInt64Value` is JSON string.
  89. //
  90. // Not recommended for use in new APIs, but still useful for legacy APIs and
  91. // has no plan to be removed.
  92. message UInt64Value {
  93. // The uint64 value.
  94. uint64 value = 1;
  95. }
  96. // Wrapper message for `int32`.
  97. //
  98. // The JSON representation for `Int32Value` is JSON number.
  99. //
  100. // Not recommended for use in new APIs, but still useful for legacy APIs and
  101. // has no plan to be removed.
  102. message Int32Value {
  103. // The int32 value.
  104. int32 value = 1;
  105. }
  106. // Wrapper message for `uint32`.
  107. //
  108. // The JSON representation for `UInt32Value` is JSON number.
  109. //
  110. // Not recommended for use in new APIs, but still useful for legacy APIs and
  111. // has no plan to be removed.
  112. message UInt32Value {
  113. // The uint32 value.
  114. uint32 value = 1;
  115. }
  116. // Wrapper message for `bool`.
  117. //
  118. // The JSON representation for `BoolValue` is JSON `true` and `false`.
  119. //
  120. // Not recommended for use in new APIs, but still useful for legacy APIs and
  121. // has no plan to be removed.
  122. message BoolValue {
  123. // The bool value.
  124. bool value = 1;
  125. }
  126. // Wrapper message for `string`.
  127. //
  128. // The JSON representation for `StringValue` is JSON string.
  129. //
  130. // Not recommended for use in new APIs, but still useful for legacy APIs and
  131. // has no plan to be removed.
  132. message StringValue {
  133. // The string value.
  134. string value = 1;
  135. }
  136. // Wrapper message for `bytes`.
  137. //
  138. // The JSON representation for `BytesValue` is JSON string.
  139. //
  140. // Not recommended for use in new APIs, but still useful for legacy APIs and
  141. // has no plan to be removed.
  142. message BytesValue {
  143. // The bytes value.
  144. bytes value = 1;
  145. }