Add two examples for folder structuring as requested at https://github.com/kataras/iris/issues/748

Former-commit-id: 27c97d005d9cbd2309587b11fc9e2bab85870502

_examples/README.md

@@ -14,7 +14,16 @@ It doesn't always contain the "best ways" but it does cover each important featu
 - [Tutorial: URL Shortener using BoltDB](https://medium.com/@kataras/a-url-shortener-service-using-go-iris-and-bolt-4182f0b00ae7)
 - [Tutorial: How to turn your Android Device into a fully featured Web Server (**MUST**)](https://twitter.com/ThePracticalDev/status/892022594031017988)
 
-### HTTP Listening 
+### Structuring
+
+Nothing stops you from using your favorite folder structure. Iris is a low level web framework, it has got MVC support but it doesn't limit your folder structure, this is your choice.
+
+Structuring is always depends on your needs. We can't tell you how to design your own application for sure but you're free to take a closer look to the examples below; you may find something useful that you can borrow for your app
+
+- [Example 1](mvc/login)
+- [Example 2](structuring/mvc)
+
+### HTTP Listening
 
 - [Common, with address](http-listening/listen-addr/main.go)
     * [omit server errors](http-listening/listen-addr/omit-server-errors/main.go)

_examples/structuring/mvc/app/app.go

@@ -0,0 +1,144 @@
+package app
+
+import (
+	"fmt"
+	"time"
+
+	"github.com/gorilla/securecookie"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/middleware/logger"
+	"github.com/kataras/iris/middleware/recover"
+	"github.com/kataras/iris/sessions"
+
+	"github.com/kataras/iris/_examples/structuring/mvc/app/controllers/follower"
+	"github.com/kataras/iris/_examples/structuring/mvc/app/controllers/following"
+	"github.com/kataras/iris/_examples/structuring/mvc/app/controllers/index"
+	"github.com/kataras/iris/_examples/structuring/mvc/app/controllers/like"
+)
+
+// Application is our application wrapper and bootstrapper, keeps our settings.
+type Application struct {
+	*iris.Application
+
+	Name      string
+	Owner     string
+	SpawnDate time.Time
+
+	Sessions *sessions.Sessions
+}
+
+// NewApplication returns a new named Application.
+func NewApplication(name, owner string) *Application {
+	return &Application{
+		Name:        name,
+		Owner:       owner,
+		Application: iris.New(),
+		SpawnDate:   time.Now(),
+	}
+}
+
+// begin sends the app's identification info.
+func (app *Application) begin(ctx iris.Context) {
+	// response headers
+	ctx.Header("App-Name", app.Name)
+	ctx.Header("App-Owner", app.Owner)
+	ctx.Header("App-Since", time.Since(app.SpawnDate).String())
+
+	ctx.Header("Server", "Iris: https://iris-go.com")
+
+	// view data if ctx.View or c.Tmpl = "$page.html" will be called next.
+	ctx.ViewData("AppName", app.Name)
+	ctx.ViewData("AppOwner", app.Owner)
+	ctx.Next()
+}
+
+// SetupViews loads the templates.
+func (app *Application) SetupViews(viewsDir string) {
+	app.RegisterView(iris.HTML(viewsDir, ".html").Layout("shared/layout.html"))
+}
+
+// SetupSessions initializes the sessions, optionally.
+func (app *Application) SetupSessions(expires time.Duration, cookieHashKey, cookieBlockKey []byte) {
+	app.Sessions = sessions.New(sessions.Config{
+		Cookie:   "SECRET_SESS_COOKIE_" + app.Name,
+		Expires:  expires,
+		Encoding: securecookie.New(cookieHashKey, cookieBlockKey),
+	})
+}
+
+// SetupErrorHandlers prepares the http error handlers (>=400).
+// Remember that error handlers in Iris have their own middleware ecosystem
+// so the route's middlewares are not running when an http error happened.
+// So if we want a logger we have to re-create one, here we will customize that logger as well.
+func (app *Application) SetupErrorHandlers() {
+	httpErrStatusLogger := logger.New(logger.Config{
+		Status:            true,
+		IP:                true,
+		Method:            true,
+		Path:              true,
+		MessageContextKey: "message",
+		LogFunc: func(now time.Time, latency time.Duration,
+			status, ip, method, path string,
+			message interface{}) {
+
+			line := fmt.Sprintf("%v %4v %s %s %s", status, latency, ip, method, path)
+
+			if message != nil {
+				line += fmt.Sprintf(" %v", message)
+			}
+			app.Logger().Warn(line)
+		},
+	})
+
+	app.OnAnyErrorCode(app.begin, httpErrStatusLogger, func(ctx iris.Context) {
+		err := iris.Map{
+			"app":     app.Name,
+			"status":  ctx.GetStatusCode(),
+			"message": ctx.Values().GetString("message"),
+		}
+
+		if jsonOutput, _ := ctx.URLParamBool("json"); jsonOutput {
+			ctx.JSON(err)
+			return
+		}
+
+		ctx.ViewData("Err", err)
+		ctx.ViewData("Title", "Error")
+		ctx.View("shared/error.html")
+	})
+}
+
+// SetupRouter registers the available routes from the "controllers" package.
+func (app *Application) SetupRouter() {
+	app.Use(recover.New())
+	app.Use(app.begin)
+	app.Use(iris.Gzip)
+
+	app.Favicon("./public/favicon.ico")
+	app.StaticWeb("/public", "./public")
+
+	app.Use(logger.New())
+
+	app.Controller("/", new(index.Controller))
+	app.Controller("/follower", new(follower.Controller))
+	app.Controller("/following", new(following.Controller))
+	app.Controller("/like", new(like.Controller))
+}
+
+// Instance is our global application bootstrap instance.
+var Instance = NewApplication("My Awesome App", "kataras2006@hotmail.com")
+
+// Boot starts our default instance appolication.
+func Boot(runner iris.Runner, configurators ...iris.Configurator) {
+	Instance.SetupViews("./app/views")
+	Instance.SetupSessions(24*time.Hour,
+		[]byte("the-big-and-secret-fash-key-here"),
+		[]byte("lot-secret-of-characters-big-too"),
+	)
+
+	Instance.SetupErrorHandlers()
+	Instance.SetupRouter()
+
+	Instance.Run(runner, configurators...)
+}

_examples/structuring/mvc/app/controllers/follower/controller.go

@@ -0,0 +1,13 @@
+package follower
+
+import (
+	"github.com/kataras/iris"
+)
+
+type Controller struct {
+	iris.Controller
+}
+
+func (c *Controller) GetBy(id int64) {
+	c.Ctx.Writef("from "+c.Route().Path()+" with ID: %d", id)
+}

_examples/structuring/mvc/app/controllers/following/controller.go

@@ -0,0 +1,13 @@
+package following
+
+import (
+	"github.com/kataras/iris"
+)
+
+type Controller struct {
+	iris.Controller
+}
+
+func (c *Controller) GetBy(id int64) {
+	c.Ctx.Writef("from "+c.Route().Path()+" with ID: %d", id)
+}

_examples/structuring/mvc/app/controllers/index/controller.go

@@ -0,0 +1,14 @@
+package index
+
+import (
+	"github.com/kataras/iris"
+)
+
+type Controller struct {
+	iris.Controller
+}
+
+func (c *Controller) Get() {
+	c.Data["Title"] = "Index"
+	c.Tmpl = "index.html"
+}

_examples/structuring/mvc/app/controllers/like/controller.go

@@ -0,0 +1,13 @@
+package like
+
+import (
+	"github.com/kataras/iris"
+)
+
+type Controller struct {
+	iris.Controller
+}
+
+func (c *Controller) GetBy(id int64) {
+	c.Ctx.Writef("from "+c.Route().Path()+" with ID: %d", id)
+}

_examples/structuring/mvc/app/views/index.html

@@ -0,0 +1 @@
+<h1>Welcome!!</h1>

_examples/structuring/mvc/app/views/shared/error.html

@@ -0,0 +1,5 @@
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+<h3>{{.Err.status}}</h3>
+<h4>{{.Err.message}}</h4>

_examples/structuring/mvc/app/views/shared/layout.html

@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
+    <title>{{.Title}} - {{.AppName}}</title>
+
+</head>
+
+<body>
+    <div>
+        <!-- Render the current template here -->
+        {{ yield }}
+        <hr />
+        <footer>
+            <p>&copy; 2017 - {{.AppOwner}}</p>
+        </footer>
+    </div>
+</body>
+
+</html>

_examples/structuring/mvc/main.go

@@ -0,0 +1,15 @@
+package main
+
+import (
+	"github.com/kataras/iris"
+
+	"github.com/kataras/iris/_examples/structuring/mvc/app"
+)
+
+func main() {
+	// http://localhost:8080
+	// http://localhost:8080/follower/42
+	// http://localhost:8080/following/42
+	// http://localhost:8080/like/42
+	app.Boot(iris.Addr(":8080"), iris.WithoutServerError(iris.ErrServerClosed), iris.WithoutVersionChecker)
+}