Akka Grpc
| Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
|---|---|---|---|---|---|---|---|---|---|---|
| Protoactor Go | 4,552 | 6 days ago | 4 | April 05, 2021 | 70 | apache-2.0 | Go | |||
| Proto Actor - Ultra fast distributed actors for Go, C# and Java/Kotlin | ||||||||||
| Cloudstate | 763 | 2 | a year ago | 11 | January 27, 2021 | 95 | apache-2.0 | Scala | ||
| Distributed State Management for Serverless | ||||||||||
| Akka Grpc | 424 | 4 | 17 | 6 days ago | 40 | September 26, 2022 | 162 | other | Scala | |
| Akka gRPC | ||||||||||
| Grpcakkastream | 66 | 4 years ago | 7 | mit | Scala | |||||
| Use GRPC services with the Akka-stream API | ||||||||||
| Java 11 Examples | 46 | 2 years ago | 4 | apache-2.0 | Java | |||||
| JDK 11 examples and demo projects. | ||||||||||
| Chief Of State | 43 | 3 months ago | 21 | mit | Scala | |||||
| gRPC clustered event sourcing tool | ||||||||||
| Play Grpc | 33 | 4 | a month ago | 4 | September 25, 2020 | 26 | apache-2.0 | Scala | ||
| Play + Akka gRPC | ||||||||||
| Etcd4s | 32 | 11 days ago | 6 | January 11, 2021 | 13 | mit | Scala | |||
| Scala etcd client implementing V3 APIs | ||||||||||
| Akka_streams_tutorial | 27 | 6 days ago | 12 | mit | Scala | |||||
| A collection of runnable and self-contained examples from various akka-streams and Alpakka docs, tutorials and blogs | ||||||||||
| Akka Grpc Sample Kubernetes Scala | 25 | a year ago | 15 | Scala | ||||||
akka-grpc
Support for building streaming gRPC servers and clients on top of Akka Streams.
This library is meant to be used as a building block in projects using the Akka toolkit.
Documentation
- Akka gRPC reference documentation
Project Status
This library is ready to be used in production, but API's and build system plugins are still expected to be improved and may change.
The API on both sides (Client and Server) is a simple Akka Streams-based one.
The client side is currently implemented on top of io.grpc:grpc-netty-shaded, we plan to replace this by just io.grpc:grpc-core and Akka HTTP.
As for performance, we are currently relying on the JVM TLS implementation, which is sufficient for many use cases, but is planned to be replaced with conscrypt or netty-tcnative.
General overview
gRPC is a schema-first RPC framework, where your protocol is declared in a protobuf definition, and requests and responses will be streamed over an HTTP/2 connection.
Based on a protobuf service definition, akka-grpc can generate:
- Model classes (using plain protoc for Java or scalapb for Scala)
- The API (as an interface for Java or a trait for Scala), expressed in Akka Streams
Sources - On the server side, code to create an Akka HTTP route based on your implementation of the API
- On the client side, a client for the API.
Project structure
The project is split up in a number of subprojects:
- codegen: code generation shared among plugins
- runtime: run-time utilities used by the generated code
- sbt-plugin: the sbt plugin
- scalapb-protoc-plugin: the scalapb Scala model code generation packaged as a protoc plugin, to be used from gradle
- interop-tests
Additionally, 'plugin-tester-java' and 'plugin-tester-scala' contain an example project in Java and Scala respectively, with both sbt and Gradle configurations.
Compatibility & support
If used with JDK 8 prior to version 1.8.0_251 you must add an ALPN agent.
Support for Akka gRPC is available via the Lightbend Subscription
License
Akka gRPC is licensed under the Business Source License 1.1, see LICENSE.
