akka-grpc - 应用案例

2024-04-09 04:32
文章标签 应用 案例 grpc akka

本文主要是介绍akka-grpc - 应用案例,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

  上期说道:http/2还属于一种不算普及的技术协议,可能目前只适合用于内部系统集成,现在开始大面积介入可能为时尚早。不过有些项目需求不等人,需要使用这项技术,所以研究了一下akka-grpc,写了一篇介绍。本想到此为止,继续其它项目。想想这样做法有点不负责任,像是草草收场。毕竟用akka-grpc做了些事情,想想还是再写这篇跟大家分享使用kka-grpc的过程。

我说过,了解akka-grpc的主要目的还是在protobuf的应用上。这是一种高效率的序列化协议。刚好,公司有这么个项目,是一个图像处理平台:把很多图片拍摄终端的图像传上平台进行商品识别、OCR等图像处理。由于终端数量多、图像处理又特别消耗内存、CPU等计算资源、又要求快速响应,所以第一考虑就是使用akka-cluster把图像处理任务分割到多个节点上并行处理。这里就需要仔细考虑图片在终端到平台、然后集群节点与点actor间的传输效率了。如何在akka系统里使用protobuf格式的数据正是本篇讨论和示范的目的。

akka-grpc应用一般从IDL文件里消息类型和服务函数的定义开始,如下面这个.proto文件示范:

syntax = "proto3";import "google/protobuf/wrappers.proto";
import "google/protobuf/any.proto";
import "scalapb/scalapb.proto";option (scalapb.options) = {// don't append file name to packageflat_package: true// generate one Scala file for all messages (services still get their own file)single_file: true// add imports to generated file// useful when extending traits or using custom types// import: "io.ontherocks.hellogrpc.RockingMessage"// code to put at the top of generated file// works only with `single_file: true`//preamble: "sealed trait SomeSealedTrait"
};package com.datatech.pos.abs;message UCredential {string userid = 1;string password = 2;
}message JWToken {string jwt = 1;
}message Picture {int32 num = 1;bytes blob = 2;
}
message Capture {string ean = 1;bytes cover1 = 2;bytes cover2 = 3;
}message Book {string ean = 1;string ver = 2;string isbn = 3;string title = 4;string publisher = 5;double price = 6;bytes cover1 = 7;bytes cover2 = 8;
}message QueryResult {int32  sts         = 1;string msg         = 2;Book bookinfo   = 3;
}service Services {rpc GetAuthToken(UCredential) returns (JWToken) {};rpc SavePicture(Picture) returns (QueryResult) {};rpc GetPicture(Picture) returns (Picture) {};
//  rpc SaveCapture(Capture) returns (QueryResult) {};
//  rpc GetCapture(Capture) returns (Capture) {};
//  rpc GetBookInfo(Capture) returns (QueryResult) {};
}

因为这次示范针对的是protobuf的使用,所以就拣了SavePicture,GetPicture这两项服务函数。JWToken只是用户身份凭证,集群分片shard-entityId是以用户凭证为基础的,所以平台需要通过JWT进行跨节点任务指派以实现分布式图像处理运算。

下面就要在编译器插件自动产生的基础服务接口代码基础上进行具体的服务功能实现。这部分主要是对接口函数的实现(oveerride):

