Add (10) more _examples. TOC: https://github.com/kataras/iris/tree/v6/_examples

Part 3.


Former-commit-id: 229b86baca4043c69517968318d9a962d2e026d0

_examples/advanced/subdomains/multi/hosts

@@ -0,0 +1,28 @@
+# Copyright (c) 1993-2009 Microsoft Corp.
+#
+# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
+#
+# This file contains the mappings of IP addresses to host names. Each
+# entry should be kept on an individual line. The IP address should
+# be placed in the first column followed by the corresponding host name.
+# The IP address and the host name should be separated by at least one
+# space.
+#
+# Additionally, comments (such as these) may be inserted on individual
+# lines or following the machine name denoted by a '#' symbol.
+#
+# For example:
+#
+#      102.54.94.97     rhino.acme.com          # source server
+#       38.25.63.10     x.acme.com              # x client host
+
+# localhost name resolution is handled within DNS itself.
+127.0.0.1       localhost
+::1             localhost
+#-IRIS-For development machine, you have to configure your dns also for online, search google how to do it if you don't know
+
+127.0.0.1 domain.local
+127.0.0.1 system.domain.local
+127.0.0.1 dashboard.domain.local
+
+#-END IRIS-

_examples/advanced/subdomains/multi/main.go

@@ -0,0 +1,39 @@
+package main
+
+import (
+	"gopkg.in/kataras/iris.v6"
+	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
+)
+
+func main() {
+	app := iris.New()
+	app.Adapt(iris.DevLogger())
+	// subdomains works with all available routers, like other features too.
+	app.Adapt(httprouter.New())
+
+	/*
+	 * Setup static files
+	 */
+
+	app.StaticWeb("/assets", "./public/assets")
+	app.StaticWeb("/upload_resources", "./public/upload_resources")
+
+	dashboard := app.Party("dashboard.")
+	{
+		dashboard.Get("/", func(ctx *iris.Context) {
+			ctx.Writef("HEY FROM dashboard")
+		})
+	}
+	system := app.Party("system.")
+	{
+		system.Get("/", func(ctx *iris.Context) {
+			ctx.Writef("HEY FROM system")
+		})
+	}
+
+	app.Get("/", func(ctx *iris.Context) {
+		ctx.Writef("HEY FROM frontend /")
+	})
+	/* test this on firefox, because the domain is not real (because of .local), on firefox this will fail, but you can test it with other domain */
+	app.Listen("domain.local:80") // for beginners: look ../hosts file
+}

_examples/advanced/subdomains/single/hosts

@@ -0,0 +1,27 @@
+# Copyright (c) 1993-2009 Microsoft Corp.
+#
+# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
+#
+# This file contains the mappings of IP addresses to host names. Each
+# entry should be kept on an individual line. The IP address should
+# be placed in the first column followed by the corresponding host name.
+# The IP address and the host name should be separated by at least one
+# space.
+#
+# Additionally, comments (such as these) may be inserted on individual
+# lines or following the machine name denoted by a '#' symbol.
+#
+# For example:
+#
+#      102.54.94.97     rhino.acme.com          # source server
+#       38.25.63.10     x.acme.com              # x client host
+
+# localhost name resolution is handled within DNS itself.
+127.0.0.1       localhost
+::1             localhost
+#-IRIS-For development machine, you have to configure your dns also for online, search google how to do it if you don't know
+
+127.0.0.1		mydomain.com
+127.0.0.1		admin.mydomain.com
+
+#-END IRIS-

_examples/advanced/subdomains/single/main.go

