Skip to content

Commit 0041139

Browse files
committed
docs: add readme-cn.md
1 parent 8875d53 commit 0041139

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed

readme-cn.md

+62
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# mapreduce
2+
3+
[English](readme.md) | 简体中文
4+
5+
[![Go](https://github.com/kevwan/mapreduce/workflows/Go/badge.svg?branch=main)](https://github.com/kevwan/mapreduce/actions)
6+
[![codecov](https://codecov.io/gh/kevwan/mapreduce/branch/main/graph/badge.svg)](https://codecov.io/gh/kevwan/mapreduce)
7+
[![Go Report Card](https://goreportcard.com/badge/github.com/kevwan/mapreduce)](https://goreportcard.com/report/github.com/kevwan/mapreduce)
8+
[![Release](https://img.shields.io/github/v/release/kevwan/mapreduce.svg?style=flat-square)](https://github.com/kevwan/mapreduce)
9+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10+
11+
## 为什么会有这个项目
12+
13+
`mapreduce` 其实是 [go-zero](https://github.com/zeromicro/go-zero) 的一部分,但是一些用户问我是不是可以单独使用 `mapreduce` 而不用引入 `go-zero` 的依赖,所以我考虑再三,还是单独提供一个吧。但是,我强烈推荐你使用 `go-zero`,因为 `go-zero` 真的提供了很多很好的功能。
14+
15+
## 为什么需要 MapReduce
16+
17+
在实际的业务场景中我们常常需要从不同的 rpc 服务中获取相应属性来组装成复杂对象。
18+
19+
比如要查询商品详情:
20+
21+
1. 商品服务-查询商品属性
22+
2. 库存服务-查询库存属性
23+
3. 价格服务-查询价格属性
24+
4. 营销服务-查询营销属性
25+
26+
如果是串行调用的话响应时间会随着 rpc 调用次数呈线性增长,所以我们要优化性能一般会将串行改并行。
27+
28+
简单的场景下使用 waitGroup 也能够满足需求,但是如果我们需要对 rpc 调用返回的数据进行校验、数据加工转换、数据汇总呢?继续使用 waitGroup 就有点力不从心了,go 的官方库中并没有这种工具(java 中提供了 CompleteFuture),go-zero 作者依据 mapReduce 架构思想实现了进程内的数据批处理 mapReduce 并发工具类。
29+
30+
## 设计思路
31+
32+
我们尝试把自己代入到作者的角色梳理一下并发工具可能的业务场景:
33+
34+
1. 查询商品详情:支持并发调用多个服务来组合产品属性,支持调用错误可以立即结束。
35+
2. 商品详情页自动推荐用户卡券:支持并发校验卡券,校验失败自动剔除,返回全部卡券。
36+
37+
以上实际都是在进行对输入数据进行处理最后输出清洗后的数据,针对数据处理有个非常经典的异步模式:生产者消费者模式。于是我们可以抽象一下数据批处理的生命周期,大致可以分为三个阶段:
38+
39+
![](https://cdn.learnku.com/uploads/images/202112/27/73865/Ct2DlYTVZW.png!large)
40+
41+
1. 数据生产 generate
42+
2. 数据加工 mapper
43+
3. 数据聚合 reducer
44+
45+
其中数据生产是不可或缺的阶段,数据加工、数据聚合是可选阶段,数据生产与加工支持并发调用,数据聚合基本属于纯内存操作单协程即可。
46+
47+
再来思考一下不同阶段之间数据应该如何流转,既然不同阶段的数据处理都是由不同 goroutine 执行的,那么很自然的可以考虑采用 channel 来实现 goroutine 之间的通信。
48+
49+
![](https://cdn.learnku.com/uploads/images/202112/27/73865/JPazVK6rRf.png!large)
50+
51+
52+
如何实现随时终止流程呢?
53+
54+
很简单,goroutine 中监听一个全局的结束 channel 就行。
55+
56+
## 强烈推荐!
57+
58+
go-zero: [https://github.com/zeromicro/go-zero](https://github.com/zeromicro/go-zero)
59+
60+
## 欢迎 star!⭐
61+
62+
如果你正在使用或者觉得这个项目对你有帮助,请 **star** 支持,感谢!

0 commit comments

Comments
 (0)