class gRPCServices(trace: Boolean, system: ActorSystem, sharding: ClusterSharding)(implicit  waitResponseTimeout: Timeout, authenticator: AuthBase) extends ServicesPowerApi with LogSupport {implicit val ec = system.dispatcherlog.stepOn = traceoverride def getAuthToken(request: UCredential, meta: Metadata): Future[JWToken] = {val entityRef = sharding.entityRefFor(Authenticator.EntityKey, UUID.randomUUID.toString)val jwtResp = for {ui <- entityRef.ask[Authenticator.Response](Authenticator.GetUserInfo(request.userid, _)).map {case Authenticator.UserInfo(info) => infocase _ => Map[String, Any]()}jwt <- entityRef.ask[Authenticator.Response](Authenticator.GetToken(ui, _))} yield jwtjwtResp.map {case Authenticator.JWToken(jwt) =>if (jwt.nonEmpty) JWToken(jwt)else throw new Exception("身份验证失败!无法提供凭证。")case _ => throw new Exception("身份验证失败!无法提供凭证。")}}override def savePicture(in: Picture, metadata: Metadata): Future[QueryResult] = {val jwt = getJwt(metadata).getOrElse("")val ids = authenticator.shopIdFromJwt(jwt).getOrElse(("","","","",""))val (shopId, posId, termId, impurl,devId) = idsval entityRef = sharding.entityRefFor(ImgProcessor.EntityKey, s"$shopId:$posId")val futResp = entityRef.ask[ImgProcessor.Response](ImgProcessor.SaveImage(in, _)).map {case ImgProcessor.ValidImgPro(img) => QueryResult(sts = 0, msg = "picture saved.")case ImgProcessor.FailedImgPro(msg) => QueryResult(sts = -1, msg = msg)}futResp}override def getPicture(in: Picture, metadata: Metadata): Future[Picture] = {val jwt = getJwt(metadata).getOrElse("")val ids = authenticator.shopIdFromJwt(jwt).getOrElse(("","","","",""))val (shopId, posId, termId, impurl,devId) = idsval entityRef = sharding.entityRefFor(ImgProcessor.EntityKey, s"$shopId:$posId")val futResp = entityRef.ask[ImgProcessor.Response](ImgProcessor.GetImage(in.num, _)).map {case ImgProcessor.ValidImgPro(img) => imgcase ImgProcessor.FailedImgPro(msg) => Picture(-1, ByteString.EMPTY)}futResp}def getJwt(metadata: Metadata): Option[String] = {metadata.getText("bearer")}
}

由于是通过PowerApi模式产生的接口代码,所以接口函数都带有MetaData参数,代表HttpRequest header集合。可以看到:服务函数实现都是通过entityRef,一个分片调度器分配到集群某个节点ImgProcessor.EntityKey类型的entity-actor上进行的。shopId:posId就是代表为某用户构建的entityId,这个是通过用户在Request中提供的MetaData参数中jwt解析得出的。

可以看到,具体服务提供是通过集群的分片实现的。下面是这个分片的代码示范:

      log.step(s"initializing sharding for ${ImgProcessor.EntityKey} ...")(MachineId("",""))val imgEntityType = Entity(ImgProcessor.EntityKey) { entityContext =>ImgProcessor(entityContext.shard,mgoHosts,entityContext.entityId,trace,keepAlive)}.withStopMessage(ImgProcessor.StopWorker)sharding.init(imgEntityType)

上面imgEntityType就是shard-entity类型,其实就是按用户提供的jwt在任意集群节点上实时构建的一个opencv图像处理器。下面是这个entity-actor的示范代码:

