java_map_field.cc 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797
  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. #include <google/protobuf/compiler/java/java_map_field.h>
  31. #include <google/protobuf/compiler/java/java_context.h>
  32. #include <google/protobuf/compiler/java/java_doc_comment.h>
  33. #include <google/protobuf/compiler/java/java_helpers.h>
  34. #include <google/protobuf/compiler/java/java_name_resolver.h>
  35. #include <google/protobuf/io/printer.h>
  36. namespace google {
  37. namespace protobuf {
  38. namespace compiler {
  39. namespace java {
  40. namespace {
  41. const FieldDescriptor* KeyField(const FieldDescriptor* descriptor) {
  42. GOOGLE_CHECK_EQ(FieldDescriptor::TYPE_MESSAGE, descriptor->type());
  43. const Descriptor* message = descriptor->message_type();
  44. GOOGLE_CHECK(message->options().map_entry());
  45. return message->FindFieldByName("key");
  46. }
  47. const FieldDescriptor* ValueField(const FieldDescriptor* descriptor) {
  48. GOOGLE_CHECK_EQ(FieldDescriptor::TYPE_MESSAGE, descriptor->type());
  49. const Descriptor* message = descriptor->message_type();
  50. GOOGLE_CHECK(message->options().map_entry());
  51. return message->FindFieldByName("value");
  52. }
  53. string TypeName(const FieldDescriptor* field,
  54. ClassNameResolver* name_resolver,
  55. bool boxed) {
  56. if (GetJavaType(field) == JAVATYPE_MESSAGE) {
  57. return name_resolver->GetImmutableClassName(field->message_type());
  58. } else if (GetJavaType(field) == JAVATYPE_ENUM) {
  59. return name_resolver->GetImmutableClassName(field->enum_type());
  60. } else {
  61. return boxed ? BoxedPrimitiveTypeName(GetJavaType(field))
  62. : PrimitiveTypeName(GetJavaType(field));
  63. }
  64. }
  65. string WireType(const FieldDescriptor* field) {
  66. return "com.google.protobuf.WireFormat.FieldType." +
  67. string(FieldTypeName(field->type()));
  68. }
  69. void SetMessageVariables(const FieldDescriptor* descriptor,
  70. int messageBitIndex,
  71. int builderBitIndex,
  72. const FieldGeneratorInfo* info,
  73. Context* context,
  74. std::map<string, string>* variables) {
  75. SetCommonFieldVariables(descriptor, info, variables);
  76. ClassNameResolver* name_resolver = context->GetNameResolver();
  77. (*variables)["type"] =
  78. name_resolver->GetImmutableClassName(descriptor->message_type());
  79. const FieldDescriptor* key = KeyField(descriptor);
  80. const FieldDescriptor* value = ValueField(descriptor);
  81. const JavaType keyJavaType = GetJavaType(key);
  82. const JavaType valueJavaType = GetJavaType(value);
  83. (*variables)["key_type"] = TypeName(key, name_resolver, false);
  84. string boxed_key_type = TypeName(key, name_resolver, true);
  85. (*variables)["boxed_key_type"] = boxed_key_type;
  86. // Used for calling the serialization function.
  87. (*variables)["short_key_type"] =
  88. boxed_key_type.substr(boxed_key_type.rfind('.') + 1);
  89. (*variables)["key_wire_type"] = WireType(key);
  90. (*variables)["key_default_value"] = DefaultValue(key, true, name_resolver);
  91. (*variables)["key_null_check"] = IsReferenceType(keyJavaType) ?
  92. "if (key == null) { throw new java.lang.NullPointerException(); }" : "";
  93. (*variables)["value_null_check"] = IsReferenceType(valueJavaType) ?
  94. "if (value == null) { throw new java.lang.NullPointerException(); }" : "";
  95. if (valueJavaType == JAVATYPE_ENUM) {
  96. // We store enums as Integers internally.
  97. (*variables)["value_type"] = "int";
  98. (*variables)["boxed_value_type"] = "java.lang.Integer";
  99. (*variables)["value_wire_type"] = WireType(value);
  100. (*variables)["value_default_value"] =
  101. DefaultValue(value, true, name_resolver) + ".getNumber()";
  102. (*variables)["value_enum_type"] = TypeName(value, name_resolver, false);
  103. if (SupportUnknownEnumValue(descriptor->file())) {
  104. // Map unknown values to a special UNRECOGNIZED value if supported.
  105. (*variables)["unrecognized_value"] =
  106. (*variables)["value_enum_type"] + ".UNRECOGNIZED";
  107. } else {
  108. // Map unknown values to the default value if we don't have UNRECOGNIZED.
  109. (*variables)["unrecognized_value"] =
  110. DefaultValue(value, true, name_resolver);
  111. }
  112. } else {
  113. (*variables)["value_type"] = TypeName(value, name_resolver, false);
  114. (*variables)["boxed_value_type"] = TypeName(value, name_resolver, true);
  115. (*variables)["value_wire_type"] = WireType(value);
  116. (*variables)["value_default_value"] =
  117. DefaultValue(value, true, name_resolver);
  118. }
  119. (*variables)["type_parameters"] =
  120. (*variables)["boxed_key_type"] + ", " + (*variables)["boxed_value_type"];
  121. // TODO(birdo): Add @deprecated javadoc when generating javadoc is supported
  122. // by the proto compiler
  123. (*variables)["deprecation"] = descriptor->options().deprecated()
  124. ? "@java.lang.Deprecated " : "";
  125. (*variables)["on_changed"] = "onChanged();";
  126. // For repeated fields, one bit is used for whether the array is immutable
  127. // in the parsing constructor.
  128. (*variables)["get_mutable_bit_parser"] =
  129. GenerateGetBitMutableLocal(builderBitIndex);
  130. (*variables)["set_mutable_bit_parser"] =
  131. GenerateSetBitMutableLocal(builderBitIndex);
  132. (*variables)["default_entry"] = (*variables)["capitalized_name"] +
  133. "DefaultEntryHolder.defaultEntry";
  134. (*variables)["map_field_parameter"] = (*variables)["default_entry"];
  135. (*variables)["descriptor"] =
  136. name_resolver->GetImmutableClassName(descriptor->file()) +
  137. ".internal_" + UniqueFileScopeIdentifier(descriptor->message_type()) +
  138. "_descriptor, ";
  139. (*variables)["ver"] = GeneratedCodeVersionSuffix();
  140. }
  141. } // namespace
  142. ImmutableMapFieldGenerator::
  143. ImmutableMapFieldGenerator(const FieldDescriptor* descriptor,
  144. int messageBitIndex,
  145. int builderBitIndex,
  146. Context* context)
  147. : descriptor_(descriptor), name_resolver_(context->GetNameResolver()) {
  148. SetMessageVariables(descriptor, messageBitIndex, builderBitIndex,
  149. context->GetFieldGeneratorInfo(descriptor),
  150. context, &variables_);
  151. }
  152. ImmutableMapFieldGenerator::
  153. ~ImmutableMapFieldGenerator() {}
  154. int ImmutableMapFieldGenerator::GetNumBitsForMessage() const {
  155. return 0;
  156. }
  157. int ImmutableMapFieldGenerator::GetNumBitsForBuilder() const {
  158. return 1;
  159. }
  160. void ImmutableMapFieldGenerator::
  161. GenerateInterfaceMembers(io::Printer* printer) const {
  162. WriteFieldDocComment(printer, descriptor_);
  163. printer->Print(
  164. variables_,
  165. "$deprecation$int ${$get$capitalized_name$Count$}$();\n");
  166. printer->Annotate("{", "}", descriptor_);
  167. WriteFieldDocComment(printer, descriptor_);
  168. printer->Print(
  169. variables_,
  170. "$deprecation$boolean ${$contains$capitalized_name$$}$(\n"
  171. " $key_type$ key);\n");
  172. printer->Annotate("{", "}", descriptor_);
  173. if (GetJavaType(ValueField(descriptor_)) == JAVATYPE_ENUM) {
  174. printer->Print(
  175. variables_,
  176. "/**\n"
  177. " * Use {@link #get$capitalized_name$Map()} instead.\n"
  178. " */\n"
  179. "@java.lang.Deprecated\n"
  180. "java.util.Map<$boxed_key_type$, $value_enum_type$>\n"
  181. "${$get$capitalized_name$$}$();\n");
  182. printer->Annotate("{", "}", descriptor_);
  183. WriteFieldDocComment(printer, descriptor_);
  184. printer->Print(
  185. variables_,
  186. "$deprecation$java.util.Map<$boxed_key_type$, $value_enum_type$>\n"
  187. "${$get$capitalized_name$Map$}$();\n");
  188. printer->Annotate("{", "}", descriptor_);
  189. WriteFieldDocComment(printer, descriptor_);
  190. printer->Print(
  191. variables_,
  192. "$deprecation$$value_enum_type$ ${$get$capitalized_name$OrDefault$}$(\n"
  193. " $key_type$ key,\n"
  194. " $value_enum_type$ defaultValue);\n");
  195. printer->Annotate("{", "}", descriptor_);
  196. WriteFieldDocComment(printer, descriptor_);
  197. printer->Print(
  198. variables_,
  199. "$deprecation$$value_enum_type$ ${$get$capitalized_name$OrThrow$}$(\n"
  200. " $key_type$ key);\n");
  201. printer->Annotate("{", "}", descriptor_);
  202. if (SupportUnknownEnumValue(descriptor_->file())) {
  203. printer->Print(
  204. variables_,
  205. "/**\n"
  206. " * Use {@link #get$capitalized_name$ValueMap()} instead.\n"
  207. " */\n"
  208. "@java.lang.Deprecated\n"
  209. "java.util.Map<$type_parameters$>\n"
  210. "${$get$capitalized_name$Value$}$();\n");
  211. printer->Annotate("{", "}", descriptor_);
  212. WriteFieldDocComment(printer, descriptor_);
  213. printer->Print(
  214. variables_,
  215. "$deprecation$java.util.Map<$type_parameters$>\n"
  216. "${$get$capitalized_name$ValueMap$}$();\n");
  217. printer->Annotate("{", "}", descriptor_);
  218. WriteFieldDocComment(printer, descriptor_);
  219. printer->Print(
  220. variables_,
  221. "$deprecation$\n"
  222. "$value_type$ ${$get$capitalized_name$ValueOrDefault$}$(\n"
  223. " $key_type$ key,\n"
  224. " $value_type$ defaultValue);\n");
  225. printer->Annotate("{", "}", descriptor_);
  226. WriteFieldDocComment(printer, descriptor_);
  227. printer->Print(
  228. variables_,
  229. "$deprecation$\n"
  230. "$value_type$ ${$get$capitalized_name$ValueOrThrow$}$(\n"
  231. " $key_type$ key);\n");
  232. printer->Annotate("{", "}", descriptor_);
  233. }
  234. } else {
  235. printer->Print(
  236. variables_,
  237. "/**\n"
  238. " * Use {@link #get$capitalized_name$Map()} instead.\n"
  239. " */\n"
  240. "@java.lang.Deprecated\n"
  241. "java.util.Map<$type_parameters$>\n"
  242. "${$get$capitalized_name$$}$();\n");
  243. printer->Annotate("{", "}", descriptor_);
  244. WriteFieldDocComment(printer, descriptor_);
  245. printer->Print(
  246. variables_,
  247. "$deprecation$java.util.Map<$type_parameters$>\n"
  248. "${$get$capitalized_name$Map$}$();\n");
  249. printer->Annotate("{", "}", descriptor_);
  250. WriteFieldDocComment(printer, descriptor_);
  251. printer->Print(
  252. variables_,
  253. "$deprecation$\n"
  254. "$value_type$ ${$get$capitalized_name$OrDefault$}$(\n"
  255. " $key_type$ key,\n"
  256. " $value_type$ defaultValue);\n");
  257. printer->Annotate("{", "}", descriptor_);
  258. WriteFieldDocComment(printer, descriptor_);
  259. printer->Print(
  260. variables_,
  261. "$deprecation$\n"
  262. "$value_type$ ${$get$capitalized_name$OrThrow$}$(\n"
  263. " $key_type$ key);\n");
  264. printer->Annotate("{", "}", descriptor_);
  265. }
  266. }
  267. void ImmutableMapFieldGenerator::
  268. GenerateMembers(io::Printer* printer) const {
  269. printer->Print(
  270. variables_,
  271. "private static final class $capitalized_name$DefaultEntryHolder {\n"
  272. " static final com.google.protobuf.MapEntry<\n"
  273. " $type_parameters$> defaultEntry =\n"
  274. " com.google.protobuf.MapEntry\n"
  275. " .<$type_parameters$>newDefaultInstance(\n"
  276. " $descriptor$\n"
  277. " $key_wire_type$,\n"
  278. " $key_default_value$,\n"
  279. " $value_wire_type$,\n"
  280. " $value_default_value$);\n"
  281. "}\n");
  282. printer->Print(
  283. variables_,
  284. "private com.google.protobuf.MapField<\n"
  285. " $type_parameters$> $name$_;\n"
  286. "private com.google.protobuf.MapField<$type_parameters$>\n"
  287. "internalGet$capitalized_name$() {\n"
  288. " if ($name$_ == null) {\n"
  289. " return com.google.protobuf.MapField.emptyMapField(\n"
  290. " $map_field_parameter$);\n"
  291. " }\n"
  292. " return $name$_;\n"
  293. "}\n");
  294. if (GetJavaType(ValueField(descriptor_)) == JAVATYPE_ENUM) {
  295. printer->Print(
  296. variables_,
  297. "private static final\n"
  298. "com.google.protobuf.Internal.MapAdapter.Converter<\n"
  299. " java.lang.Integer, $value_enum_type$> $name$ValueConverter =\n"
  300. " com.google.protobuf.Internal.MapAdapter.newEnumConverter(\n"
  301. " $value_enum_type$.internalGetValueMap(),\n"
  302. " $unrecognized_value$);\n");
  303. printer->Print(
  304. variables_,
  305. "private static final java.util.Map<$boxed_key_type$, "
  306. "$value_enum_type$>\n"
  307. "internalGetAdapted$capitalized_name$Map(\n"
  308. " java.util.Map<$boxed_key_type$, $boxed_value_type$> map) {\n"
  309. " return new com.google.protobuf.Internal.MapAdapter<\n"
  310. " $boxed_key_type$, $value_enum_type$, java.lang.Integer>(\n"
  311. " map, $name$ValueConverter);\n"
  312. "}\n");
  313. }
  314. GenerateMapGetters(printer);
  315. }
  316. void ImmutableMapFieldGenerator::
  317. GenerateBuilderMembers(io::Printer* printer) const {
  318. printer->Print(
  319. variables_,
  320. "private com.google.protobuf.MapField<\n"
  321. " $type_parameters$> $name$_;\n"
  322. "private com.google.protobuf.MapField<$type_parameters$>\n"
  323. "internalGet$capitalized_name$() {\n"
  324. " if ($name$_ == null) {\n"
  325. " return com.google.protobuf.MapField.emptyMapField(\n"
  326. " $map_field_parameter$);\n"
  327. " }\n"
  328. " return $name$_;\n"
  329. "}\n"
  330. "private com.google.protobuf.MapField<$type_parameters$>\n"
  331. "internalGetMutable$capitalized_name$() {\n"
  332. " $on_changed$;\n"
  333. " if ($name$_ == null) {\n"
  334. " $name$_ = com.google.protobuf.MapField.newMapField(\n"
  335. " $map_field_parameter$);\n"
  336. " }\n"
  337. " if (!$name$_.isMutable()) {\n"
  338. " $name$_ = $name$_.copy();\n"
  339. " }\n"
  340. " return $name$_;\n"
  341. "}\n");
  342. GenerateMapGetters(printer);
  343. printer->Print(
  344. variables_,
  345. "$deprecation$\n"
  346. "public Builder ${$clear$capitalized_name$$}$() {\n"
  347. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  348. " .clear();\n"
  349. " return this;\n"
  350. "}\n");
  351. printer->Annotate("{", "}", descriptor_);
  352. WriteFieldDocComment(printer, descriptor_);
  353. printer->Print(
  354. variables_,
  355. "$deprecation$\n"
  356. "public Builder ${$remove$capitalized_name$$}$(\n"
  357. " $key_type$ key) {\n"
  358. " $key_null_check$\n"
  359. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  360. " .remove(key);\n"
  361. " return this;\n"
  362. "}\n");
  363. printer->Annotate("{", "}", descriptor_);
  364. if (GetJavaType(ValueField(descriptor_)) == JAVATYPE_ENUM) {
  365. printer->Print(
  366. variables_,
  367. "/**\n"
  368. " * Use alternate mutation accessors instead.\n"
  369. " */\n"
  370. "@java.lang.Deprecated\n"
  371. "public java.util.Map<$boxed_key_type$, $value_enum_type$>\n"
  372. "${$getMutable$capitalized_name$$}$() {\n"
  373. " return internalGetAdapted$capitalized_name$Map(\n"
  374. " internalGetMutable$capitalized_name$().getMutableMap());\n"
  375. "}\n");
  376. printer->Annotate("{", "}", descriptor_);
  377. WriteFieldDocComment(printer, descriptor_);
  378. printer->Print(variables_,
  379. "$deprecation$public Builder ${$put$capitalized_name$$}$(\n"
  380. " $key_type$ key,\n"
  381. " $value_enum_type$ value) {\n"
  382. " $key_null_check$\n"
  383. " $value_null_check$\n"
  384. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  385. " .put(key, $name$ValueConverter.doBackward(value));\n"
  386. " return this;\n"
  387. "}\n");
  388. printer->Annotate("{", "}", descriptor_);
  389. WriteFieldDocComment(printer, descriptor_);
  390. printer->Print(
  391. variables_,
  392. "$deprecation$public Builder ${$putAll$capitalized_name$$}$(\n"
  393. " java.util.Map<$boxed_key_type$, $value_enum_type$> values) {\n"
  394. " internalGetAdapted$capitalized_name$Map(\n"
  395. " internalGetMutable$capitalized_name$().getMutableMap())\n"
  396. " .putAll(values);\n"
  397. " return this;\n"
  398. "}\n");
  399. printer->Annotate("{", "}", descriptor_);
  400. if (SupportUnknownEnumValue(descriptor_->file())) {
  401. printer->Print(
  402. variables_,
  403. "/**\n"
  404. " * Use alternate mutation accessors instead.\n"
  405. " */\n"
  406. "@java.lang.Deprecated\n"
  407. "public java.util.Map<$boxed_key_type$, $boxed_value_type$>\n"
  408. "${$getMutable$capitalized_name$Value$}$() {\n"
  409. " return internalGetMutable$capitalized_name$().getMutableMap();\n"
  410. "}\n");
  411. printer->Annotate("{", "}", descriptor_);
  412. WriteFieldDocComment(printer, descriptor_);
  413. printer->Print(
  414. variables_,
  415. "$deprecation$public Builder ${$put$capitalized_name$Value$}$(\n"
  416. " $key_type$ key,\n"
  417. " $value_type$ value) {\n"
  418. " $key_null_check$\n"
  419. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  420. " .put(key, value);\n"
  421. " return this;\n"
  422. "}\n");
  423. printer->Annotate("{", "}", descriptor_);
  424. WriteFieldDocComment(printer, descriptor_);
  425. printer->Print(
  426. variables_,
  427. "$deprecation$public Builder ${$putAll$capitalized_name$Value$}$(\n"
  428. " java.util.Map<$boxed_key_type$, $boxed_value_type$> values) {\n"
  429. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  430. " .putAll(values);\n"
  431. " return this;\n"
  432. "}\n");
  433. printer->Annotate("{", "}", descriptor_);
  434. }
  435. } else {
  436. printer->Print(
  437. variables_,
  438. "/**\n"
  439. " * Use alternate mutation accessors instead.\n"
  440. " */\n"
  441. "@java.lang.Deprecated\n"
  442. "public java.util.Map<$type_parameters$>\n"
  443. "${$getMutable$capitalized_name$$}$() {\n"
  444. " return internalGetMutable$capitalized_name$().getMutableMap();\n"
  445. "}\n");
  446. printer->Annotate("{", "}", descriptor_);
  447. WriteFieldDocComment(printer, descriptor_);
  448. printer->Print(
  449. variables_,
  450. "$deprecation$"
  451. "public Builder ${$put$capitalized_name$$}$(\n"
  452. " $key_type$ key,\n"
  453. " $value_type$ value) {\n"
  454. " $key_null_check$\n"
  455. " $value_null_check$\n"
  456. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  457. " .put(key, value);\n"
  458. " return this;\n"
  459. "}\n");
  460. printer->Annotate("{", "}", descriptor_);
  461. WriteFieldDocComment(printer, descriptor_);
  462. printer->Print(
  463. variables_,
  464. "$deprecation$\n"
  465. "public Builder ${$putAll$capitalized_name$$}$(\n"
  466. " java.util.Map<$type_parameters$> values) {\n"
  467. " internalGetMutable$capitalized_name$().getMutableMap()\n"
  468. " .putAll(values);\n"
  469. " return this;\n"
  470. "}\n");
  471. printer->Annotate("{", "}", descriptor_);
  472. }
  473. }
  474. void ImmutableMapFieldGenerator::
  475. GenerateMapGetters(io::Printer* printer) const {
  476. printer->Print(
  477. variables_,
  478. "$deprecation$\n"
  479. "public int ${$get$capitalized_name$Count$}$() {\n"
  480. " return internalGet$capitalized_name$().getMap().size();\n"
  481. "}\n");
  482. printer->Annotate("{", "}", descriptor_);
  483. WriteFieldDocComment(printer, descriptor_);
  484. printer->Print(
  485. variables_,
  486. "$deprecation$\n"
  487. "public boolean ${$contains$capitalized_name$$}$(\n"
  488. " $key_type$ key) {\n"
  489. " $key_null_check$\n"
  490. " return internalGet$capitalized_name$().getMap().containsKey(key);\n"
  491. "}\n");
  492. printer->Annotate("{", "}", descriptor_);
  493. if (GetJavaType(ValueField(descriptor_)) == JAVATYPE_ENUM) {
  494. printer->Print(
  495. variables_,
  496. "/**\n"
  497. " * Use {@link #get$capitalized_name$Map()} instead.\n"
  498. " */\n"
  499. "@java.lang.Deprecated\n"
  500. "public java.util.Map<$boxed_key_type$, $value_enum_type$>\n"
  501. "${$get$capitalized_name$$}$() {\n"
  502. " return get$capitalized_name$Map();\n"
  503. "}\n");
  504. printer->Annotate("{", "}", descriptor_);
  505. WriteFieldDocComment(printer, descriptor_);
  506. printer->Print(
  507. variables_,
  508. "$deprecation$\n"
  509. "public java.util.Map<$boxed_key_type$, $value_enum_type$>\n"
  510. "${$get$capitalized_name$Map$}$() {\n"
  511. " return internalGetAdapted$capitalized_name$Map(\n"
  512. " internalGet$capitalized_name$().getMap());"
  513. "}\n");
  514. printer->Annotate("{", "}", descriptor_);
  515. WriteFieldDocComment(printer, descriptor_);
  516. printer->Print(
  517. variables_,
  518. "$deprecation$\n"
  519. "public $value_enum_type$ ${$get$capitalized_name$OrDefault$}$(\n"
  520. " $key_type$ key,\n"
  521. " $value_enum_type$ defaultValue) {\n"
  522. " $key_null_check$\n"
  523. " java.util.Map<$boxed_key_type$, $boxed_value_type$> map =\n"
  524. " internalGet$capitalized_name$().getMap();\n"
  525. " return map.containsKey(key)\n"
  526. " ? $name$ValueConverter.doForward(map.get(key))\n"
  527. " : defaultValue;\n"
  528. "}\n");
  529. printer->Annotate("{", "}", descriptor_);
  530. WriteFieldDocComment(printer, descriptor_);
  531. printer->Print(
  532. variables_,
  533. "$deprecation$\n"
  534. "public $value_enum_type$ ${$get$capitalized_name$OrThrow$}$(\n"
  535. " $key_type$ key) {\n"
  536. " $key_null_check$\n"
  537. " java.util.Map<$boxed_key_type$, $boxed_value_type$> map =\n"
  538. " internalGet$capitalized_name$().getMap();\n"
  539. " if (!map.containsKey(key)) {\n"
  540. " throw new java.lang.IllegalArgumentException();\n"
  541. " }\n"
  542. " return $name$ValueConverter.doForward(map.get(key));\n"
  543. "}\n");
  544. printer->Annotate("{", "}", descriptor_);
  545. if (SupportUnknownEnumValue(descriptor_->file())) {
  546. printer->Print(
  547. variables_,
  548. "/**\n"
  549. " * Use {@link #get$capitalized_name$ValueMap()} instead.\n"
  550. " */\n"
  551. "@java.lang.Deprecated\n"
  552. "public java.util.Map<$boxed_key_type$, $boxed_value_type$>\n"
  553. "${$get$capitalized_name$Value$}$() {\n"
  554. " return get$capitalized_name$ValueMap();\n"
  555. "}\n");
  556. printer->Annotate("{", "}", descriptor_);
  557. WriteFieldDocComment(printer, descriptor_);
  558. printer->Print(
  559. variables_,
  560. "$deprecation$\n"
  561. "public java.util.Map<$boxed_key_type$, $boxed_value_type$>\n"
  562. "${$get$capitalized_name$ValueMap$}$() {\n"
  563. " return internalGet$capitalized_name$().getMap();\n"
  564. "}\n");
  565. printer->Annotate("{", "}", descriptor_);
  566. WriteFieldDocComment(printer, descriptor_);
  567. printer->Print(
  568. variables_,
  569. "$deprecation$\n"
  570. "public $value_type$ ${$get$capitalized_name$ValueOrDefault$}$(\n"
  571. " $key_type$ key,\n"
  572. " $value_type$ defaultValue) {\n"
  573. " $key_null_check$\n"
  574. " java.util.Map<$boxed_key_type$, $boxed_value_type$> map =\n"
  575. " internalGet$capitalized_name$().getMap();\n"
  576. " return map.containsKey(key) ? map.get(key) : defaultValue;\n"
  577. "}\n");
  578. printer->Annotate("{", "}", descriptor_);
  579. WriteFieldDocComment(printer, descriptor_);
  580. printer->Print(
  581. variables_,
  582. "$deprecation$\n"
  583. "public $value_type$ ${$get$capitalized_name$ValueOrThrow$}$(\n"
  584. " $key_type$ key) {\n"
  585. " $key_null_check$\n"
  586. " java.util.Map<$boxed_key_type$, $boxed_value_type$> map =\n"
  587. " internalGet$capitalized_name$().getMap();\n"
  588. " if (!map.containsKey(key)) {\n"
  589. " throw new java.lang.IllegalArgumentException();\n"
  590. " }\n"
  591. " return map.get(key);\n"
  592. "}\n");
  593. printer->Annotate("{", "}", descriptor_);
  594. }
  595. } else {
  596. printer->Print(
  597. variables_,
  598. "/**\n"
  599. " * Use {@link #get$capitalized_name$Map()} instead.\n"
  600. " */\n"
  601. "@java.lang.Deprecated\n"
  602. "public java.util.Map<$type_parameters$> "
  603. "${$get$capitalized_name$$}$() {\n"
  604. " return get$capitalized_name$Map();\n"
  605. "}\n");
  606. printer->Annotate("{", "}", descriptor_);
  607. WriteFieldDocComment(printer, descriptor_);
  608. printer->Print(
  609. variables_,
  610. "$deprecation$\n"
  611. "public java.util.Map<$type_parameters$> "
  612. "${$get$capitalized_name$Map$}$() {\n"
  613. " return internalGet$capitalized_name$().getMap();\n"
  614. "}\n");
  615. printer->Annotate("{", "}", descriptor_);
  616. WriteFieldDocComment(printer, descriptor_);
  617. printer->Print(
  618. variables_,
  619. "$deprecation$\n"
  620. "public $value_type$ ${$get$capitalized_name$OrDefault$}$(\n"
  621. " $key_type$ key,\n"
  622. " $value_type$ defaultValue) {\n"
  623. " $key_null_check$\n"
  624. " java.util.Map<$type_parameters$> map =\n"
  625. " internalGet$capitalized_name$().getMap();\n"
  626. " return map.containsKey(key) ? map.get(key) : defaultValue;\n"
  627. "}\n");
  628. printer->Annotate("{", "}", descriptor_);
  629. WriteFieldDocComment(printer, descriptor_);
  630. printer->Print(
  631. variables_,
  632. "$deprecation$\n"
  633. "public $value_type$ ${$get$capitalized_name$OrThrow$}$(\n"
  634. " $key_type$ key) {\n"
  635. " $key_null_check$\n"
  636. " java.util.Map<$type_parameters$> map =\n"
  637. " internalGet$capitalized_name$().getMap();\n"
  638. " if (!map.containsKey(key)) {\n"
  639. " throw new java.lang.IllegalArgumentException();\n"
  640. " }\n"
  641. " return map.get(key);\n"
  642. "}\n");
  643. printer->Annotate("{", "}", descriptor_);
  644. }
  645. }
  646. void ImmutableMapFieldGenerator::
  647. GenerateFieldBuilderInitializationCode(io::Printer* printer) const {
  648. // Nothing to initialize.
  649. }
  650. void ImmutableMapFieldGenerator::
  651. GenerateInitializationCode(io::Printer* printer) const {
  652. // Nothing to initialize.
  653. }
  654. void ImmutableMapFieldGenerator::
  655. GenerateBuilderClearCode(io::Printer* printer) const {
  656. printer->Print(
  657. variables_,
  658. "internalGetMutable$capitalized_name$().clear();\n");
  659. }
  660. void ImmutableMapFieldGenerator::
  661. GenerateMergingCode(io::Printer* printer) const {
  662. printer->Print(
  663. variables_,
  664. "internalGetMutable$capitalized_name$().mergeFrom(\n"
  665. " other.internalGet$capitalized_name$());\n");
  666. }
  667. void ImmutableMapFieldGenerator::
  668. GenerateBuildingCode(io::Printer* printer) const {
  669. printer->Print(
  670. variables_,
  671. "result.$name$_ = internalGet$capitalized_name$();\n"
  672. "result.$name$_.makeImmutable();\n");
  673. }
  674. void ImmutableMapFieldGenerator::
  675. GenerateParsingCode(io::Printer* printer) const {
  676. printer->Print(
  677. variables_,
  678. "if (!$get_mutable_bit_parser$) {\n"
  679. " $name$_ = com.google.protobuf.MapField.newMapField(\n"
  680. " $map_field_parameter$);\n"
  681. " $set_mutable_bit_parser$;\n"
  682. "}\n");
  683. if (!SupportUnknownEnumValue(descriptor_->file()) &&
  684. GetJavaType(ValueField(descriptor_)) == JAVATYPE_ENUM) {
  685. printer->Print(
  686. variables_,
  687. "com.google.protobuf.ByteString bytes = input.readBytes();\n"
  688. "com.google.protobuf.MapEntry<$type_parameters$>\n"
  689. "$name$__ = $default_entry$.getParserForType().parseFrom(bytes);\n");
  690. printer->Print(
  691. variables_,
  692. "if ($value_enum_type$.forNumber($name$__.getValue()) == null) {\n"
  693. " unknownFields.mergeLengthDelimitedField($number$, bytes);\n"
  694. "} else {\n"
  695. " $name$_.getMutableMap().put(\n"
  696. " $name$__.getKey(), $name$__.getValue());\n"
  697. "}\n");
  698. } else {
  699. printer->Print(
  700. variables_,
  701. "com.google.protobuf.MapEntry<$type_parameters$>\n"
  702. "$name$__ = input.readMessage(\n"
  703. " $default_entry$.getParserForType(), extensionRegistry);\n"
  704. "$name$_.getMutableMap().put(\n"
  705. " $name$__.getKey(), $name$__.getValue());\n");
  706. }
  707. }
  708. void ImmutableMapFieldGenerator::
  709. GenerateParsingDoneCode(io::Printer* printer) const {
  710. // Nothing to do here.
  711. }
  712. void ImmutableMapFieldGenerator::
  713. GenerateSerializationCode(io::Printer* printer) const {
  714. printer->Print(
  715. variables_,
  716. "com.google.protobuf.GeneratedMessage$ver$\n"
  717. " .serialize$short_key_type$MapTo(\n"
  718. " output,\n"
  719. " internalGet$capitalized_name$(),\n"
  720. " $default_entry$,\n"
  721. " $number$);\n");
  722. }
  723. void ImmutableMapFieldGenerator::
  724. GenerateSerializedSizeCode(io::Printer* printer) const {
  725. printer->Print(
  726. variables_,
  727. "for (java.util.Map.Entry<$type_parameters$> entry\n"
  728. " : internalGet$capitalized_name$().getMap().entrySet()) {\n"
  729. " com.google.protobuf.MapEntry<$type_parameters$>\n"
  730. " $name$__ = $default_entry$.newBuilderForType()\n"
  731. " .setKey(entry.getKey())\n"
  732. " .setValue(entry.getValue())\n"
  733. " .build();\n"
  734. " size += com.google.protobuf.CodedOutputStream\n"
  735. " .computeMessageSize($number$, $name$__);\n"
  736. "}\n");
  737. }
  738. void ImmutableMapFieldGenerator::
  739. GenerateEqualsCode(io::Printer* printer) const {
  740. printer->Print(
  741. variables_,
  742. "result = result && internalGet$capitalized_name$().equals(\n"
  743. " other.internalGet$capitalized_name$());\n");
  744. }
  745. void ImmutableMapFieldGenerator::
  746. GenerateHashCode(io::Printer* printer) const {
  747. printer->Print(
  748. variables_,
  749. "if (!internalGet$capitalized_name$().getMap().isEmpty()) {\n"
  750. " hash = (37 * hash) + $constant_name$;\n"
  751. " hash = (53 * hash) + internalGet$capitalized_name$().hashCode();\n"
  752. "}\n");
  753. }
  754. string ImmutableMapFieldGenerator::GetBoxedType() const {
  755. return name_resolver_->GetImmutableClassName(descriptor_->message_type());
  756. }
  757. } // namespace java
  758. } // namespace compiler
  759. } // namespace protobuf
  760. } // namespace google