一些杂项例子(miscellaneous)

1.文件日志记录(file logger)

目录结构

主目录fileLogger

  1.     —— main.go

代码示例

main.go

  1. package main
  3. import (
  4.     "os"
  5.     "time"
  6.     "github.com/kataras/iris"
  7. )
  9. //根据日期获取文件名，仅用于容易区分
  10. func todayFilename() string {
  11.     today := time.Now().Format("Jan 02 2006")
  12.     return today + ".txt"
  13. }
  15. func newLogFile() *os.File {
  16.     filename := todayFilename()
  17.     //打开文件，如果服务器重新启动，这将附加到今天的文件。
  18.     f, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
  19.     if err != nil {
  20.         panic(err)
  21.     }
  22.     return f
  23. }
  25. func main() {
  26.     f := newLogFile()
  27.     defer f.Close()
  28.     app := iris.New()
  29.     //将文件作为记录器附加，请记住，iris的app logger只是一个io.Writer。
  30.     //如果需要同时将日志写入文件和控制台，请使用以下代码。
  31.     // app.Logger().SetOutput(io.MultiWriter(f, os.Stdout))
  32.     app.Logger().SetOutput(f)
  33.     app.Get("/ping", func(ctx iris.Context) {
  34.         // for the sake of simplicity, in order see the logs at the ./_today_.txt
  35.         ctx.Application().Logger().Infof("Request path: %s", ctx.Path())
  36.         ctx.WriteString("pong")
  37.     })
  38.     //访问http://localhost:8080/ping
  39.     //打开文件 ./logs{TODAY}.txt file.
  40.     if err := app.Run(iris.Addr(":8080"), iris.WithoutBanner, iris.WithoutServerError(iris.ErrServerClosed)); err != nil {
  41.         app.Logger().Warn("Shutdown with error: " + err.Error())
  42.     }
  43. }

2.多语言切换(i18n)

目录结构

主目录i18n

  1.     —— locales
  2.         —— locale_el-GR.ini
  3.         —— locale_en-US.ini
  4.         —— locale_zh-CN.ini
  5.     —— main.go
  6.     —— main_test.go

代码示例

main.go

  1. package main
  3. import (
  4.     "github.com/kataras/iris"
  5.     "github.com/kataras/iris/middleware/i18n"
  6. )
  8. func newApp() *iris.Application {
  9.     app := iris.New()
  10.     globalLocale := i18n.New(i18n.Config{
  11.         Default:      "en-US",
  12.         URLParameter: "lang",
  13.         Languages: map[string]string{
  14.             "en-US": "./locales/locale_en-US.ini",
  15.             "el-GR": "./locales/locale_el-GR.ini",
  16.             "zh-CN": "./locales/locale_zh-CN.ini"}})
  17.     app.Use(globalLocale)
  18.     app.Get("/", func(ctx iris.Context) {
  19.         //它试图通过以下方式找到当前语言环境值：
  20.         // ctx.Values().GetString("language")
  21.         //如果是空的那么它尝试从配置中设置的URLParameter中查找
  22.         //如果没找到的话
  23.         //它试图通过("language")cookie找到语言环境值
  24.         //如果没有找到，则将其设置为配置上设置的默认值
  26.         // hi是键，'iris'是.ini文件中的%s,可以叫参数
  27.         //第二个参数是可选的
  29.         // hi := ctx.Translate("hi", "iris")
  30.         // 或:
  31.         hi := i18n.Translate(ctx, "hi", "iris")
  33.         language := ctx.Values().GetString(ctx.Application().ConfigurationReadOnly().GetTranslateLanguageContextKey())
  34.         //返回'en-US'的形式
  35.         //找到的第一个默认语言保存在名称为("language")的cookie中，
  36.         //你可以通过改变：iris.TranslateLanguageContextKey的值来改变它
  37.         ctx.Writef("From the language %s translated output: %s", language, hi)
  38.     })
  40.     multiLocale := i18n.New(i18n.Config{
  41.         Default:      "en-US",
  42.         URLParameter: "lang",
  43.         Languages: map[string]string{
  44.             "en-US": "./locales/locale_multi_first_en-US.ini, ./locales/locale_multi_second_en-US.ini",
  45.             "el-GR": "./locales/locale_multi_first_el-GR.ini, ./locales/locale_multi_second_el-GR.ini"}})
  46.     app.Get("/multi", multiLocale, func(ctx iris.Context) {
  47.         language := ctx.Values().GetString(ctx.Application().ConfigurationReadOnly().GetTranslateLanguageContextKey())
  49.         fromFirstFileValue := i18n.Translate(ctx, "key1")
  50.         fromSecondFileValue := i18n.Translate(ctx, "key2")
  51.         ctx.Writef("From the language: %s, translated output:\n%s=%s\n%s=%s",
  52.             language, "key1", fromFirstFileValue,
  53.             "key2", fromSecondFileValue)
  54.     })
  55.     return app
  56. }
  58. func main() {
  59.     app := newApp()
  60.     // 访问 http://localhost:8080/?lang=el-GR
  61.     // 或 http://localhost:8080 (default is en-US)
  62.     // 或 http://localhost:8080/?lang=zh-CN
  63.     // 访问 http://localhost:8080/multi?lang=el-GR
  64.     // 或 http://localhost:8080/multi (default is en-US)
  65.     // 或 http://localhost:8080/multi?lang=en-US
  66.     // 或使用cookie来设置语言.
  67.     app.Run(iris.Addr(":8080"))
  68. }

