cache
The cache middleware provides cache data management for Flame instances, supporting various storage backends, including memory, file, PostgreSQL, MySQL, Redis, MongoDB and SQLite.
You can read source code of this middleware on GitHub and API documentation on pkg.go.dev.
Installation
go get github.com/flamego/cacheStorage backends
Memory
The cache.Cacher works out-of-the-box with an optional cache.Options and uses memory as the storage backend:
package main
import (
"net/http"
"time"
"github.com/flamego/cache"
"github.com/flamego/flamego"
)
func main() {
f := flamego.Classic()
f.Use(cache.Cacher())
f.Get("/set", func(r *http.Request, cache cache.Cache) error {
return cache.Set(r.Context(), "cooldown", true, time.Minute)
})
f.Get("/get", func(r *http.Request, cache cache.Cache) string {
v, err := cache.Get(r.Context(), "cooldown")
if err != nil && err != os.ErrNotExist {
return err.Error()
}
cooldown, ok := v.(bool)
if !ok || !cooldown {
return "It has been cooled"
}
return "Still hot"
})
f.Run()
}Because the memory is volatile, cache data do not survive over restarts. Choose other storage backends if you need to persist cache data.
File
The cache.FileIniter is the function to initialize a file storage backend, used together with cache.FileConfig to customize the backend:
package main
import (
"net/http"
"os"
"path/filepath"
"time"
"github.com/flamego/cache"
"github.com/flamego/flamego"
)
func main() {
f := flamego.Classic()
f.Use(cache.Cacher(
cache.Options{
Initer: cache.FileIniter(),
Config: cache.FileConfig{
RootDir: filepath.Join(os.TempDir(), "cache"),
},
},
))
f.Get("/set", func(r *http.Request, cache cache.Cache) error {
return cache.Set(r.Context(), "cooldown", true, time.Minute)
})
f.Get("/get", func(r *http.Request, cache cache.Cache) string {
v, err := cache.Get(r.Context(), "cooldown")
if err != nil && err != os.ErrNotExist {
return err.Error()
}
cooldown, ok := v.(bool)
if !ok || !cooldown {
return "It has been cooled"
}
return "Still hot"
})
f.Run()
}PostgreSQL
The postgres.Initer is the function to initialize a PostgreSQL storage backend, used together with postgres.Config to customize the backend:
package main
import (
"net/http"
"os"
"time"
"github.com/flamego/cache"
"github.com/flamego/cache/postgres"
"github.com/flamego/flamego"
)
func main() {
f := flamego.Classic()
dsn := os.ExpandEnv("postgres://$PGUSER:$PGPASSWORD@$PGHOST:$PGPORT/$PGDATABASE?sslmode=$PGSSLMODE")
f.Use(cache.Cacher(
cache.Options{
Initer: postgres.Initer(),
Config: postgres.Config{
DSN: dsn,
Table: "cache",
InitTable: true,
},
},
))
f.Get("/set", func(r *http.Request, cache cache.Cache) error {
return cache.Set(r.Context(), "cooldown", true, time.Minute)
})
f.Get("/get", func(r *http.Request, cache cache.Cache) string {
v, err := cache.Get(r.Context(), "cooldown")
if err != nil && err != os.ErrNotExist {
return err.Error()
}
cooldown, ok := v.(bool)
if !ok || !cooldown {
return "It has been cooled"
}
return "Still hot"
})
f.Run()
}MySQL
The mysql.Initer is the function to initialize a MySQL storage backend, used together with mysql.Config to customize the backend: