update readme files with optimization

This commit is contained in:
Andy Pan 2018-12-06 00:50:33 +08:00
parent 9b3fe4b603
commit 08469e8dc2
2 changed files with 13 additions and 13 deletions

View File

@ -13,7 +13,7 @@
[中文项目说明](README_ZH.md) | [Project Tutorial](http://blog.taohuawu.club/article/goroutine-pool) [中文项目说明](README_ZH.md) | [Project Tutorial](http://blog.taohuawu.club/article/goroutine-pool)
Package ants implements a fixed goroutine pool for managing and recycling a massive number of goroutines, allowing developers to limit the number of goroutines that created by your concurrent programs. Package `ants` implements a fixed goroutine pool for managing and recycling a massive number of goroutines, allowing developers to limit the number of goroutines that created in your concurrent programs.
## Features: ## Features:
@ -36,7 +36,7 @@ glide get github.com/panjf2000/ants
``` ```
## How to use ## How to use
If your program will generate a massive number of goroutines and you don't want them to consume a vast amount of memory, with ants, all you need to do is to import ants package and submit all your tasks to the default limited pool created when ants was imported: If your program will generate a massive number of goroutines and you don't want them to consume a vast amount of memory, with `ants`, all you need to do is to import `ants` package and submit all your tasks to the default limited pool created when `ants` was imported:
``` go ``` go
package main package main
@ -154,14 +154,14 @@ func main() {
} }
``` ```
## Submit tasks ## Submits tasks
Tasks can be submitted by calling `ants.Submit(func())` Tasks can be submitted by calling `ants.Submit(func())`
```go ```go
ants.Submit(func(){}) ants.Submit(func(){})
``` ```
## Custom limited pool ## Customizes limited pool
Ants also supports custom limited pool. You can use the `NewPool` method to create a pool with the given capacity, as following: `ants` also supports customizing limited pool. You can use the `NewPool` method to create a pool with the given capacity, as following:
``` go ``` go
// Sets 10000 the size of goroutine pool // Sets 10000 the size of goroutine pool
@ -171,7 +171,7 @@ p.Submit(func(){})
``` ```
## Tuning pool capacity ## Tuning pool capacity
You can change ants pool capacity at any time with `ReSize(int)`: You can change `ants` pool capacity at any time with `ReSize(int)`:
``` go ``` go
pool.ReSize(1000) // Tunes its capacity to 1000 pool.ReSize(1000) // Tunes its capacity to 1000
@ -181,7 +181,7 @@ pool.ReSize(100000) // Tunes its capacity to 100000
Don't worry about the synchronous problems in this case, this method is thread-safe. Don't worry about the synchronous problems in this case, this method is thread-safe.
## About sequence ## About sequence
All the tasks submitted to ants pool will not be guaranteed to be processed in order, because those tasks distribute among a series of concurrent workers, thus those tasks are processed concurrently. All the tasks submitted to `ants` pool will not be guaranteed to be processed in order, because those tasks distribute among a series of concurrent workers, thus those tasks are processed concurrently.
## Benchmarks ## Benchmarks
@ -195,11 +195,11 @@ Go1.9
<div align="center"><img src="ants_benchmarks.png"/></div> <div align="center"><img src="ants_benchmarks.png"/></div>
In that benchmark-picture, the first and second benchmarks performed test with 1M tasks and the rest of benchmarks performed test with 10M tasks, both unlimited goroutines and ants pool, and the capacity of this ants goroutine-pool was limited to 50K. In that benchmark-picture, the first and second benchmarks performed test with 1M tasks and the rest of benchmarks performed test with 10M tasks, both unlimited goroutines and `ants` pool, and the capacity of this `ants` goroutine-pool was limited to 50K.
- BenchmarkGoroutine-4 represents the benchmarks with unlimited goroutines in golang. - BenchmarkGoroutine-4 represents the benchmarks with unlimited goroutines in golang.
- BenchmarkPoolGroutine-4 represents the benchmarks with a ants pool. - BenchmarkPoolGroutine-4 represents the benchmarks with a `ants` pool.
The test data above is a basic benchmark and the more detailed benchmarks will be uploaded later. The test data above is a basic benchmark and the more detailed benchmarks will be uploaded later.
@ -207,7 +207,7 @@ The test data above is a basic benchmark and the more detailed benchmarks will
![](benchmark_pool.png) ![](benchmark_pool.png)
In that benchmark-picture, the first and second benchmarks performed test with 1M tasks and the rest of benchmarks performed test with 10M tasks, both unlimited goroutines and ants pool, and the capacity of this ants goroutine-pool was limited to 50K. In that benchmark-picture, the first and second benchmarks performed test with 1M tasks and the rest of benchmarks performed test with 10M tasks, both unlimited goroutines and `ants` pool, and the capacity of this `ants` goroutine-pool was limited to 50K.
**As you can see, `ants` can up to 2x faster than goroutines without pool (10M tasks) and it only consumes half memory comparing with goroutines without pool. (both 1M and 10M tasks)** **As you can see, `ants` can up to 2x faster than goroutines without pool (10M tasks) and it only consumes half memory comparing with goroutines without pool. (both 1M and 10M tasks)**
@ -231,7 +231,7 @@ In that benchmark-picture, the first and second benchmarks performed test with 1
There was only the test of `ants` Pool because my computer was crash when it reached 10M goroutines without pool. There was only the test of `ants` Pool because my computer was crash when it reached 10M goroutines without pool.
**As you can see, `ants` can up to 2x~6x faster than goroutines without pool and the memory consumption is reduced by 10 to 20 times.** **In conclusion, `ants` can up to 2x~6x faster than goroutines without pool and the memory consumption is reduced by 10 to 20 times.**
[1]: https://travis-ci.com/panjf2000/ants.svg?branch=develop [1]: https://travis-ci.com/panjf2000/ants.svg?branch=develop
[2]: https://travis-ci.com/panjf2000/ants [2]: https://travis-ci.com/panjf2000/ants

View File

@ -96,7 +96,7 @@ func main() {
fmt.Printf("running goroutines: %d\n", p.Running()) fmt.Printf("running goroutines: %d\n", p.Running())
fmt.Printf("finish all tasks, result is %d\n", sum) fmt.Printf("finish all tasks, result is %d\n", sum)
} }
``` ```
## 与http server集成 ## 与http server集成
```go ```go
@ -229,7 +229,7 @@ Go1.9
1000w任务量的场景下我的电脑已经无法支撑 golang 的原生 goroutine 并发,所以只测出了使用`ants`池的测试结果。 1000w任务量的场景下我的电脑已经无法支撑 golang 的原生 goroutine 并发,所以只测出了使用`ants`池的测试结果。
**从该demo测试吞吐性能对比可以看出使用ants的吞吐性能相较于原生goroutine可以保持在2-6倍的性能压制而内存消耗则可以达到10-20倍的节省优势。** **从该demo测试吞吐性能对比可以看出使用`ants`的吞吐性能相较于原生goroutine可以保持在2-6倍的性能压制而内存消耗则可以达到10-20倍的节省优势。**
[1]: https://travis-ci.com/panjf2000/ants.svg?branch=develop [1]: https://travis-ci.com/panjf2000/ants.svg?branch=develop
[2]: https://travis-ci.com/panjf2000/ants [2]: https://travis-ci.com/panjf2000/ants