@@ -0,0 +1,43 @@
+// Package main register static subdomains, simple as parties, check ./hosts if you use windows
+package main
+
+import (
+	"gopkg.in/kataras/iris.v6"
+	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
+)
+
+func main() {
+	app := iris.New()
+	app.Adapt(iris.DevLogger())
+	// subdomains works with all available routers, like other features too.
+	app.Adapt(httprouter.New())
+
+	// no order, you can register subdomains at the end also.
+	admin := app.Party("admin.")
+	{
+		// admin.mydomain.com
+		admin.Get("/", func(c *iris.Context) {
+			c.Writef("INDEX FROM admin.mydomain.com")
+		})
+		// admin.mydomain.com/hey
+		admin.Get("/hey", func(c *iris.Context) {
+			c.Writef("HEY FROM admin.mydomain.com/hey")
+		})
+		// admin.mydomain.com/hey2
+		admin.Get("/hey2", func(c *iris.Context) {
+			c.Writef("HEY SECOND FROM admin.mydomain.com/hey")
+		})
+	}
+
+	// mydomain.com/
+	app.Get("/", func(c *iris.Context) {
+		c.Writef("INDEX FROM no-subdomain hey")
+	})
+
+	// mydomain.com/hey
+	app.Get("/hey", func(c *iris.Context) {
+		c.Writef("HEY FROM no-subdomain hey")
+	})
+
+	app.Listen("mydomain.com:80") // for beginners: look ../hosts file
+}

_examples/advanced/subdomains/wildcard/hosts

@@ -0,0 +1,30 @@
+# Copyright (c) 1993-2009 Microsoft Corp.
+#
+# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
+#
+# This file contains the mappings of IP addresses to host names. Each
+# entry should be kept on an individual line. The IP address should
+# be placed in the first column followed by the corresponding host name.
+# The IP address and the host name should be separated by at least one
+# space.
+#
+# Additionally, comments (such as these) may be inserted on individual
+# lines or following the machine name denoted by a '#' symbol.
+#
+# For example:
+#
+#      102.54.94.97     rhino.acme.com          # source server
+#       38.25.63.10     x.acme.com              # x client host
+
+# localhost name resolution is handled within DNS itself.
+127.0.0.1       localhost
+::1             localhost
+#-IRIS-For development machine, you have to configure your dns also for online, search google how to do it if you don't know
+127.0.0.1		mydomain.com
+127.0.0.1		username1.mydomain.com
+127.0.0.1		username2.mydomain.com
+127.0.0.1		username3.mydomain.com
+127.0.0.1		username4.mydomain.com
+127.0.0.1		username5.mydomain.com
+
+#-END IRIS-

_examples/advanced/subdomains/wildcard/main.go

@@ -0,0 +1,71 @@
+// Package main an example on how to catch dynamic subdomains - wildcard.
+// On the first example (subdomains_1) we saw how to create routes for static subdomains, subdomains you know that you will have.
+// Here we will see an example how to catch unknown subdomains, dynamic subdomains, like username.mydomain.com:8080.
+package main
+
+import (
+	"gopkg.in/kataras/iris.v6"
+	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
+)
+
+// register a dynamic-wildcard subdomain to your server machine(dns/...) first, check ./hosts if you use windows.
+// run this file and try to redirect: http://username1.mydomain.com:8080/ , http://username2.mydomain.com:8080/ , http://username1.mydomain.com/something, http://username1.mydomain.com/something/sadsadsa
+
+func main() {
+	app := iris.New()
+	app.Adapt(iris.DevLogger())
+	// subdomains works with all available routers, like other features too.
+	app.Adapt(httprouter.New())
+
+	/* Keep note that you can use both type of subdomains (named and wildcard(*.) )
+	   admin.mydomain.com,  and for other the Party(*.) but this is not this example's purpose
+
+	admin := app.Party("admin.")
+	{
+		// admin.mydomain.com
+		admin.Get("/", func(ctx *iris.Context) {
+			ctx.Writef("INDEX FROM admin.mydomain.com")
+		})
+		// admin.mydomain.com/hey
+		admin.Get("/hey", func(ctx *iris.Context) {
+			ctx.Writef("HEY FROM admin.mydomain.com/hey")
+		})
+		// admin.mydomain.com/hey2
+		admin.Get("/hey2", func(ctx *iris.Context) {
+			ctx.Writef("HEY SECOND FROM admin.mydomain.com/hey")
+		})
+	}*/
+
+	// no order, you can register subdomains at the end also.
+	dynamicSubdomains := app.Party("*.")
+	{
+		dynamicSubdomains.Get("/", dynamicSubdomainHandler)
+
+		dynamicSubdomains.Get("/something", dynamicSubdomainHandler)
+
+		dynamicSubdomains.Get("/something/:param1", dynamicSubdomainHandlerWithParam)
+	}
+
+	app.Get("/", func(ctx *iris.Context) {
+		ctx.Writef("Hello from mydomain.com path: %s", ctx.Path())
+	})
+
+	app.Get("/hello", func(ctx *iris.Context) {
+		ctx.Writef("Hello from mydomain.com path: %s", ctx.Path())
+	})
+
+	app.Listen("mydomain.com:8080") // for beginners: look ../hosts file
+}
+
+func dynamicSubdomainHandler(ctx *iris.Context) {
+	username := ctx.Subdomain()
+	ctx.Writef("Hello from dynamic subdomain path: %s, here you can handle the route for dynamic subdomains, handle the user: %s", ctx.Path(), username)
+	// if  http://username4.mydomain.com:8080/ prints:
+	// Hello from dynamic subdomain path: /, here you can handle the route for dynamic subdomains, handle the user: username4
+}
+
+func dynamicSubdomainHandlerWithParam(ctx *iris.Context) {
+	username := ctx.Subdomain()
+	ctx.Writef("Hello from dynamic subdomain path: %s, here you can handle the route for dynamic subdomains, handle the user: %s", ctx.Path(), username)
+	ctx.Writef("THE PARAM1 is: %s", ctx.Param("param1"))
+}

