C#中使用gRPC通讯的示例详解

 更新时间:2024年04月11日 08:44:10   作者:叫我少年  
这篇文章主要为大家详细介绍了C#中如何使用gRPC通讯,包括GRPC文件的创建生成、服务端和客户端函数类库的封装等,需要的可以了解下

在c#中使用gRPC通讯

参考:C#封装GRPC类库及调用简单实例

包括:GRPC文件的创建生成、服务端和客户端函数类库的封装、创建服务端和客户端调用测试。

创建并生成GRPC服务文件

  • 创建新项目控制台应用 , 项目名称(MgRPC)
  • 安装三个nuget包 Google.Protobuf , Grpc.Core , Grpc.Tools
  • 项目添加新建项,选择类,修改名称为Link.proto,添加后把Link.proto里面内容清空

定义Protocol

添加代码。测试实例为服务端和客户端传输字符串消息,只定义了一个方法(客户端调用,服务端重写),传输内容包括请求字符串和回复字符串。此处可自行定义。

syntax = "proto3";//proto3 是 Protocol Buffers 的第三个版本

// 指定了生成的 C# 代码的命名空间为 LinkService。当使用 protobuf 编译器 (protoc) 将这个 .proto 文件转换为 C# 代码时,生成的类将位于 LinkService 命名空间中
option csharp_namespace = "LinkService";

//定义了一个名为 Link 的 gRPC 服务。在 gRPC 中,服务是由一个或多个 RPC 方法组成的
service Link
{
	//定义了一个 RPC 方法。这个方法名为 GetMessage,它接受一个 Mes 类型的消息作为参数,
	//并返回一个 Mes 类型的消息。在 gRPC 中,客户端可以调用这个方法,并发送一个 Mes 消息给服务端,然后服务端会处理这个消息并返回一个 Mes 消息给客户端。
	rpc GetMessage(Mes) returns (Mes);
}

//定义了一个名为 Mes 的消息类型。在 protobuf 中,消息是由一系列字段组成的,每个字段都有一个名称、一个类型和一个标识符。
message Mes
{
    // 客户端发送
	// 定义了一个名为 StrRequest 的字段,类型为 string,标识符为 1。这个标识符在消息内部是唯一的,并且一旦分配就不能更改,因为它被用于序列化和反序列化过程中的字段识别。
	string StrRequest = 1;
	// 同样定义了一个名为 StrReply 的字段,类型为 string,标识符为 2。(服务端回复)
	string StrReply = 2;
}

设置Link.proto

右键Link.proto文件选择属性,生成操作选择如图:

生成cs文件代码

生成解决方案。在下图路径得到自动生成的两个类。

至此,获得GRPC服务需要的三个文件:Link.proto、Link.cs、LinkGrpc.cs。可以将这三个文件放在一个项目中直接使用,需要重写一下服务端方法、创建服务端和客户端的启动方法。但是如果不同的项目软件之间通讯需要各自如此开发。可以先封装成一个GRPC类库供其他项目直接调用。

服务端和客户端类库的封装

  • 创建类库(.NET Framework)项目 , 项目名称(GrpcLink)
  • 项目添加现有项,上面获得的三个文件(Link.cs , LinkGrpc.cs)。安装nuget包:Grpc.Core和Google.Protobuf。
  • 创建两个类:LinkFunc用于放此类库可用于外部引用调用的方法。LinkServerFunc基于Link.LinkBase,用于重写在proto文件中定义的方法。

对于不同的项目,在客户端请求时,服务端要根据自身情况回复想回的内容,因此可以提供一个委托供外部自行开发回复函数。

在LinkFunc类中定义如下:

public static Func<string, string> ReplyMes;

LinkServerFunc

在LinkServerFunc类重写GetMessage方法如下

using Grpc.Core;
using LinkService;
using System.Threading.Tasks;
using static LinkService.Link;

namespace GrpcLink
{
    /// <summary>
    /// 重写在proto文件中定义的方法
    /// </summary>
    public class LinkServerFunc : LinkBase
    {
        public override Task<Mes> GetMessage(Mes request,ServerCallContext context)
        {
            Mes mes = new Mes();
            mes.StrReply = LinkFunc.ReplyMes(request.StrRequest);
            return Task.FromResult(mes);
        }
    }
}

LinkFunc

using Grpc.Core;
using LinkService;
using System;
using static LinkService.Link;

namespace GrpcLink
{
    public class LinkFunc
    {
        /// <summary>
        /// 用于服务端回复委托
        /// </summary>
        public static Func<string,string> ReplyMes;

        // 定义服务端和客户端
        public static Server LinkServer;
        public static LinkClient LinkClient;

        /// <summary>
        ///  服务端启动
        /// </summary>
        /// <param name="host"></param>
        /// <param name="port"></param>
        public static void LinkServerStart(string host,int port)
        {
            LinkServer = new Server
            {
                Services =
                    {
                        BindService(new LinkServerFunc())
                    },
                Ports = { new ServerPort(host,port,ServerCredentials.Insecure) }
            };
            LinkServer.Start();
        }

        /// <summary>
        ///  服务端关闭
        /// </summary>
        public static void LinkServerClose()
        {
            LinkServer?.ShutdownAsync().Wait();
        }

        /// <summary>
        /// 客户端启动
        /// </summary>
        /// <param name="strIp"></param>
        public static void LinkClientStart(string strIp)
        {
            Channel prechannel = new Channel(strIp,ChannelCredentials.Insecure);
            LinkClient = new LinkClient(prechannel);
        }

