cache

    You can read source code of this middleware on GitHubopen in new window and API documentation on .

    The minimum requirement of Go is 1.16.

    The open in new window works out-of-the-box with an optional and uses memory as the storage backend:

    1. package main
    3. import (
    4.     "net/http"
    5.     "time"
    7.     "github.com/flamego/cache"
    8.     "github.com/flamego/flamego"
    9. )
    11. func main() {
    12.     f := flamego.Classic()
    13.     f.Use(cache.Cacher())
    14.     f.Get("/set", func(r *http.Request, cache cache.Cache) error {
    15.         return cache.Set(r.Context(), "cooldown", true, time.Minute)
    16.     })
    17.     f.Get("/get", func(r *http.Request, cache cache.Cache) string {
    18.         v, err := cache.Get(r.Context(), "cooldown")
    19.         if err != nil && err != os.ErrNotExist {
    20.             return err.Error()
    21.         }
    23.         cooldown, ok := v.(bool)
    24.         if !ok || !cooldown {
    25.             return "It has been cooled"
    26.         }
    27.         return "Still hot"
    28.     })
    29.     f.Run()
    30. }

    File

    The is the function to initialize a file storage backend, used together with cache.FileConfigcache - 图6open in new window to customize the backend:

    The is the function to initialize a PostgreSQL storage backend, used together with postgres.Configcache - 图8open in new window to customize the backend:

    1. package main
    3.     "net/http"
    4.     "os"
    5.     "time"
    8.     "github.com/flamego/cache/postgres"
    9.     "github.com/flamego/flamego"
    10. )
    12. func main() {
    13.     f := flamego.Classic()
    15.     dsn := os.ExpandEnv("postgres://$PGUSER:$PGPASSWORD@$PGHOST:$PGPORT/$PGDATABASE?sslmode=$PGSSLMODE")
    16.     f.Use(cache.Cacher(
    17.         cache.Options{
    18.             Initer: postgres.Initer(),
    19.             Config: postgres.Config{
    20.                 DSN:       dsn,
    21.                 Table:     "cache",
    22.                 InitTable: true,
    23.             },
    24.         },
    25.     ))
    26.     f.Get("/set", func(r *http.Request, cache cache.Cache) error {
    27.         return cache.Set(r.Context(), "cooldown", true, time.Minute)
    28.     })
    29.     f.Get("/get", func(r *http.Request, cache cache.Cache) string {
    30.         v, err := cache.Get(r.Context(), "cooldown")
    31.         if err != nil && err != os.ErrNotExist {
    32.             return err.Error()
    33.         }
    35.         cooldown, ok := v.(bool)
    36.         if !ok || !cooldown {
    37.             return "It has been cooled"
    38.         }
    39.         return "Still hot"
    40.     })
    41.     f.Run()
    42. }

    MySQL

    The mysql.Initeropen in new window is the function to initialize a MySQL storage backend, used together with to customize the backend:

    1. package main
    2. import (
    4.     "os"
    5.     "time"
    7.     "github.com/flamego/cache"
    8.     "github.com/flamego/cache/redis"
    9.     "github.com/flamego/flamego"
    10. )
    12. func main() {
    13.     f := flamego.Classic()
    15.     f.Use(cache.Cacher(
    16.         cache.Options{
    17.             Initer: redis.Initer(),
    18.             Config: redis.Config{
    19.                 Options: &redis.Options{
    20.                     Addr: os.ExpandEnv("$REDIS_HOST:$REDIS_PORT"),
    21.                     DB:   15,
    22.                 },
    23.             },
    24.         },
    25.     ))
    26.     f.Get("/set", func(r *http.Request, cache cache.Cache) error {
    27.         return cache.Set(r.Context(), "cooldown", true, time.Minute)
    28.     })
    29.     f.Get("/get", func(r *http.Request, cache cache.Cache) string {
    30.         v, err := cache.Get(r.Context(), "cooldown")
    31.         if err != nil && err != os.ErrNotExist {
    32.             return err.Error()
    33.         }
    35.         cooldown, ok := v.(bool)
    36.         if !ok || !cooldown {
    37.             return "It has been cooled"
    38.         }
    39.         return "Still hot"
    40.     })
    41.     f.Run()
    42. }

    MongoDB

    The is the function to initialize a MongoDB storage backend, used together with mongo.Configcache - 图14open in new window to customize the backend:

    The default encoder and decoder of cache data use , and only limited types are supported for values. When you encounter errors like encode: gob: type not registered for interface: time.Duration, you can use cache - 图16open in new window to register the type for encoding and decoding.

    For example: