前后端交互接口(三)

前后端交互接口(三)

前言

前两集我们先做了前后端交互接口的约定以及浅浅的阅读了一些proto代码。那么这一集我们就来看看一些重要的proto代码,之后把protobuffer给引入我们的项目当中!

gateway.proto

我们来看一眼我们的网关proto代码!!!

在看之前,我们先来了解一下什么叫做网关。

网关,网关,其实就是一个入口。它通常是运行在服务器上的一个独立的服务或者是进程。它能够接受来自客户端的请求,然后根据相关配置以及业务的逻辑,将这些请求转发到一个或者多个后端服务器当中,当然这些后端服务器可以是数据库,也可以是微服务。他主要起到一个路由的作用。

所以我们的客户端是不需要去关注这个服务器的架构是什么样的,这需要和我们的网关服务器进行通信即可。

那么了解完网关的一个功能,我们就来看一眼我们的proto文件。

首先还是不能忘了我们的约法三章!统一使用POST发送请求、使用HTTP、Websocket协议、body使用protobuffer进行序列化/反序列化。

复制代码
//通信接口统一采用POST请求实现,正文采用protobuf协议进行组织
/*  
    HTTP HEADER:
    POST /service/xxxxx
    Content-Type: application/x-protobuf
    Content-Length: 123

    xxxxxx

    -------------------------------------------------------

    HTTP/1.1 200 OK 
    Content-Type: application/x-protobuf
    Content-Length: 123

    xxxxxxxxxx
*/

以上是我们客户端发送的请求以及服务端返回的响应。

再来看看网关约定的HTTP请求功能与接口路径关系

复制代码
    SERVICE HTTP PATH:
    {
        获取随机验证码                  /service/user/get_random_verify_code
        获取短信验证码                  /service/user/get_phone_verify_code
        用户名密码注册                  /service/user/username_register
        用户名密码登录                  /service/user/username_login
        手机号码注册                    /service/user/phone_register
        手机号码登录                    /service/user/phone_login
        获取个人信息                    /service/user/get_user_info
        修改头像                        /service/user/set_avatar
        修改昵称                        /service/user/set_nickname
        修改签名                        /service/user/set_description
        修改绑定手机                    /service/user/set_phone

        获取好友列表                    /service/friend/get_friend_list
        获取好友信息                    /service/friend/get_friend_info
        发送好友申请                    /service/friend/add_friend_apply
        好友申请处理                    /service/friend/add_friend_process
        删除好友                        /service/friend/remove_friend
        搜索用户                        /service/friend/search_friend
        获取指定用户的消息会话列表       /service/friend/get_chat_session_list
        创建消息会话                    /service/friend/create_chat_session
        获取消息会话成员列表             /service/friend/get_chat_session_member
        获取待处理好友申请事件列表       /service/friend/get_pending_friend_events

        获取历史消息/离线消息列表        /service/message_storage/get_history
        获取最近N条消息列表             /service/message_storage/get_recent
        搜索历史消息                    /service/message_storage/search_history
        
        发送消息                        /service/message_transmit/new_message

        获取单个文件数据                /service/file/get_single_file
        获取多个文件数据                /service/file/get_multi_file
        发送单个文件                    /service/file/put_single_file
        发送多个文件                    /service/file/put_multi_file

        语音转文字                     /service/speech/recognition
    }

哦对,虽然说我们的Websocket是服务端主动给客户端进行推送消息,但是你一开始不建立连接怎么推送?你客户端有了之后,服务端又不能直接知道你客户端的相关信息。所以有了以下内容。

复制代码
/*
    消息推送使用websocket长连接进行
    websocket长连接转换请求:ws://host:ip/ws
    长连建立以后,需要客户端给服务器发送一个身份验证信息
*/
message ClientAuthenticationReq {
    string request_id = 1;
    string session_id = 2;
}

这里的session_id是我们的登录回话id,切记不是我们的聊天会话id,不要搞混了。

引入Protobuf

第一步,点击进入CMakeLists.txt的文件当中

第二步,修改cmake的最小依赖版本为3.16

第三步,在这个末尾加上Protobuf

第四步,将proto文件放入项目当中

第五步,继续在CMakeLists.txt的文件当中添加下面的两行代码

第六步,点击项目,点击构建,再点击当前配置,加入protobuffer的路径(记得用vcpkg下载)

之后就可以看到我们的项目中添加了proto的文件了。

那么这一集就先到这里。

相关推荐
武帝为此1 小时前
【计算机网络之以太网详解】
服务器·网络·计算机网络
藍海琴泉1 小时前
Linux命令大全:从入门到高效运维
linux·运维·服务器
余华余华1 小时前
计算机等级考试数据库三级(笔记2)
java·服务器·数据库
ssxueyi1 小时前
StarRocks 证书SRCA和SRCP
大数据·数据库·证书·考试·starrocks认证
键盘上的GG小怪兽GG2 小时前
CentOS 安装LAMP全过程 - 完整步骤与最佳实践
linux·运维·centos
阿俊仔(摸鱼版)2 小时前
自动化构建攻略:Jenkins + Gitee 实现 Spring Boot 项目自动化构建
运维·ci/cd·gitee·自动化·jenkins
SeaTunnel2 小时前
Apache SeaTunnel同步MySQL到Doris的优化策略
数据库·mysql·postgresql·apache
AWS官方合作商2 小时前
AWS CloudWatch 实战:构建智能监控与自动化运维体系
运维·自动化·aws
java资料站2 小时前
linux ntpdate 时间矫正
linux·运维·python