mirror of
https://github.com/kataras/iris.git
synced 2025-02-02 15:30:36 +01:00
README: add 'run in the browser' button
after the quick start details, so it is visible always Former-commit-id: 0c13135a01c2b883aa4a9629a507aaf622d22ade
This commit is contained in:
Gerasimos (Makis) Maropoulos
parent
9922265454
commit
3fa022738b
2
FAQ.md
2
FAQ.md
|
|
@ -55,4 +55,4 @@ Yes, https://chat.iris-go.com
|
||||||
|
|
||||||
By people like you, who help us by donating small or large amounts of money.
|
By people like you, who help us by donating small or large amounts of money.
|
||||||
|
|
||||||
Help this project deliver awesome and unique features with the highest possible code quality by donating any amount via [PayPal](https://www.paypal.me/kataras). Your name will be published [here](https://iris-go.com) after your approval via e-mail.
|
Help this project deliver awesome and unique features with the highest possible code quality by donating any amount via [PayPal](https://iris-go.com/donate). Your name will be published [here](https://iris-go.com) after your approval via e-mail.
|
||||||
|
|
|
||||||
25
README.md
25
README.md
|
|
@ -10,7 +10,7 @@
|
||||||
|
|
||||||
# Iris Web Framework <a href="README_GR.md"><img width="20px" src="https://iris-go.com/images/flag-greece.svg" /></a> <a href="README_FR.md"><img width="20px" src="https://iris-go.com/images/flag-france.svg" /></a> <a href="README_ZH.md"><img width="20px" src="https://iris-go.com/images/flag-china.svg" /></a> <a href="README_ES.md"><img width="20px" src="https://iris-go.com/images/flag-spain.png" /></a> <a href="README_FA.md"><img width="20px" src="https://iris-go.com/images/flag-iran.svg" /></a> <a href="README_RU.md"><img width="20px" src="https://iris-go.com/images/flag-russia.svg" /></a> <a href="README_KO.md"><img width="20px" src="https://iris-go.com/images/flag-south-korea.svg?v=12" /></a>
|
# Iris Web Framework <a href="README_GR.md"><img width="20px" src="https://iris-go.com/images/flag-greece.svg" /></a> <a href="README_FR.md"><img width="20px" src="https://iris-go.com/images/flag-france.svg" /></a> <a href="README_ZH.md"><img width="20px" src="https://iris-go.com/images/flag-china.svg" /></a> <a href="README_ES.md"><img width="20px" src="https://iris-go.com/images/flag-spain.png" /></a> <a href="README_FA.md"><img width="20px" src="https://iris-go.com/images/flag-iran.svg" /></a> <a href="README_RU.md"><img width="20px" src="https://iris-go.com/images/flag-russia.svg" /></a> <a href="README_KO.md"><img width="20px" src="https://iris-go.com/images/flag-south-korea.svg?v=12" /></a>
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community) <!--[](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)--> [](https://www.paypal.me/kataras) <!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> <!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community) <!--[](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)--> [](https://iris-go.com/donate) <!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> <!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
<a href="https://iris-go.com"> <img align="right" src="https://iris-go.com/images/logo-w169.png"></a>
|
<a href="https://iris-go.com"> <img align="right" src="https://iris-go.com/images/logo-w169.png"></a>
|
||||||
|
|
||||||
|
|
@ -32,8 +32,8 @@ Learn what [others saying about Iris](https://iris-go.com/testimonials/) and **[
|
||||||
```sh
|
```sh
|
||||||
# https://github.com/kataras/iris/wiki/Installation
|
# https://github.com/kataras/iris/wiki/Installation
|
||||||
$ go get github.com/kataras/iris/v12@master
|
$ go get github.com/kataras/iris/v12@master
|
||||||
# assume the following code in example.go file
|
# assume the following code in main.go file
|
||||||
$ cat example.go
|
$ cat main.go
|
||||||
```
|
```
|
||||||
|
|
||||||
```go
|
```go
|
||||||
|
|
@ -43,26 +43,23 @@ import "github.com/kataras/iris/v12"
|
||||||
|
|
||||||
func main() {
|
func main() {
|
||||||
app := iris.New()
|
app := iris.New()
|
||||||
app.Get("/ping", func(ctx iris.Context) {
|
app.Get("/", index)
|
||||||
ctx.JSON(iris.Map{
|
|
||||||
"message": "pong",
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
app.Listen(":8080")
|
app.Listen(":8080")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func index(ctx iris.Context) {
|
||||||
|
ctx.HTML("<h1>Hello, World!</h1>")
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# run example.go and
|
$ go run main.go
|
||||||
# visit http://localhost:8080/ping on browser
|
|
||||||
$ go run example.go
|
|
||||||
```
|
```
|
||||||
|
|
||||||
> Routing is powered by [muxie](https://github.com/kataras/muxie), the most powerful and fastest trie-based software written in Go.
|
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
[](https://repl.it/@kataras/Iris-Hello-World)
|
||||||
|
|
||||||
Iris contains extensive and thorough **[wiki](https://github.com/kataras/iris/wiki)** making it easy to get started with the framework.
|
Iris contains extensive and thorough **[wiki](https://github.com/kataras/iris/wiki)** making it easy to get started with the framework.
|
||||||
|
|
||||||
<!--  -->
|
<!--  -->
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
Iris es un framework web rápido, simple pero con muchas funcionalidades y muy eficiente para Go. Proporciona una base bellamente expresiva y fácil de usar para su próximo sitio web o API.
|
Iris es un framework web rápido, simple pero con muchas funcionalidades y muy eficiente para Go. Proporciona una base bellamente expresiva y fácil de usar para su próximo sitio web o API.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
<div dir="ltr" align='left' >
|
<div dir="ltr" align='left' >
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
<a href="https://iris-go.com"> <img align="right" src="https://iris-go.com/images/logo-w169.png"></a>
|
<a href="https://iris-go.com"> <img align="right" src="https://iris-go.com/images/logo-w169.png"></a>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
Το Iris είναι ένα γρήγορο, απλό αλλά και πλήρως λειτουργικό και πολύ αποδοτικό web framework για τη Go γλώσσα προγραμματισμού. Παρέχει ένα εκφραστικό και εύχρηστο υπόβαθρο για την επόμενη ιστοσελίδα σας.
|
Το Iris είναι ένα γρήγορο, απλό αλλά και πλήρως λειτουργικό και πολύ αποδοτικό web framework για τη Go γλώσσα προγραμματισμού. Παρέχει ένα εκφραστικό και εύχρηστο υπόβαθρο για την επόμενη ιστοσελίδα σας.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
Iris는 단순하고 빠르며 좋은 성능과 모든 기능을 갖춘 Go언어용 웹 프레임워크입니다. 당신의 웹사이트나 API를 위해서 아름답고 사용하기 쉬운 기반을 제공합니다.
|
Iris는 단순하고 빠르며 좋은 성능과 모든 기능을 갖춘 Go언어용 웹 프레임워크입니다. 당신의 웹사이트나 API를 위해서 아름답고 사용하기 쉬운 기반을 제공합니다.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
Iris — это быстрый, простой, но полнофункциональный и эффективный веб-фреймворк для Go. Он обеспечивает красивую, выразительную и простую в использовании основу для вашего следующего веб-сайта или API.
|
Iris — это быстрый, простой, но полнофункциональный и эффективный веб-фреймворк для Go. Он обеспечивает красивую, выразительную и простую в использовании основу для вашего следующего веб-сайта или API.
|
||||||
|
|
||||||
Узнайте, что [говорят другие люди об Iris](https://iris-go.com/testimonials/) и поставьте **[звёздочку](https://github.com/kataras/iris/stargazers)** этому проекту с открытым исходным кодом, чтобы поддержать его потенциал.
|
Узнайте, что [говорят другие люди об Iris](https://iris-go.com/testimonials/) и поставьте **[звёздочку](https://github.com/kataras/iris/stargazers)** этому проекту с открытым исходным кодом, чтобы поддержать его потенциал.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Iris Web Framework
|
# Iris Web Framework
|
||||||
|
|
||||||
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://www.paypal.me/kataras)--><!-- [](https://github.com/kataras/iris/releases) -->
|
[](https://travis-ci.org/kataras/iris) [](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)<!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community)<!--[](https://iris-go.com/donate)--><!-- [](https://github.com/kataras/iris/releases) -->
|
||||||
|
|
||||||
Iris 是基于 Go 编写的一个快速，简单但功能齐全且非常高效的 Web 框架。 它为您的下一个网站或 API 提供了一个非常富有表现力且易于使用的基础。
|
Iris 是基于 Go 编写的一个快速，简单但功能齐全且非常高效的 Web 框架。 它为您的下一个网站或 API 提供了一个非常富有表现力且易于使用的基础。
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,95 @@
|
||||||
|
package main
|
||||||
|
|
||||||
|
import "github.com/kataras/iris/v12"
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
app := iris.New()
|
||||||
|
app.Use(RoleMiddleware)
|
||||||
|
|
||||||
|
app.Get("/", commonHandler)
|
||||||
|
c := app.ConfigureContainer()
|
||||||
|
/*
|
||||||
|
When you do NOT have access to the middleware code itself
|
||||||
|
then you can register a request dependency
|
||||||
|
which retrieves the value from the Context
|
||||||
|
and returns it, so handler/function's input arguments
|
||||||
|
with that `Role` type can be binded.
|
||||||
|
|
||||||
|
c.RegisterDependency(func(ctx iris.Context) Role {
|
||||||
|
role, ok := GetRole(ctx)
|
||||||
|
if !ok {
|
||||||
|
// This codeblock will never be executed here
|
||||||
|
// but you can stop executing a handler which depends on
|
||||||
|
// that dependency with `ctx.StopExecution/ctx.StopWithXXX` methods
|
||||||
|
// or by returning a second output argument of `error` type.
|
||||||
|
ctx.StopExecution()
|
||||||
|
return Role{}
|
||||||
|
}
|
||||||
|
|
||||||
|
return role
|
||||||
|
})
|
||||||
|
*/
|
||||||
|
c.Get("/dep", handlerWithDependencies)
|
||||||
|
|
||||||
|
// http://localhost:8080?name=kataras
|
||||||
|
// http://localhost:8080/dep?name=kataras
|
||||||
|
app.Listen(":8080")
|
||||||
|
}
|
||||||
|
|
||||||
|
func commonHandler(ctx iris.Context) {
|
||||||
|
role, _ := GetRole(ctx)
|
||||||
|
ctx.WriteString(role.Name)
|
||||||
|
}
|
||||||
|
|
||||||
|
func handlerWithDependencies(role Role) string {
|
||||||
|
return role.Name
|
||||||
|
}
|
||||||
|
|
||||||
|
// Code for an example middleware.
|
||||||
|
|
||||||
|
// Role struct value example.
|
||||||
|
type Role struct {
|
||||||
|
Name string
|
||||||
|
}
|
||||||
|
|
||||||
|
const roleContextKey = "myapp.role"
|
||||||
|
|
||||||
|
// RoleMiddleware example of a custom middleware.
|
||||||
|
func RoleMiddleware(ctx iris.Context) {
|
||||||
|
// [do it yourself: extract the role from the request...]
|
||||||
|
if ctx.URLParam("name") != "kataras" {
|
||||||
|
ctx.StopWithStatus(iris.StatusUnauthorized)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
//
|
||||||
|
|
||||||
|
role := Role{Name: "admin"}
|
||||||
|
|
||||||
|
ctx.Values().Set(roleContextKey, role)
|
||||||
|
|
||||||
|
// When you have access to the middleware itself:
|
||||||
|
// Use the `RegisterDependency` to register
|
||||||
|
// struct type values as dependencies at request-time for
|
||||||
|
// any potential dependency injection-ed user handler.
|
||||||
|
// This way the user of your middleware can get rid of
|
||||||
|
// manually register a dependency for that `Role` type with calls of
|
||||||
|
// `APIContainer.RegisterDependency` (and `mvc.Application.Register`).
|
||||||
|
ctx.RegisterDependency(role)
|
||||||
|
|
||||||
|
ctx.Next()
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetRole returns the role inside the context values,
|
||||||
|
// the `roleMiddleware` should be executed first.
|
||||||
|
func GetRole(ctx iris.Context) (Role, bool) {
|
||||||
|
v := ctx.Values().Get(roleContextKey)
|
||||||
|
if v != nil {
|
||||||
|
if role, ok := v.(Role); ok {
|
||||||
|
return role, true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return Role{}, false
|
||||||
|
}
|
||||||
|
|
||||||
|
// End Code of our example middleware.
|
||||||
|
|
@ -92,9 +92,7 @@ Create a `database/database.go` file and copy-paste the following:
|
||||||
```go
|
```go
|
||||||
package database
|
package database
|
||||||
|
|
||||||
import (
|
import "app/environment"
|
||||||
"app/environment"
|
|
||||||
)
|
|
||||||
|
|
||||||
type DB interface {
|
type DB interface {
|
||||||
Exec(q string) error
|
Exec(q string) error
|
||||||
|
|
@ -260,7 +258,7 @@ func (c *GreetController) Get(req model.Request) (model.Response, error) {
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
The `GreetController` depends on the `GreetService`. It serves the `GET: /greet` index path through its `Get` method. The `Get` method expecting a `model.Request` which contains a single field name of `Name` which will be extracted from the `URL Query Parameter 'name'` (because it's a `GET` requst and its `url:"name"` struct field).
|
The `GreetController` depends on the `GreetService`. It serves the `GET: /greet` index path through its `Get` method. The `Get` method accepts a `model.Request` which contains a single field name of `Name` which will be extracted from the `URL Query Parameter 'name'` (because it's a `GET` requst and its `url:"name"` struct field).
|
||||||
|
|
||||||
## Wrap up
|
## Wrap up
|
||||||
|
|
||||||
|
|
@ -364,14 +362,17 @@ Install [Go](https://golang.org/dl) and run the application with:
|
||||||
go run main.go
|
go run main.go
|
||||||
```
|
```
|
||||||
|
|
||||||
### Docker
|
<details><summary>Docker</summary>
|
||||||
|
|
||||||
|
Download the [Dockerfile](https://raw.githubusercontent.com/kataras/iris/9b93c0dbb491dcedf49c91e89ca13bab884d116f/_examples/mvc/overview/Dockerfile) and [docker-compose.yml](https://raw.githubusercontent.com/kataras/iris/9b93c0dbb491dcedf49c91e89ca13bab884d116f/_examples/mvc/overview/docker-compose.yml) files to the `app` folder.
|
||||||
|
|
||||||
Install [Docker](https://www.docker.com/) and execute the following command:
|
Install [Docker](https://www.docker.com/) and execute the following command:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ docker-compose up
|
$ docker-compose up
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
Visit http://localhost:8080?name=kataras.
|
Visit http://localhost:8080?name=kataras.
|
||||||
|
|
||||||
Now, replace the `main.go`'s `app.Register(environment.DEV` with `environment.PROD`, restart the application and refresh. You will see that a new database (`sqlite`) and another service of (`greeterWithLogging`) will be binded to the `GreetController`. With **a single change** you achieve to completety change the result.
|
Optionally, replace the `main.go`'s `app.Register(environment.DEV` with `environment.PROD`, restart the application and refresh. You will see that a new database (`sqlite`) and another service of (`greeterWithLogging`) will be binded to the `GreetController`. With **a single change** you achieve to completety change the result.
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,6 @@
|
||||||
package database
|
package database
|
||||||
|
|
||||||
import (
|
import "app/environment"
|
||||||
"app/environment"
|
|
||||||
)
|
|
||||||
|
|
||||||
// DB example database interface.
|
// DB example database interface.
|
||||||
type DB interface {
|
type DB interface {
|
||||||
|
|
|
||||||
|
|
@ -33,25 +33,14 @@ func (c *VisitController) Get() string {
|
||||||
|
|
||||||
func newApp() *iris.Application {
|
func newApp() *iris.Application {
|
||||||
app := iris.New()
|
app := iris.New()
|
||||||
|
// Configure sessions manager as we used to.
|
||||||
sess := sessions.New(sessions.Config{Cookie: "mysession_cookie_name"})
|
sess := sessions.New(sessions.Config{Cookie: "mysession_cookie_name"})
|
||||||
app.Use(sess.Handler())
|
app.Use(sess.Handler())
|
||||||
|
|
||||||
visitApp := mvc.New(app)
|
visitApp := mvc.New(app)
|
||||||
// bind the current *session.Session, which is required, to the `VisitController.Session`
|
visitApp.Register(time.Now())
|
||||||
// and the time.Now() to the `VisitController.StartTime`.
|
// The `VisitController.Session` is automatically binded to the current `sessions.Session`.
|
||||||
visitApp.Register(
|
|
||||||
// if dependency is a function which accepts
|
|
||||||
// a Context and returns a single value
|
|
||||||
// then the result type of this function is resolved by the controller
|
|
||||||
// and on each request it will call the function with its Context
|
|
||||||
// and set the result(the *sessions.Session here) to the controller's field.
|
|
||||||
//
|
|
||||||
// If dependencies are registered without field or function's input arguments as
|
|
||||||
// consumers then those dependencies are being ignored before the server ran,
|
|
||||||
// so you can bind many dependecies and use them in different controllers.
|
|
||||||
// sess.Start, // However after version 12.2 sessions are automatically binded.
|
|
||||||
time.Now(),
|
|
||||||
)
|
|
||||||
visitApp.Handle(new(VisitController))
|
visitApp.Handle(new(VisitController))
|
||||||
|
|
||||||
return app
|
return app
|
||||||
|
|
@ -60,7 +49,7 @@ func newApp() *iris.Application {
|
||||||
func main() {
|
func main() {
|
||||||
app := newApp()
|
app := newApp()
|
||||||
|
|
||||||
// 1. open the browser
|
// 1. Prepare a client, e.g. your browser
|
||||||
// 2. navigate to http://localhost:8080
|
// 2. navigate to http://localhost:8080
|
||||||
// 3. refresh the page some times
|
// 3. refresh the page some times
|
||||||
// 4. close the browser
|
// 4. close the browser
|
||||||
|
|
|
||||||
|
|
@ -24,6 +24,17 @@ func main() {
|
||||||
DisableSubdomainPersistence: false,
|
DisableSubdomainPersistence: false,
|
||||||
// Allow getting the session value stored by the request from the same request.
|
// Allow getting the session value stored by the request from the same request.
|
||||||
AllowReclaim: true,
|
AllowReclaim: true,
|
||||||
|
/*
|
||||||
|
SessionIDGenerator: func(ctx iris.Context) string {
|
||||||
|
id:= ctx.GetHeader("X-Session-Id")
|
||||||
|
if id == "" {
|
||||||
|
id = // [generate ID here and set the header]
|
||||||
|
ctx.Header("X-Session-Id", id)
|
||||||
|
}
|
||||||
|
|
||||||
|
return id
|
||||||
|
},
|
||||||
|
*/
|
||||||
})
|
})
|
||||||
|
|
||||||
app := example.NewApp(sess)
|
app := example.NewApp(sess)
|
||||||
|
|
|
||||||
|
|
@ -1153,11 +1153,12 @@ type Context interface {
|
||||||
// Controller returns a reflect Value of the custom Controller from which this handler executed.
|
// Controller returns a reflect Value of the custom Controller from which this handler executed.
|
||||||
// It will return a Kind() == reflect.Invalid if the handler was not executed from within a controller.
|
// It will return a Kind() == reflect.Invalid if the handler was not executed from within a controller.
|
||||||
Controller() reflect.Value
|
Controller() reflect.Value
|
||||||
// RegisterDependency registers a struct dependency at serve-time
|
// RegisterDependency registers a struct or slice
|
||||||
|
// or pointer to struct dependency at request-time
|
||||||
// for the next handler in the chain. One value per type.
|
// for the next handler in the chain. One value per type.
|
||||||
// Note that it's highly recommended to register
|
// Note that it's highly recommended to register
|
||||||
// your dependencies before server ran
|
// your dependencies before server ran
|
||||||
// through APIContainer(app.ConfigureContainer) or MVC(mvc.New)
|
// through Party.ConfigureContainer or mvc.Application.Register
|
||||||
// in sake of minimum performance cost.
|
// in sake of minimum performance cost.
|
||||||
//
|
//
|
||||||
// See `UnregisterDependency` too.
|
// See `UnregisterDependency` too.
|
||||||
|
|
@ -5562,12 +5563,15 @@ const DependenciesContextKey = "iris.dependencies"
|
||||||
// struct dependencies are stored with.
|
// struct dependencies are stored with.
|
||||||
type DependenciesMap map[reflect.Type]reflect.Value
|
type DependenciesMap map[reflect.Type]reflect.Value
|
||||||
|
|
||||||
// RegisterDependency registers a struct dependency at serve-time
|
// RegisterDependency registers a struct or slice
|
||||||
|
// or pointer to struct dependency at request-time
|
||||||
// for the next handler in the chain. One value per type.
|
// for the next handler in the chain. One value per type.
|
||||||
// Note that it's highly recommended to register
|
// Note that it's highly recommended to register
|
||||||
// your dependencies before server ran
|
// your dependencies before server ran
|
||||||
// through APIContainer(app.ConfigureContainer) or MVC(mvc.New)
|
// through Party.ConfigureContainer or mvc.Application.Register
|
||||||
// in sake of minimum performance cost.
|
// in sake of minimum performance cost.
|
||||||
|
//
|
||||||
|
// See `UnregisterDependency` too.
|
||||||
func (ctx *context) RegisterDependency(v interface{}) {
|
func (ctx *context) RegisterDependency(v interface{}) {
|
||||||
if v == nil {
|
if v == nil {
|
||||||
return
|
return
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user