gin-cache

English | 🇨🇳中文

A high performance gin middleware to cache http response. Compared to gin-contrib/cache. It has a huge performance improvement.

Feature

• Has a huge performance improvement compared to gin-contrib/cache.
• Cache http response in local memory or Redis.
• Offer a way to custom the cache strategy by per request.
• Use singleflight to avoid cache breakdown problem.
• Only Cache 2xx HTTP Response.

How To Use

Install

go get -u github.com/chenyahui/gin-cache

Example

Cache In Local Memory

package main
import (
"time""github.com/chenyahui/gin-cache""github.com/chenyahui/gin-cache/persist""github.com/gin-gonic/gin"
)
funcmain() {
app:=gin.New()
memoryStore:=persist.NewMemoryStore(1*time.Minute)
app.GET("/hello",
cache.CacheByRequestURI(memoryStore, 2*time.Second),
func(c*gin.Context) {
c.String(200, "hello world")
},
)
iferr:=app.Run(":8080"); err!=nil {
panic(err)
}
}

Cache In Redis

package main
import (
"time""github.com/chenyahui/gin-cache""github.com/chenyahui/gin-cache/persist""github.com/gin-gonic/gin""github.com/go-redis/redis/v8"
)
funcmain() {
app:=gin.New()
redisStore:=persist.NewRedisStore(redis.NewClient(&redis.Options{
Network: "tcp",
Addr: "127.0.0.1:6379",
}))
app.GET("/hello",
cache.CacheByRequestURI(redisStore, 2*time.Second),
func(c*gin.Context) {
c.String(200, "hello world")
},
)
iferr:=app.Run(":8080"); err!=nil {
panic(err)
}
}

Benchmark

wrk -c 500 -d 1m -t 5 http://127.0.0.1:8080/hello

MemoryStore

RedisStore