mirror of
https://github.com/kataras/iris.git
synced 2025-01-23 18:51:03 +01:00
0f113dfcda
- Remove the context.Context interface and export the *context, the iris.Context now points to the pointer\nSupport compression and rate limiting in the FileServer\nBit of code organisation Former-commit-id: ad1c61bf968059510c6be9e7f2cceec7da70ba17
51 lines
1.5 KiB
Go
51 lines
1.5 KiB
Go
package mvc
|
|
|
|
import (
|
|
"github.com/kataras/iris/v12/context"
|
|
"github.com/kataras/iris/v12/core/router"
|
|
"github.com/kataras/iris/v12/versioning"
|
|
)
|
|
|
|
// Version returns a valid `Option` that can be passed to the `Application.Handle` method.
|
|
// It requires a specific "version" constraint for a Controller,
|
|
// e.g. ">1, <=2" or just "1".
|
|
//
|
|
//
|
|
// Usage:
|
|
// m := mvc.New(dataRouter)
|
|
// m.Handle(new(v1Controller), mvc.Version("1"), mvc.Deprecated(mvc.DeprecationOptions{}))
|
|
// m.Handle(new(v2Controller), mvc.Version("2.3"))
|
|
// m.Handle(new(v3Controller), mvc.Version(">=3, <4"))
|
|
// m.Handle(new(noVersionController))
|
|
//
|
|
// See the `versioning` package's documentation for more information on
|
|
// how the version is extracted from incoming requests.
|
|
//
|
|
// Note that this Option will set the route register rule to `RouteOverlap`.
|
|
func Version(version string) OptionFunc {
|
|
return func(c *ControllerActivator) {
|
|
c.Router().SetRegisterRule(router.RouteOverlap) // required for this feature.
|
|
|
|
c.Use(func(ctx *context.Context) {
|
|
if !versioning.Match(ctx, version) {
|
|
ctx.StopExecution()
|
|
return
|
|
}
|
|
|
|
ctx.Next()
|
|
})
|
|
}
|
|
}
|
|
|
|
// Deprecated marks a specific Controller as a deprecated one.
|
|
// Deprecated can be used to tell the clients that
|
|
// a newer version of that specific resource is available instead.
|
|
func Deprecated(options DeprecationOptions) OptionFunc {
|
|
return func(c *ControllerActivator) {
|
|
c.Use(func(ctx *context.Context) {
|
|
versioning.WriteDeprecated(ctx, options)
|
|
ctx.Next()
|
|
})
|
|
}
|
|
}
|