akka/akka-core

Write a guide of how to use protobuf in a project

Open

#15,987 opened on Sep 29, 2014

View on GitHub
 (7 comments) (0 reactions) (0 assignees)Scala (3,547 forks)batch import
1 - triagedhelp wantedt:docs

Repository metrics

Stars
 (13,277 stars)
PR merge metrics
 (Avg merge 8d 19h) (10 merged PRs in 30d)

Description

How to write a non-trivial akka message serializer for protobuf.

Here is an example of a non-trivial protobuf serializer:

https://github.com/akka/akka/blob/master/akka-contrib/src/main/protobuf/DistributedPubSubMessages.proto

https://github.com/akka/akka/blob/master/akka-contrib/src/main/scala/akka/contrib/pattern/protobuf/DistributedPubSubMessageSerializer.scala

https://github.com/akka/akka/blob/master/akka-contrib/src/test/scala/akka/contrib/pattern/protobuf/DistributedPubSubMessageSerializerSpec.scala

https://github.com/akka/akka/blob/master/akka-contrib/src/main/resources/reference.conf#L35-L43

The generated protobuf classes: https://github.com/akka/akka/blob/master/akka-contrib/src/main/java/akka/contrib/pattern/protobuf/msg/DistributedPubSubMessages.java

Also, the sbt plugin should be mentioned: https://github.com/patriknw/akka-data-replication/blob/master/build.sbt

Contributor guide

Research direction
Study the provided example links on GitHub to understand how to create a protobuf serializer for Akka messages, then write a guide covering the setup, generation of Java classes, and configuration.
Tech stack
scala
Domain
backend
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Scalasbt
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50