_examples/advanced/transactions/main.go

@@ -0,0 +1,56 @@
+package main
+
+import (
+	"gopkg.in/kataras/iris.v6"
+	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
+)
+
+func main() {
+	app := iris.New()
+	app.Adapt(iris.DevLogger())
+	// subdomains works with all available routers, like other features too.
+	app.Adapt(httprouter.New())
+
+	app.Get("/", func(ctx *iris.Context) {
+		ctx.BeginTransaction(func(t *iris.Transaction) {
+			// OPTIONAl STEP: , if true then the next transictions will not be executed if this transiction fails
+			// t.SetScope(iris.RequestTransactionScope)
+
+			// OPTIONAL STEP:
+			// create a new custom type of error here to keep track of the status code and reason message
+			err := iris.NewTransactionErrResult()
+
+			// we should use t.Context if we want to rollback on any errors lives inside this function clojure.
+			t.Context.Text(iris.StatusOK, "Blablabla this should not be sent to the client because we will fill the err with a message and status")
+
+			// virtualize a fake error here, for the shake of the example
+			fail := true
+			if fail {
+				err.StatusCode = iris.StatusInternalServerError
+				// NOTE: if empty reason then the default or the custom http error will be fired (like ctx.EmitError)
+				err.Reason = "Error: Virtual failure!!"
+			}
+
+			// OPTIONAl STEP:
+			// but useful if we want to post back an error message to the client if the transaction failed.
+			// if the reason is empty then the transaction completed succesfuly,
+			// otherwise we rollback the whole response writer's body,
+			// headers and cookies, status code and everything lives inside this transaction
+			t.Complete(err)
+		})
+
+		ctx.BeginTransaction(func(t *iris.Transaction) {
+			t.Context.HTML(iris.StatusOK,
+				"<h1>This will sent at all cases because it lives on different transaction and it doesn't fails</h1>")
+			// * if we don't have any 'throw error' logic then no need of scope.Complete()
+		})
+
+		// OPTIONAL, depends on the usage:
+		// at any case, what ever happens inside the context's transactions send this to the client
+		ctx.HTML(iris.StatusOK, "<h1>Let's add a second html message to the response, "+
+			"if the transaction was failed and it was request scoped then this message would "+
+			"not been shown. But it has a transient scope(default) so, it is visible as expected!</h1>")
+	})
+
+	app.Listen(":8080")
+}