        /// <summary>
        /// 客户端发送消息函数
        /// </summary>
        /// <param name="strRequest"></param>
        /// <returns></returns>
        public static string SendMes(string strRequest)
        {
            Mes mes = new Mes();
            mes.StrRequest = strRequest;
            var res = LinkClient.GetMessage(mes);
            return res.StrReply;
        }
    }
}

生成引用库

生成解决方案。Debug中可以得到项目的dll文件GrpcLink.dll,其他项目可以引用使用了。

创建服务端和客户端调用测试

  • 创建两个控制台(.NET Framework)项目 , 项目名称TestCilent , TestServer
  • 将上述GrpcLink.dll文件分别放入两个项目中,并添加dll引用。 如果没有则安装nuget包:Grpc.Core和Google.Protobuf(此次测试没有安装)

TestServer服务端

using GrpcLink;
using System;
using System.Threading;

namespace TestServer
{
    /// <summary>
    /// 测试服务端
    /// </summary>
    internal class Program
    {
        static void Main(string[] args)
        {
            LinkFunc.LinkServerStart("127.0.0.1",9008);
            Thread.Sleep(500);
            LinkFunc.ReplyMes = ReplyMes;
            Console.ReadKey();
        }


        /// <summary>
        /// 接收到客户端信息后回复
        /// </summary>
        /// <param name="strRequest">客户端发送过来的内容</param>
        /// <returns></returns>
        public static string ReplyMes(string strRequest)
        {
            Console.WriteLine("接收到:" + strRequest);
            switch (strRequest)
            {
                case "1":
                return "Server识别到1";
                case "2":
                return "Server识别到2";
                case "测试":
                return "开始测试"; 
                case "连接服务端":
                return "true";
            }
            return "Server未识别到指定参数";
        }
    }
}

TestCilent客户端

using GrpcLink;
using System;
using System.Threading;

namespace TestCilent
{
    internal class Program
    {
        static void Main(string[] args)
        {
            Thread.Sleep(2000);
            LinkFunc.LinkClientStart("127.0.0.1:9008");
            Console.WriteLine("连接服务端中");
            string conn = LinkFunc.SendMes("连接服务端");

            if (conn.Equals("true"))
            {
                Console.WriteLine("连接服务端成功!");


                for (int i = 0 ; i < 10 ; i++)
                {
                    Thread.Sleep(1000);
                    Console.WriteLine("输入测试内容..");
                    var line = Console.ReadLine();
                    var ret = LinkFunc.SendMes(line);
                    //获取到服务端返回的值
                    Console.WriteLine(ret);

                }
            }

            Console.WriteLine("连接失败 , 即将退出");
            Thread.Sleep(2000);
        }
    }
}

测试图例

以上就是C#中使用gRPC通讯的示例详解的详细内容,更多关于C# gRPC通讯的资料请关注脚本之家其它相关文章!

相关文章

  • 理解C#中的Lambda表达式

    理解C#中的Lambda表达式

    这篇文章主要介绍了理解C#中的Lambda表达式,本文用实例代码来讲解Lambda表达式,用不同的角度总结对它的认识,需要的朋友可以参考下
    2015-04-04
  • C# Socket编程实现简单的局域网聊天器的示例代码

    C# Socket编程实现简单的局域网聊天器的示例代码

    这篇文章主要介绍了C# Socket编程实现简单的局域网聊天器,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-03-03
  • 图文详解C#中的协变与逆变

    图文详解C#中的协变与逆变

    “协变”是指能够使用与原始指定的派生类型相比,派生程度更大的类型,“逆变”则是指能够使用派生程度更小的类型,这篇文章主要给大家介绍了关于C#中协变与逆变的相关资料,需要的朋友可以参考下
    2022-02-02
  • C#自定义鼠标拖拽Drag&Drop效果之基本原理及基本实现代码

    C#自定义鼠标拖拽Drag&Drop效果之基本原理及基本实现代码

    拖拽效果无论是在系统上、应用上、还是在网页上,拖拽随处可见,下面通过本文介绍下C#自定义鼠标拖拽Drag&Drop效果之基本原理及基本实现代码,需要的朋友可以参考下
    2022-04-04
  • C#在 .NET中使用依赖注入的示例详解

    C#在 .NET中使用依赖注入的示例详解

    这篇文章主要为大家详细介绍了C#如何在 .NET中使用依赖注入,文中的示例代码讲解详细,具有一定的学习价值,感兴趣的小伙伴可以跟随小编一起了解一下
    2024-01-01
  • C#异步编程由浅入深(三)之详解Awaiter

    C#异步编程由浅入深(三)之详解Awaiter

    这篇文章主要介绍了C#异步编程由浅入深(三)之详解Awaiter,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-03-03
  • 比较2个datatable内容是否相同的方法

    比较2个datatable内容是否相同的方法

    这篇文章主要介绍了比较2个datatable内容是否相同的方法,大家参考使用吧
    2014-01-01
  • C#使用CefSharp和网页进行自动化交互的示例代码

    C#使用CefSharp和网页进行自动化交互的示例代码

    CefSharp 是一个用 C# 编写的开源库,它封装了 Google Chrome 浏览器的 Chromium 内核,CefSharp 允许开发者在其应用程序中嵌入浏览器功能,从而能够展示网页内容、执行JavaScript代码,本文给大家介绍了C#使用CefSharp和网页进行自动化交互,需要的朋友可以参考下
    2024-07-07
  • TextBox获取输入焦点时自动全选的实现方法

    TextBox获取输入焦点时自动全选的实现方法

    TextBox获取输入焦点时自动全选的实现方法,需要的朋友可以参考一下
    2013-03-03
  • C#实现自定义双击事件

    C#实现自定义双击事件

    这篇文章主要介绍了C#实现自定义双击事件,需要的朋友可以参考下
    2014-08-08

最新评论