当前位置：首页 > news >正文

前后端交互接口（三）

news 2025/7/27 21:28:08

前后端交互接口（三）

前言

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

gateway.proto

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

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

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

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

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

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

//通信接口统一采用POST请求实现,正文采用protobuf协议进行组织
/*  HTTP HEADER：POST /service/xxxxxContent-Type: application/x-protobufContent-Length: 123xxxxxx-------------------------------------------------------HTTP/1.1 200 OK Content-Type: application/x-protobufContent-Length: 123xxxxxxxxxx
*/

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

再来看看网关约定的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，不要搞混了。