mirror of
https://github.com/kataras/iris.git
synced 2025-02-02 15:30:36 +01:00
5e4b63acb2
# FAQ ### Looking for free support? http://support.iris-go.com https://kataras.rocket.chat/channel/iris ### Looking for previous versions? https://github.com/kataras/iris#version ### Should I upgrade my Iris? Developers are not forced to upgrade if they don't really need it. Upgrade whenever you feel ready. > Iris uses the [vendor directory](https://docs.google.com/document/d/1Bz5-UB7g2uPBdOx-rw5t9MxJwkfpx90cqG9AFL0JAYo) feature, so you get truly reproducible builds, as this method guards against upstream renames and deletes. **How to upgrade**: Open your command-line and execute this command: `go get -u github.com/kataras/iris`. For further installation support, please click [here](http://support.iris-go.com/d/16-how-to-install-iris-web-framework). ### About our new home page http://iris-go.com Thanks to [Santosh Anand](https://github.com/santoshanand) the http://iris-go.com has been upgraded and it's really awesome! [Santosh](https://github.com/santoshanand) is a freelancer, he has a great knowledge of nodejs and express js, Android, iOS, React Native, Vue.js etc, if you need a developer to find or create a solution for your problem or task, please contact with him. The amount of the next two or three donations you'll send they will be immediately transferred to his own account balance, so be generous please! Read more at https://github.com/kataras/iris/blob/master/HISTORY.md Former-commit-id: eec2d71bbe011d6b48d2526eb25919e36e5ad94e
71 lines
2.3 KiB
Go
71 lines
2.3 KiB
Go
// Copyright 2017 Gerasimos Maropoulos, ΓΜ. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
/* Package cache provides cache capabilities with rich support of options and rules.
|
|
|
|
Example code:
|
|
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/kataras/iris"
|
|
"github.com/kataras/iris/cache"
|
|
"github.com/kataras/iris/context"
|
|
)
|
|
|
|
func main(){
|
|
app := iris.Default()
|
|
cachedHandler := cache.CacheHandler(h, 2 *time.Minute)
|
|
app.Get("/hello", cachedHandler)
|
|
app.Run(iris.Addr(":8080"))
|
|
}
|
|
|
|
func h(ctx context.Context) {
|
|
ctx.HTML("<h1> Hello, this should be cached. Every 2 minutes it will be refreshed, check your browser's inspector</h1>")
|
|
}
|
|
*/
|
|
|
|
package cache
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/kataras/iris/cache/client"
|
|
"github.com/kataras/iris/context"
|
|
)
|
|
|
|
// Cache accepts two parameters
|
|
// first is the context.Handler which you want to cache its result
|
|
// the second is, optional, the cache Entry's expiration duration
|
|
// if the expiration <=2 seconds then expiration is taken by the "cache-control's maxage" header
|
|
// returns context.Handler, which you can use as your default router or per-route handler
|
|
//
|
|
// All type of responses are cached, templates, json, text, anything.
|
|
//
|
|
// You can add validators with this function
|
|
func Cache(bodyHandler context.Handler, expiration time.Duration) *client.Handler {
|
|
return client.NewHandler(bodyHandler, expiration)
|
|
}
|
|
|
|
// CacheHandler accepts two parameters
|
|
// first is the context.Handler which you want to cache its result
|
|
// the second is, optional, the cache Entry's expiration duration
|
|
// if the expiration <=2 seconds then expiration is taken by the "cache-control's maxage" header
|
|
// returns context.Handler, which you can use as your default router or per-route handler
|
|
//
|
|
// All type of responses are cached, templates, json, text, anything.
|
|
//
|
|
// it returns the context.Handler, for more options use the .Cache .
|
|
func CacheHandler(bodyHandler context.Handler, expiration time.Duration) context.Handler {
|
|
return Cache(bodyHandler, expiration).ServeHTTP
|
|
}
|
|
|
|
var (
|
|
// NoCache called when a particular handler is not valid for cache.
|
|
// If this function called inside a handler then the handler is not cached
|
|
// even if it's surrounded with the Cache/CacheFunc/CacheRemote wrappers.
|
|
NoCache = client.NoCache
|
|
)
|