object ImgProcessor extends LogSupport {sealed trait Command extends CborSerializablecase class SaveImage(img: Picture, replyTo: ActorRef[Response]) extends Commandcase class GetImage(imgnum: Int,replyTo: ActorRef[Response]) extends Commandsealed trait Response extends CborSerializablecase class ValidImgPro(img: Picture) extends Responsecase class FailedImgPro(msg: String) extends Responsedef apply(shard: ActorRef[ClusterSharding.ShardCommand],mgoHosts: List[String], entityId: String, trace: Boolean, keepAlive: FiniteDuration): Behavior[Command] = {val (shopId,posId) = entityId.split(':').toList match {case sid::pid::Nil  => (sid,pid) }implicit val loc = Messages.MachineId(shopId,posId)log.stepOn = traceBehaviors.setup[Command] { ctx =>implicit val ec = ctx.executionContextctx.setReceiveTimeout(keepAlive, Idle)Behaviors.withTimers[Command] { timer =>Behaviors.receiveMessage[Command] {case SaveImage(img, replyTo) =>log.step(s"ImgProcessor: SaveImage(${img.num})")implicit val client = mongoClient(mgoHosts)maybeMgoClient = Some(client)ctx.pipeToSelf(savePicture(img)) {case Success(_) => {replyTo ! ValidImgPro(img)Done(loc.shopid, loc.posid, s"saved image #${img.num}.")}case Failure(err) =>log.error(s"ImgProcessor: SaveImage Error: ${err.getMessage}")replyTo ! FailedImgPro(err.getMessage)Done(loc.shopid, loc.posid, s"SaveImage with error: ${err.getMessage}")}Behaviors.samecase GetImage(imgnum, replyTo) =>
...}}

整个图片传输是通过actor的消息实现的。akka消息支持多种序列化格式,包括protobuf, 在配置文件.conf里定义:

akka {loglevel = INFOactor {provider = clusterserializers {jackson-cbor = "akka.serialization.jackson.JacksonCborSerializer"proto = "akka.remote.serialization.ProtobufSerializer"}serialization-bindings {"com.datatech.pos.abs.CborSerializable" = jackson-cbor"scalapb.GeneratedMessage" = proto}}
}

grpc server 基本上是个标准模块,不同的只是service参数:

class gRPCServer(host: String, port: Int) extends LogSupport {def runServer(system: ActorSystem[_], service: gRPCServices): Future[Http.ServerBinding] = {implicit val classic = system.toClassicimplicit val ec: ExecutionContext = system.executionContext// Create service handlersval serviceHandler: HttpRequest => Future[HttpResponse] =ServicesPowerApiHandler(service)// Bind service handler servers to localhost:8080/8081val binding = Http().bindAndHandleAsync(serviceHandler,interface = host,port = port,connectionContext = HttpConnectionContext())// report successful bindingbinding.foreach { binding => println(s"******* startup gRPC-server on: port = $port  *******") }binding//#server}
}

下面是客户端测试代码:

object gRPCTestClient {def main(args: Array[String]): Unit = {val config_onenode = ConfigFactory.load("onenode")implicit val sys = ActorSystem("grpc-client", config_onenode)implicit val ec = sys.dispatcherval clientSettings = GrpcClientSettings.fromConfig(Services.name)//   val clientSettings = GrpcClientSettings.connectToServiceAt("192.168.11.189", 50052);implicit val client = ServicesClient(clientSettings)val futJwt = client.getAuthToken(UCredential("9013", "123456"))val jwt = Await.result(futJwt, 5.seconds).jwtprintln(s"got jwt: ${jwt}")scala.io.StdIn.readLine()val bytes = FileStreaming.FileToByteArray("books/59c10d099b26e.jpg")val mat = bytesToMat(bytes)show(mat,"sent picture")scala.io.StdIn.readLine()val picture = Picture(111,marshal(bytes))val futQR = client.savePicture().addHeader("Bearer", jwt).invoke(Picture(111,marshal(bytes)))futQR.onComplete {case Success(qr) => println(s"Saving Success: ${qr.msg}")case Failure(err) => println(s"Saving Error: ${err.getMessage}")}scala.io.StdIn.readLine()val futPic = client.getPicture().addHeader("Bearer", jwt).invoke(Picture(111,ByteString.EMPTY))futPic.onComplete {case Success(pic) =>val image = bytesToMat(unmarshal(pic.blob))show(image, s"picture:${pic.num}")case Failure(err) => println(s"Reading Error: ${err.getMessage}")}scala.io.StdIn.readLine()sys.terminate()}
}

基本流程是:先通过getAuthToken获取jwt;在调用服务时通过addHeader("bearer",jwt)把jwt随着函数调用一起提交给服务端。

客户端设置可以在配置文件中定义:

akka {loglevel = INFOgrpc.client {"com.datatech.pos.abs.Services" {host = 192.168.11.189port = 52051override-authority = foo.test.google.fruse-tls = false}}}

 

这篇关于akka-grpc - 应用案例的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/887179

相关文章

Java中的Lambda表达式及其应用小结

《Java中的Lambda表达式及其应用小结》Java中的Lambda表达式是一项极具创新性的特性,它使得Java代码更加简洁和高效,尤其是在集合操作和并行处理方面,:本文主要介绍Java中的La... 目录前言1. 什么是Lambda表达式?2. Lambda表达式的基本语法例子1:最简单的Lambda表

Python结合PyWebView库打造跨平台桌面应用

《Python结合PyWebView库打造跨平台桌面应用》随着Web技术的发展,将HTML/CSS/JavaScript与Python结合构建桌面应用成为可能,本文将系统讲解如何使用PyWebView... 目录一、技术原理与优势分析1.1 架构原理1.2 核心优势二、开发环境搭建2.1 安装依赖2.2 验

Java字符串操作技巧之语法、示例与应用场景分析

《Java字符串操作技巧之语法、示例与应用场景分析》在Java算法题和日常开发中,字符串处理是必备的核心技能,本文全面梳理Java中字符串的常用操作语法,结合代码示例、应用场景和避坑指南,可快速掌握字... 目录引言1. 基础操作1.1 创建字符串1.2 获取长度1.3 访问字符2. 字符串处理2.1 子字

SpringShell命令行之交互式Shell应用开发方式

《SpringShell命令行之交互式Shell应用开发方式》本文将深入探讨SpringShell的核心特性、实现方式及应用场景,帮助开发者掌握这一强大工具,具有很好的参考价值,希望对大家有所帮助,如... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定

SpringBoot应用中出现的Full GC问题的场景与解决

《SpringBoot应用中出现的FullGC问题的场景与解决》这篇文章主要为大家详细介绍了SpringBoot应用中出现的FullGC问题的场景与解决方法,文中的示例代码讲解详细,感兴趣的小伙伴可... 目录Full GC的原理与触发条件原理触发条件对Spring Boot应用的影响示例代码优化建议结论F

MySQL 分区与分库分表策略应用小结

《MySQL分区与分库分表策略应用小结》在大数据量、复杂查询和高并发的应用场景下,单一数据库往往难以满足性能和扩展性的要求,本文将详细介绍这两种策略的基本概念、实现方法及优缺点,并通过实际案例展示如... 目录mysql 分区与分库分表策略1. 数据库水平拆分的背景2. MySQL 分区策略2.1 分区概念

Python中使用正则表达式精准匹配IP地址的案例

《Python中使用正则表达式精准匹配IP地址的案例》Python的正则表达式(re模块)是完成这个任务的利器,但你知道怎么写才能准确匹配各种合法的IP地址吗,今天我们就来详细探讨这个问题,感兴趣的朋... 目录为什么需要IP正则表达式?IP地址的基本结构基础正则表达式写法精确匹配0-255的数字验证IP地

MySQL高级查询之JOIN、子查询、窗口函数实际案例

《MySQL高级查询之JOIN、子查询、窗口函数实际案例》:本文主要介绍MySQL高级查询之JOIN、子查询、窗口函数实际案例的相关资料,JOIN用于多表关联查询,子查询用于数据筛选和过滤,窗口函... 目录前言1. JOIN(连接查询)1.1 内连接(INNER JOIN)1.2 左连接(LEFT JOI

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S

C语言函数递归实际应用举例详解

《C语言函数递归实际应用举例详解》程序调用自身的编程技巧称为递归,递归做为一种算法在程序设计语言中广泛应用,:本文主要介绍C语言函数递归实际应用举例的相关资料,文中通过代码介绍的非常详细,需要的朋... 目录前言一、递归的概念与思想二、递归的限制条件 三、递归的实际应用举例(一)求 n 的阶乘(二)顺序打印