Update to version 12.1.7

Former-commit-id: 3e214ab6b6da4d1c6e4a66180a4ccfa61c0879ae

_examples/routing/route-register-rule/main.go

@@ -0,0 +1,41 @@
+package main
+
+import "github.com/kataras/iris/v12"
+
+func main() {
+	app := newApp()
+	// Navigate through https://github.com/kataras/iris/issues/1448 for details.
+	//
+	// GET: http://localhost:8080
+	// POST, PUT, DELETE, CONNECT, HEAD, PATCH, OPTIONS, TRACE : http://localhost:8080
+	app.Listen(":8080")
+}
+
+func newApp() *iris.Application {
+	app := iris.New()
+	// Skip and do NOT override existing regitered route, continue normally.
+	// Applies to a Party and its children, in this case the whole application's routes.
+	app.SetRegisterRule(iris.RouteSkip)
+
+	/* Read also:
+	// The default behavior, will override the getHandler to anyHandler on `app.Any` call.
+	app.SetRegistRule(iris.RouteOverride)
+
+	// Stops the execution and fires an error before server boot.
+	app.SetRegisterRule(iris.RouteError)
+	*/
+
+	app.Get("/", getHandler)
+	// app.Any does NOT override the previous GET route because of `iris.RouteSkip` rule.
+	app.Any("/", anyHandler)
+
+	return app
+}
+
+func getHandler(ctx iris.Context) {
+	ctx.Writef("From %s", ctx.GetCurrentRoute().Trace())
+}
+
+func anyHandler(ctx iris.Context) {
+	ctx.Writef("From %s", ctx.GetCurrentRoute().Trace())
+}