Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
嗝屁小孩纸
guide-rpc-framework
提交
83332b42
G
guide-rpc-framework
项目概览
嗝屁小孩纸
/
guide-rpc-framework
与 Fork 源项目一致
从无法访问的项目Fork
通知
3
Star
1
Fork
1
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
G
guide-rpc-framework
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
83332b42
编写于
6月 03, 2020
作者:
S
shuang.kou
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
[v3.0]refractor add commont to RpcMessageChecker class
上级
34407b7e
变更
4
显示空白变更内容
内联
并排
Showing
4 changed file
with
113 addition
and
2 deletion
+113
-2
README.md
README.md
+111
-2
images/run-check-style.png
images/run-check-style.png
+0
-0
images/setting-check-style.png
images/setting-check-style.png
+0
-0
rpc-framework-simple/src/main/java/github/javaguide/remoting/dto/RpcMessageChecker.java
...java/github/javaguide/remoting/dto/RpcMessageChecker.java
+2
-0
未找到文件。
README.md
浏览文件 @
83332b42
# guide-rpc-framework
**ps:这部分内容可以参考 Dubbo 框架来写。**
guide-rpc-framework 是一款基于 Netty+Kyro+Zookeeper 实现的 RPC 框架。代码注释详细,结构清晰,非常适合阅读和学习。
## 项目模块介绍
由于Guide哥自身精力和能力有限,如果大家觉得有需要改进和完善的地方的话,欢迎将本项目 clone 到自己本地,在本地修改后提交 PR 给我,我会在第一时间 Review 你的代码。
## 介绍
**我们先从一个基本的 RPC 框架设计思路说起!**
### 一个基本的RPC框架设计思路
一个典型的使用 RPC 的场景如下,一般情况下 RPC 框架不仅要提供服务发现功能,还要提供负载均衡、容错等功能,这个的 RPC 框架才算真正合格。
![
一个完整的RPC框架使用示意图
](
https://my-blog-to-use.oss-cn-beijing.aliyuncs.com/2019-11/一个完整的rpc框架.jpg
)
简单说一下设计一个最基本的 RPC 框架的思路:
1.
**注册中心**
:注册中心首先是要有的,推荐使用 Zookeeper。注册中心主要用来保存相关的信息比如远程方法的地址。
2.
**网络传输**
:既然要调用远程的方法就要发请求,请求中至少要包含你调用的类名、方法名以及相关参数吧!推荐基于NIO 的 Netty框架。
3.
**序列化**
:既然涉及到网络传输就一定涉及到序列化,你不可能直接使用 JDK 自带的序列化吧!JDK 自带的序列化效率低并且有安全漏洞。 所以,你还要考虑使用哪种序列化协议,比较常用的有 hession2、kyro、protostuff。
4.
**动态代理**
: 另外,动态代理也是需要的。因为 RPC 的主要目的就是让我们调用远程方法像调用本地方法一样简单,使用动态代理屏蔽远程接口调用的细节比如网络传输。
5.
**负载均衡**
:负载均衡也是需要的。为啥?举个例子我们的系统中的某个服务的访问量特别大,我们将这个服务部署在了多台服务器上,当客户端发起请求的时候,多台服务器都可以处理这个请求。那么,如何正确选择处理该请求的服务器就很关键。假如,你就要一台服务器来处理该服务的请求,那该服务部署在多台服务器的意义就不复存在了。负载均衡就是为了避免单个服务器响应同一请求,容易造成服务器宕机、崩溃等问题,我们从负载均衡的这四个字就能明显感受到它的意义。
6.
......
### 项目基本情况和可优化点
最期初的是时候,我是基于传统的
**BIO**
的方式
**Socket**
进行网络传输,然后利用
**JDK 自带的序列化机制**
以及内存直接存储相关服务相关信息来实现这个 RPC 框架的。
后面,我对原始版本进行了优化,已完成的优化点和可以完成的优化点如下。
**为什么要把可优化点列出来?**
主要是想给哪些希望优化这个 RPC 框架的小伙伴一点思路。欢迎大家 Clone 本仓库,然后自己进行优化。
-
[x]
**使用Netty(基于NIO)替代BIO实现网络传输;**
-
[x]
**增加Netty进行客户端连接服务端时的重试机制。**
-
[x]
**使用开源的序列化机制 Kyro(也可以用其它的)替代 JDK 自带的序列化机制;**
-
[x]
**使用Zookeeper管理相关服务地址信息**
-
[ ]
**增加可配置比如序列化方式、注册中心的实现方式,避免硬编码**
:通过API配置,后续集成 Spring 的话建议使用配置文件的方式进行配置
-
[ ]
**客户端调用远程服务的时候进行负载均衡**
:发布服务的时候增加 一个 loadbalance 参数即可。
-
[ ]
**使用注解进行服务配置和消费**
-
[ ]
**处理一个接口有多个实现的情况**
:对服务分组,发布服务的时候增加一个 group 参数即可。
-
[ ]
**增加服务版本号**
:建议使用两位数字版本,如:1.0,通常在接口不兼容时版本号才需要升级。为什么要增加服务版本号?为后续不兼容升级提供可能,比如服务接口增加方法,或服务模型增加字段,可向后兼容,删除方法或删除字段,将不兼容,枚举类型新增字段也不兼容,需通过变更版本号升级。
-
[ ]
**客户端与服务端通信协议(数据包结构)重新设计**
,可以将原有的
`RpcRequest `
和
`RpcReuqest`
对象作为消息体,然后增加如下字段(可以参考:《Netty入门实战小册》和Dubbo框架对这块的设计):
-
**魔数**
: 通常是 4 个字节。这个魔数主要是为了筛选来到服务端的数据包,有了这个魔数之后,服务端首先取出前面四个字节进行比对,能够在第一时间识别出这个数据包并非是遵循自定义协议的,也就是无效数据包,为了安全考虑可以直接关闭连接以节省资源。
-
**序列化器编号**
:标识序列化的方式,比如是使用 Java 自带的序列化,还是 json,kyro 等序列化方式。
-
**消息体长度**
: 运行时计算出来。
-
......
### 项目模块概览
![](
./images/RPC框架各个模块介绍.png
)
## 效果展示
## 运行项目
**1.导入项目**
**2.初始化git hooks**
> 以下演示的是 Mac/Linux对应的操作,Window 用户需要手动将 `config/git-hooks` 目录下的`pre-commit ` 文件拷贝到 项目下的 `.git/hooks/` 目录。
你需要以此执行下面这些命令:
```
shell
➜ guide-rpc-framework git:
(
master
)
✗
chmod
+x ./init.sh
➜ guide-rpc-framework git:
(
master
)
✗ ./init.sh
```
`init.sh`
这个脚本的主要作用是将 git commit 钩子拷贝到项目下的
`.git/hooks/`
目录,这样你每次commit的时候就会执行了。
```
shell
cp
config/git-hooks/pre-commit .git/hooks/
chmod
+x .git/hooks/pre-commit
```
> 抱怨:项目上一直用的 Gradle,很久没用 Maven 了,感觉 Maven很多方面都比 Maven 要更好用!比如Gradle的项目依赖文件`build.gradle` 比 Maven 的`pom.xml`更加清晰简洁(Maven是因为xml的锅)、Gradel还可以使用 groovy 语言......
>
`pre-commit`
的内容如下,主要作用是在提交代码前运行
`Check Style`
检查代码格式问题。
```
shell
#!/bin/sh
#set -x
echo
"begin to execute hook"
mvn checkstyle:check
RESULT
=
$?
exit
$RESULT
```
效果展示:
**3.CheckStyle 插件下载和配置**
Settings->Plugins->搜索下载CheckStyle 插件,然后按照如下方式
![](
./images/setting-check-style.png
)
![](
./images/run-check-style.png
)
## 相关问题
### 为什么要造这个轮子?Dubbo不香么?
写这个 RPC 框架主要是为了通过造轮子的方式来学习,检验自己对于自己所掌握的知识的运用。
实现一个简单的RPC框架实际是比较容易的,不过,相比于手写AOP和IoC还是要难一点点,前提是你搞懂了RPC的基本原理。
我之前从理论层面在我的知识星球分享过如何实现一个RPC。不过理论层面的东西只是支撑,你看懂了理论可能只能糊弄住面试官。咱程序员这一行还是最需要动手能力,即使你是架构师级别的人物。当你动手去实践某个东西,将理论付诸实践的时候,你就会发现有很多坑等着你。
大家在实际项目上还是要尽量少造轮子,有优秀的框架之后尽量就去用,Dubbo 在各个方面做的都比较好和完善。
### 如果我要自己写的话,可以参考哪些资料?
images/run-check-style.png
0 → 100644
浏览文件 @
83332b42
206.4 KB
images/setting-check-style.png
0 → 100644
浏览文件 @
83332b42
566.4 KB
rpc-framework-simple/src/main/java/github/javaguide/remoting/dto/RpcMessageChecker.java
浏览文件 @
83332b42
...
...
@@ -7,6 +7,8 @@ import github.javaguide.exception.RpcException;
import
lombok.extern.slf4j.Slf4j
;
/**
* 校验 RpcRequest 和 RpcRequest
*
* @author shuang.kou
* @createTime 2020年05月26日 18:03:00
*/
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录