main_test.go(测试代码)

  1. package main
  3. import (
  4.     "fmt"
  5.     "testing"
  6.     "github.com/kataras/iris/httptest"
  7. )
  9. func TestI18n(t *testing.T) {
  10.     app := newApp()
  11.     expectedf := "From the language %s translated output: %s"
  12.     var (
  13.         elgr = fmt.Sprintf(expectedf, "el-GR", "γεια, iris")
  14.         enus = fmt.Sprintf(expectedf, "en-US", "hello, iris")
  15.         zhcn = fmt.Sprintf(expectedf, "zh-CN", "您好，iris")
  16.         elgrMulti = fmt.Sprintf("From the language: %s, translated output:\n%s=%s\n%s=%s", "el-GR",
  17.             "key1",
  18.             "αυτό είναι μια τιμή από το πρώτο αρχείο: locale_multi_first",
  19.             "key2",
  20.             "αυτό είναι μια τιμή από το δεύτερο αρχείο μετάφρασης: locale_multi_second")
  21.         enusMulti = fmt.Sprintf("From the language: %s, translated output:\n%s=%s\n%s=%s", "en-US",
  22.             "key1",
  23.             "this is a value from the first file: locale_multi_first",
  24.             "key2",
  25.             "this is a value from the second file: locale_multi_second")
  26.     )
  27.     e := httptest.New(t, app)
  28.     // default is en-US
  29.     e.GET("/").Expect().Status(httptest.StatusOK).Body().Equal(enus)
  30.     // default is en-US if lang query unable to be found
  31.     e.GET("/").Expect().Status(httptest.StatusOK).Body().Equal(enus)
  32.     e.GET("/").WithQueryString("lang=el-GR").Expect().Status(httptest.StatusOK).
  33.         Body().Equal(elgr)
  34.     e.GET("/").WithQueryString("lang=en-US").Expect().Status(httptest.StatusOK).
  35.         Body().Equal(enus)
  36.     e.GET("/").WithQueryString("lang=zh-CN").Expect().Status(httptest.StatusOK).
  37.         Body().Equal(zhcn)
  38.     e.GET("/multi").WithQueryString("lang=el-GR").Expect().Status(httptest.StatusOK).
  39.         Body().Equal(elgrMulti)
  40.     e.GET("/multi").WithQueryString("lang=en-US").Expect().Status(httptest.StatusOK).
  41.         Body().Equal(enusMulti)
  42. }

/locales/locale_el-GR.ini(语言包)

  1. hi = γεια, %s

/locales/locale_en-US.ini(语言包)

  1. hi = hello, %s

/locales/locale_zh-CN.ini(语言包)

  1. hi = 您好，%s

3.代码性能测试(pprof)

目录结构

主目录pprof

  1.     —— main.go

代码示例

main.go

  1. //go中有pprof包来做代码的性能监控
  2. package main
  4. import (
  5.     "github.com/kataras/iris"
  6.     "github.com/kataras/iris/middleware/pprof"
  7. )
  9. func main() {
  10.     app := iris.New()
  11.     app.Get("/", func(ctx iris.Context) {
  12.         ctx.HTML("<h1> Please click <a href='/debug/pprof'>here</a>")
  13.     })
  14.     app.Any("/debug/pprof/{action:path}", pprof.New())
  15.     app.Run(iris.Addr(":8080"))
  16. }

