Protobuf4j: A Facility Framework to Develop with Google Protobuf

A Facility Framework to Develop with Google Protobuf

License	The Apache License, Version 2.0
Categories	Protobuf Data Data Structures ORM
GroupId	xyz.codemeans.protobuf4j
ArtifactId	protobuf4j-orm-starter
Last Version	1.0.1
Release Date	Aug 17, 2020
Type	jar
Description	Protobuf4j: A Facility Framework to Develop with Google Protobuf A Facility Framework to Develop with Google Protobuf
Project URL	https://github.com/YuanWenqing/protobuf4j
Source Code Management	https://github.com/YuanWenqing/protobuf4j

Download protobuf4j-orm-starter

Filename	Size
protobuf4j-orm-starter-1.0.1.pom
protobuf4j-orm-starter-1.0.1.jar	3 KB
protobuf4j-orm-starter-1.0.1-sources.jar	2 KB
protobuf4j-orm-starter-1.0.1-javadoc.jar	22 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/xyz.codemeans.protobuf4j/protobuf4j-orm-starter/ -->
<dependency>
    <groupId>xyz.codemeans.protobuf4j</groupId>
    <artifactId>protobuf4j-orm-starter</artifactId>
    <version>1.0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/xyz.codemeans.protobuf4j/protobuf4j-orm-starter/
implementation 'xyz.codemeans.protobuf4j:protobuf4j-orm-starter:1.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/xyz.codemeans.protobuf4j/protobuf4j-orm-starter/
implementation ("xyz.codemeans.protobuf4j:protobuf4j-orm-starter:1.0.1")

Apache Buildr

'xyz.codemeans.protobuf4j:protobuf4j-orm-starter:jar:1.0.1'

Apache Ivy

<dependency org="xyz.codemeans.protobuf4j" name="protobuf4j-orm-starter" rev="1.0.1">
  <artifact name="protobuf4j-orm-starter" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='xyz.codemeans.protobuf4j', module='protobuf4j-orm-starter', version='1.0.1')
)

Scala SBT

libraryDependencies += "xyz.codemeans.protobuf4j" % "protobuf4j-orm-starter" % "1.0.1"

Leiningen

[xyz.codemeans.protobuf4j/protobuf4j-orm-starter "1.0.1"]

Dependencies

compile (2)

Group / Artifact	Type	Version
xyz.codemeans.protobuf4j : protobuf4j-orm	jar	1.0.1
org.springframework.boot : spring-boot-autoconfigure	jar	2.0.3.RELEASE

Project Modules

There are no modules declared in this project.

Protobuf4j

Introduction

A Facility framework to develop with Google Protobuf, including:

• Utils to handle Protobuf messages and enums
• ORM-based DAO for storing Protobuf Message in MySQL
• Some supports with Spring and SpringBoot

Modules

• protobuf4j-core: helper class for Protobuf Message and Enum, codec class for Message.
• protobuf4j-sql: abstraction for SQL fragment and statement.
• protobuf4j-orm: basic ORM-like DAO framework utilizing protobuf4j-sql
• protobuf4j-orm-starter: springboot starter for protobuf4j-orm, including autoconfiguration and jdbc injection
• protobuf4j-spring: some extensions for Protobuf to integrate with spring

ORM Usage

Gradle

implementation("xyz.codemeans.protobuf4j:protobuf4j-orm-starter:$protobuf4jVersion")

The latest version can be found in maven central repository.

Properties

protobuf4j.datasource.auto-enable=<if-auto-configuration-enalbed:default true>

Java

Example Code: example

interface

public interface ExampleDao extends IPrimaryKeyMessageDao<Long, Example> {
}

impl

@Repository
public class ExampleDaoImpl extends PrimaryKeyProtoMessageDao<Long, Example> implements ExampleDao {
  public ExampleDaoImpl() {
    super(Example.class, ExampleNaming.ID);
  }
}

CRUD

@Autowired
ExampleDao exampleDao;

public Example createExample(Example example) {
  long id = exampleDao.insertReturnKey(example).longValue();
  return exampleDao.selectOneByPrimaryKey(id);
}

public Example getExample(long id) {
  return exampleDao.selectOneByPrimaryKey(id);
  // or
  //return exampleDao.selectOneByCond(FieldAndValue.eq(ExampleNaming.ID, id));
}

public Example updateExample(Example newValue, Example oldValue) {
  exampleDao.updateMessageByPrimaryKey(newValue, oldValue);
  return exampleDao.selectOneByPrimaryKey(newValue.getId());
}

public void deleteExample(long id) {
  exampleDao.deleteByPrimaryKey(id);
}

// complex conditions and pagination
public List<Example> listExamples(WhereClause where) {
  return exampleDao.selectByWhere(where);
}

public Map<Long, Example> getExamples(Collection<Long> ids) {
  return exampleDao.selectMultiByPrimaryKey(ids);
}

SQL Usage

// condition
List<IExpression> conds = Lists.newArrayList();
conds.add(FieldAndValue.like(ExampleNaming.NAME, SqlUtil.likePrefix(prefix)));
conds.add(FieldAndValue.gte(ExampleNaming.ID, beg));
conds.add(FieldAndValue.lt(ExampleNaming.ID, end));
IExpression allAndCond = LogicalExpr.and(conds));

// pagination
PaginationClause.newBuilder(limit).buildByOffset(offset);
PaginationClause.newBuilder(limit).buildByPageNo(pn)

// select specified columns
SelectClause selectClause = new SelectClause();
selectClause.select(ExampleNaming.NAME);
FromClause fromClause = QueryCreator.fromType(Example.class);
SelectSql sql = new SelectSql(selectClause, fromClause);
exampleDao.doSelect(sql, new SingleColumnRowMapper<>(String.class));

// update whole message with different fields
exampleDao.updateMessageByPrimaryKey(newValue, oldValue);

Reference

• naming: a Protobuf codegen plugin to generate *Naming class containing field naming constatns, see https://github.com/YuanWenqing/protoplugin

Versions

Version
1.0.1 Aug 17, 2020
1.0.0 May 8, 2019
0.9.3.alpha Feb 27, 2019