Enhance the view engine's example for {{url ...}} and {{urlpath ...}} tmpl funcs for reverse routing.

Former-commit-id: ec3cda69e5cbe5a04842150011b3788b70055572

adaptors/view/_examples/template_html_3/main.go

@@ -4,25 +4,79 @@ package main
 import (
 	"gopkg.in/kataras/iris.v6"
 	"gopkg.in/kataras/iris.v6/adaptors/gorillamux"
+	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
 	"gopkg.in/kataras/iris.v6/adaptors/view"
 )
 
 func main() {
 	app := iris.New()
 	app.Adapt(iris.DevLogger())
-	app.Adapt(gorillamux.New())
+	app.Adapt(view.HTML("./templates", ".html").Reload(true))
 
-	app.Adapt(view.HTML("./templates", ".html"))
+	startWithHTTPRouter(app)
+	// or uncomment
+	// startWithGorillamux()
 
-	app.Get("/mypath", emptyHandler).ChangeName("my-page1")
-	app.Get("/mypath2/{param1}/{param2}", emptyHandler).ChangeName("my-page2")
-	app.Get("/mypath3/{param1}/statichere/{param2}", emptyHandler).ChangeName("my-page3")
-	app.Get("/mypath4/{param1}/statichere/{param2}/{otherparam}/{something:.*}", emptyHandler).ChangeName("my-page4")
+	app.Listen("localhost:8080")
+
+}
+
+func writePathHandler(ctx *iris.Context) {
+	ctx.Writef("Hello from %s.", ctx.Path())
+}
+
+func startWithHTTPRouter(app *iris.Framework) {
+
+	app.Adapt(httprouter.New())
+
+	app.Get("/mypath", writePathHandler).ChangeName("my-page1")
+	app.Get("/mypath2/:param1/:param2", writePathHandler).ChangeName("my-page2")
+	app.Get("/mypath3/:param1/statichere/:param2", writePathHandler).ChangeName("my-page3")
+	app.Get("/mypath4/:param1/statichere/:param2/:otherparam/*something", writePathHandler).ChangeName("my-page4")
 
 	// same with Handle/Func
-	app.HandleFunc("GET", "/mypath5/{param1}/statichere/{param2}/{otherparam}/anything/{something:.*}", emptyHandler).ChangeName("my-page5")
+	app.HandleFunc("GET", "/mypath5/:param1/statichere/:param2/:otherparam/anything/*something", writePathHandler).ChangeName("my-page5")
 
-	app.Get("/mypath6/{param1}/{param2}/staticParam/{param3AfterStatic}", emptyHandler).ChangeName("my-page6")
+	app.Get("/mypath6/:param1/:param2/staticParam/:param3AfterStatic", writePathHandler).ChangeName("my-page6")
+
+	app.Get("/", func(ctx *iris.Context) {
+		// for /mypath6...
+		paramsAsArray := []string{"param1", "theParam1",
+			"param2", "theParam2",
+			"param3AfterStatic", "theParam3"}
+
+		if err := ctx.Render("page.html", iris.Map{"ParamsAsArray": paramsAsArray}); err != nil {
+			panic(err)
+		}
+	})
+
+	app.Get("/redirect/:namedRoute", func(ctx *iris.Context) {
+		routeName := ctx.Param("namedRoute")
+
+		println("The full uri of " + routeName + "is: " + app.URL(routeName))
+		// if routeName == "my-page1"
+		// prints: The full uri of my-page1 is: http://127.0.0.1:8080/mypath
+		ctx.RedirectTo(routeName)
+		// http://127.0.0.1:8080/redirect/my-page1 will redirect to -> http://127.0.0.1:8080/mypath
+	})
+
+}
+
+// for gorillamux adaptor is the same thing, the path syntax is the only thing changed ofc.
+// Note: Here, we could use app.RouteParam("param1") without even care what router is being used,
+//       but I have two examples of the same thing in order to be more understable for you.
+func startWithGorillamux(app *iris.Framework) {
+	app.Adapt(gorillamux.New())
+
+	app.Get("/mypath", writePathHandler).ChangeName("my-page1")
+	app.Get("/mypath2/{param1}/{param2}", writePathHandler).ChangeName("my-page2")
+	app.Get("/mypath3/{param1}/statichere/{param2}", writePathHandler).ChangeName("my-page3")
+	app.Get("/mypath4/{param1}/statichere/{param2}/{otherparam}/{something:.*}", writePathHandler).ChangeName("my-page4")
+
+	// same with Handle/Func
+	app.HandleFunc("GET", "/mypath5/{param1}/statichere/{param2}/{otherparam}/anything/{something:.*}", writePathHandler).ChangeName("my-page5")
+
+	app.Get("/mypath6/{param1}/{param2}/staticParam/{param3AfterStatic}", writePathHandler).ChangeName("my-page6")
 
 	app.Get("/", func(ctx *iris.Context) {
 		// for /mypath6...
@@ -47,7 +101,3 @@ func main() {
 
 	app.Listen("localhost:8080")
 }
-
-func emptyHandler(ctx *iris.Context) {
-	ctx.Writef("Hello from %s.", ctx.Path())
-}

adaptors/view/_examples/template_html_3/templates/page.html

@@ -3,6 +3,8 @@
 <br />
 
 <a href="{{url "my-page2" "param1" "theParam1" "param2" "theParam2"}}">http://localhost:8080/mypath2/:param1/:param2</a>
+or path only:
+<a href="{{urlpath "my-page2" "param1" "theParam1" "param2" "theParam2"}}">/mypath2/:param1/:param2</a>
 
 <br />
 <br />

adaptors/view/_examples/template_html_4/templates/page.html

@@ -4,13 +4,13 @@ is the subdomain part instead of named parameter-->
 <a href="{{url "dynamic-subdomain1" "username1"}}">username1.127.0.0.1:8080/mypath</a>
 <br />
 <br />
-<a href="{{url "dynamic-subdomain2" "username2" "theParam1" "theParam2"}}">username2.127.0.0.1:8080/mypath2/:param1/:param2</a>
+<a href="{{url "dynamic-subdomain2" "username2" "theParam1" "theParam2"}}">username2.127.0.0.1:8080/mypath2/{param1}/{param2}</a>
 <br />
 <br />
-<a href="{{url "dynamic-subdomain3" "username3" "theParam1" "theParam2AfterStatic"}}">username3.127.0.0.1:8080/mypath3/:param1/statichere/:param2</a>
+<a href="{{url "dynamic-subdomain3" "username3" "theParam1" "theParam2AfterStatic"}}">username3.127.0.0.1:8080/mypath3/{param1}/statichere/{param2}</a>
 <br />
 <br />
-<a href="{{url "dynamic-subdomain4" "username4" "theParam1" "theparam2AfterStatic" "otherParam" "matchAnything"}}">username4.127.0.0.1:8080/mypath4/:param1/statichere/:param2/:otherparam/*something</a>
+<a href="{{url "dynamic-subdomain4" "username4" "theParam1" "theparam2AfterStatic" "otherParam" "matchAnything"}}">username4.127.0.0.1:8080/mypath4/{param1}/statichere/{param2}/{otherParam}/{something:.*}</a>
 <br />
 <br />
-<a href="{{url "dynamic-subdomain5" .ParamsAsArray }}" >username5.127.0.0.1:8080/mypath6/:param1/:param2/staticParam/:param3AfterStatic</a>
+<a href="{{url "dynamic-subdomain5" .ParamsAsArray }}" >username5.127.0.0.1:8080/mypath6/{param1}/{param2}/staticParam/{param3}AfterStatic</a>