Question

我正在尝试减少Google proto-buf生成的方法数量，其中一种方法是使用proto-buf nano。但是我没有找到关于如何使用它的文档。除了package link，我找不到任何关于如何使用nano从proto文件生成java文件的内容。

所以问题很简单：如何使用google proto nano从原型文件生成java类以及如何在项目中使用它们？

Answer 1

查看主要的protobuf编译器源代码：

#include <google/protobuf/compiler/javanano/javanano_generator.h>
.... 

int main(int argc, char* argv[]) {

    google::protobuf::compiler::CommandLineInterface cli;
    cli.AllowPlugins("protoc-");
    ...
    // Proto2 JavaNano
    google::protobuf::compiler::javanano::JavaNanoGenerator javanano_generator;
    cli.RegisterGenerator("--javanano_out", &javanano_generator,
    "Generate Java source file nano runtime.");

    return cli.Run(argc, argv);
}

查看protobuf's Readme

Nano Generator选项


java_package -> <file-name>|<package-name>

java_outer_classname -> <file-name>|<package-name>

java_multiple_files -> true or false

java_nano_generate_has -> true or false [DEPRECATED]

optional_field_style -> default or accessors

enum_style -> c or java

在Android repo之外使用nano protobufs：

与生成的jar文件<protobuf-root>java/target/protobuf-java-2.3.0-nano.jar.
相关联
使用--javanano_out调用，例如：


./protoc '--javanano_out=java_package=src/proto/simple-data.proto|my_package,java_outer_classname=src/proto/simple-data.proto|OuterName:.' src/proto/simple-data.proto

在Android repo中使用nano protobufs：

在您当地的.mk文件中设置“LOCAL_PROTOC_OPTIMIZE_TYPE := nano”。在构建Java库或app（包）目标时，构建
  系统会将Java nano运行时库添加到
  LOCAL_STATIC_JAVA_LIBRARIES变量，因此您不需要。

在本地.mk文件中设置“LOCAL_PROTO_JAVA_OUTPUT_PARAMS := ...”以获取所需的任何命令行选项。使用逗号加入多个
  选项。仅在纳米味中，选项周围的空白   名称和值将被忽略，因此您可以使用反斜杠换行符或
  '+ ='很好地构建你的make文件。

当您构建Java库或包时，这些选项将应用于LOCAL_SRC_FILES中的所有原型文件。如果有不同的选择
  不同的原型文件需要，构建单独的Java库   并在你的主要目标中引用它们。注意：你应该确保
  对于每个单独的目标，从任何
进口的所有原型文件   LOCAL_SRC_FILES中的原始文件包含在LOCAL_SRC_FILES中。这
  是因为生成器必须假定导入的文件是
  使用相同的选项构建，并将生成引用的代码   导入文件中的字段和枚举使用相同的代码
  风格。

提示：“include $(CLEAR_VARS)”重置所有LOCAL_个变量，包括上述两个变量。

来自https://android.googlesource.com/platform/external/protobuf/+/master/src/google/protobuf/的简单纳米示例。

<强> unittest_simple_nano.proto

package protobuf_unittest_import;

option java_package = "com.google.protobuf.nano";
// Explicit outer classname to suppress legacy info.
option java_outer_classname = "UnittestSimpleNano";

message SimpleMessageNano {
  message NestedMessage {
    optional int32 bb = 1;
  }

  enum NestedEnum {
    FOO = 1;
    BAR = 2;
    BAZ = 3;
  }

  optional int32 d = 1 [default = 123];
  optional NestedMessage nested_msg = 2;
  optional NestedEnum default_nested_enum = 3 [default = BAZ];
}

命令行

./protoc '--javanano_out=java_package=google/protobuf/unittest_simple_nano.proto|com.google.protobuf.nano,java_outer_classname=google/protobuf/unittest_simple_nano.proto|UnittestSimpleNano:target/generated-test-sources' google/protobuf/unittest_simple_nano.proto

从NanoTest.java

中提取的测试

  public void testSimpleMessageNano() throws Exception {
    SimpleMessageNano msg = new SimpleMessageNano();
    assertEquals(123, msg.d);
    assertEquals(null, msg.nestedMsg);
    assertEquals(SimpleMessageNano.BAZ, msg.defaultNestedEnum);

    msg.d = 456;
    assertEquals(456, msg.d);

    SimpleMessageNano.NestedMessage nestedMsg = new SimpleMessageNano.NestedMessage();
    nestedMsg.bb = 2;
    assertEquals(2, nestedMsg.bb);
    msg.nestedMsg = nestedMsg;
    assertEquals(2, msg.nestedMsg.bb);

    msg.defaultNestedEnum = SimpleMessageNano.BAR;
    assertEquals(SimpleMessageNano.BAR, msg.defaultNestedEnum);

    byte [] result = MessageNano.toByteArray(msg);
    int msgSerializedSize = msg.getSerializedSize();
    //System.out.printf("mss=%d result.length=%d\n", msgSerializedSize, result.length);
    assertTrue(msgSerializedSize == 9);
    assertEquals(result.length, msgSerializedSize);

    SimpleMessageNano newMsg = SimpleMessageNano.parseFrom(result);
    assertEquals(456, newMsg.d);
    assertEquals(2, msg.nestedMsg.bb);
    assertEquals(SimpleMessageNano.BAR, msg.defaultNestedEnum);
  }

同一个类中有很多测试用例，在查看项目pom时，您可以找到maven-antrun-plugin配置来生成测试资源类

<!-- java nano -->
<exec executable="../src/protoc">
  <arg value="--javanano_out=java_package=google/protobuf/unittest_import_nano.proto|com.google.protobuf.nano,java_outer_classname=google/protobuf/unittest_import_nano.proto|UnittestImportNano:target/generated-test-sources" />
  <arg value="--proto_path=../src" />
  <arg value="--proto_path=src/test/java" />
  <arg value="../src/google/protobuf/unittest_nano.proto" />
  <arg value="../src/google/protobuf/unittest_simple_nano.proto" />
  <arg value="../src/google/protobuf/unittest_stringutf8_nano.proto" />
  <arg value="../src/google/protobuf/unittest_recursive_nano.proto" />
  <arg value="../src/google/protobuf/unittest_import_nano.proto" />
  <arg value="../src/google/protobuf/unittest_enum_multiplejava_nano.proto" />
  <arg value="../src/google/protobuf/unittest_multiple_nano.proto" />
</exec>

希望这有帮助。

Android protobuf nano文档

1 个答案: