protobufgen

A Java Library to Generate/Serialize Protocol Buffer Files (*.proto files)

License	Apache License 2.0
Categories	Protobuf Data Data Structures
GroupId	io.github.stefan-ka
ArtifactId	protobufgen
Last Version	1.2.0
Release Date	Aug 14, 2020
Type	pom
Description	protobufgen A Java Library to Generate/Serialize Protocol Buffer Files (*.proto files)
Project URL	https://github.com/stefan-ka/protobufgen
Project Organization	Stefan Kapferer
Source Code Management	https://github.com/stefan-ka/protobufgen

Download protobufgen

Filename	Size
protobufgen-1.2.0.pom
protobufgen-1.2.0-sources.jar	27 KB
protobufgen-1.2.0-javadoc.jar	498 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.stefan-ka/protobufgen/ -->
<dependency>
    <groupId>io.github.stefan-ka</groupId>
    <artifactId>protobufgen</artifactId>
    <version>1.2.0</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.stefan-ka/protobufgen/
implementation 'io.github.stefan-ka:protobufgen:1.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.stefan-ka/protobufgen/
implementation ("io.github.stefan-ka:protobufgen:1.2.0")

Apache Buildr

'io.github.stefan-ka:protobufgen:pom:1.2.0'

Apache Ivy

<dependency org="io.github.stefan-ka" name="protobufgen" rev="1.2.0">
  <artifact name="protobufgen" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.stefan-ka', module='protobufgen', version='1.2.0')
)

Scala SBT

libraryDependencies += "io.github.stefan-ka" % "protobufgen" % "1.2.0"

Leiningen

[io.github.stefan-ka/protobufgen "1.2.0"]

Dependencies

runtime (1)

Group / Artifact	Type	Version
org.freemarker : freemarker	jar	2.3.30

Project Modules

There are no modules declared in this project.

A Java Library to Serialize Protocol Buffer Files

This is a simple Java library containing a protocol buffer model and serializer. It can be used in case you want to generate *.proto files within a Java application. We currently support proto3 only.

Usage

Note: The examples below just give you a glimpse how the API works. Of course, our intention is not writing protocol buffer files (*.proto) manually in Java, as show below. If that is your goal, just write *.proto files directly :) We use this library in generators to transform other code/models into protocol buffer specifications.

You find all model classes to represent a proto specification in Java within the io.github.microserviceapipatterns.protobufgen.model package. ProtoSpec is the root element and with persistProto(File protoFile) you can simply serialize the *.proto file. An example:

ProtoSpec proto = new ProtoSpec.Builder()
        .withMessage(new Message.Builder("SearchRequest")
                .withField(STRING, "query")
                .withField(INT32, "page_number")
                .withField(INT32, "result_per_page"))
        .withEnum(new Enum.Builder("PhoneType")
                .withField("MOBILE")
                .withField("HOME")
                .withField("WORK"))
        .build();
proto.persistProto(new File("demo.proto"));

Note: You can also use the toString() method on ProtoSpec and get the serialized model as a String.

The example above generates the following simple *.proto file:

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

enum PhoneType {
  MOBILE = 0;
  HOME = 1;
  WORK = 2;
}

Services are supported as well:

Message request = new Message.Builder("RequestMessage").build();
Message response = new Message.Builder("ResponseMessage").build();

ProtoSpec proto = new ProtoSpec.Builder()
        .withMessage(request)
        .withMessage(response)
        .withService(new Service.Builder("SampleService")
                .withRPC(new RemoteProcedureCall.Builder("sampleRPC", request, response)))
        .build();
proto.persistProto(new File("demo.proto"));

syntax = "proto3";

message RequestMessage {
}

message ResponseMessage {
}

service SampleService {
  rpc sampleRPC(RequestMessage) returns (ResponseMessage);
}

Please consult the JavaDoc for further documentation regarding the API and how to use it.

Publication

The library is published to Maven central. Thus, you can easily use it in your project with Gradle or Maven:

Gradle:

implementation 'io.github.microservice-api-patterns:protobufgen:1.2.0'

Maven:

<dependency>
  <groupId>io.github.microservice-api-patterns</groupId>
  <artifactId>protobufgen</artifactId>
  <version>1.2.0</version>
</dependency>

Contributing

Contribution is always welcome! Create an issue if you just want to report a bug or missing feature. In case you want to implement a change/bugfix by yourself, follow these steps:

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request (PR)

Licence

Copyright: Stefan Kapferer, 2020. All rights reserved. See license information.

Versions

Version
1.2.0 Aug 14, 2020
1.1.0 Aug 13, 2020
1.0.0 Aug 12, 2020