4.图形验证码(recaptcha)

目录结构

主目录recaptcha

  1.     —— custom_form
  2.         —— main.go
  3.     —— main.go

代码示例

main.go

  1. package main
  3. import (
  4.     "github.com/kataras/iris"
  5.     "github.com/kataras/iris/middleware/recaptcha"
  6. )
  8. //密钥应通过https://www.google.com/recaptcha获取
  9. const (
  10.     recaptchaPublic = ""
  11.     recaptchaSecret = ""
  12. )
  14. func showRecaptchaForm(ctx iris.Context, path string) {
  15.     ctx.HTML(recaptcha.GetFormHTML(recaptchaPublic, path))
  16. }
  18. func main() {
  19.     app := iris.New()
  20.     // On both Get and Post on this example, so you can easly
  21.     // use a single route to show a form and the main subject if recaptcha's validation result succeed.
  22.     //在此示例的Get和Post上，您可以轻松
  23.     //使用单个路径显示表单，并且重新验证结果的主要主题成功。
  24.     app.HandleMany("GET POST", "/", func(ctx iris.Context) {
  25.         if ctx.Method() == iris.MethodGet {
  26.             showRecaptchaForm(ctx, "/")
  27.             return
  28.         }
  29.         result := recaptcha.SiteFerify(ctx, recaptchaSecret)
  30.         if !result.Success {
  31.             /* 如果你想要或什么都不做，重定向到这里 */
  32.             ctx.HTML("<b> failed please try again </b>")
  33.             return
  34.         }
  35.         ctx.Writef("succeed.")
  36.     })
  37.     app.Run(iris.Addr(":8080"))
  38. }

/custom_form/main.go

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/kataras/iris"
  6.     "github.com/kataras/iris/middleware/recaptcha"
  7. )
  8. //密钥应通过https://www.google.com/recaptcha获取
  9. const (
  10.     recaptchaPublic = "6Lf3WywUAAAAAKNfAm5DP2J5ahqedtZdHTYaKkJ6"
  11.     recaptchaSecret = "6Lf3WywUAAAAAJpArb8nW_LCL_PuPuokmEABFfgw"
  12. )
  14. func main() {
  15.     app := iris.New()
  16.     r := recaptcha.New(recaptchaSecret)
  17.     app.Get("/comment", showRecaptchaForm)
  18.     //在主处理程序之前传递中间件或使用`recaptcha.SiteVerify`。
  19.     app.Post("/comment", r, postComment)
  20.     app.Run(iris.Addr(":8080"))
  21. }
  23. var htmlForm = `<form action="/comment" method="POST">
  24.         <script src="https://www.google.com/recaptcha/api.js"></script>
  25.         <div class="g-recaptcha" data-sitekey="%s"></div>
  26.         <input type="submit" name="button" value="Verify">
  27. </form>`
  29. func showRecaptchaForm(ctx iris.Context) {
  30.     contents := fmt.Sprintf(htmlForm, recaptchaPublic)
  31.     ctx.HTML(contents)
  32. }
  34. func postComment(ctx iris.Context) {
  35.     // [...]
  36.     ctx.JSON(iris.Map{"success": true})
  37. }

5.异常恢复(recover)

目录结构

主目录recover

  1.     —— main.go

代码示例

main.go

  1. package main
  3. import (
  4.     "github.com/kataras/iris"
  5.     "github.com/kataras/iris/middleware/recover"
  6. )
  8. func main() {
  9.     app := iris.New()
  10.     app.Use(recover.New())
  11.     i := 0
  12.     //让我们在下一个请求时模拟panic
  13.     app.Get("/", func(ctx iris.Context) {
  14.         i++
  15.         if i%2 == 0 {
  16.             panic("a panic here")
  17.         }
  18.         ctx.Writef("Hello, refresh one time more to get panic!")
  19.     })
  20.     // http://localhost:8080, 刷新5-6次
  21.     app.Run(iris.Addr(":8080"))
  22. }
  23. //注意： app := iris.Default()而不是iris.New()自动使用恢复中间件。