package main import ( "github.com/kataras/iris" ) func main() { app := iris.New() app.Logger().SetLevel("debug") // registers a custom handler for 404 not found http (error) status code, // fires when route not found or manually by ctx.StatusCode(iris.StatusNotFound). app.OnErrorCode(iris.StatusNotFound, notFoundHandler) // GET -> HTTP Method // / -> Path // func(ctx iris.Context) -> The route's handler. // // Third receiver should contains the route's handler(s), they are executed by order. app.Handle("GET", "/", func(ctx iris.Context) { // navigate to the middle of $GOPATH/src/github.com/kataras/iris/context/context.go // to overview all context's method (there a lot of them, read that and you will learn how iris works too) ctx.HTML("Hello from " + ctx.Path()) // Hello from / }) app.Get("/home", func(ctx iris.Context) { ctx.Writef(`Same as app.Handle("GET", "/", [...])`) }) // Different path parameters types in the same path. app.Get("/u/{username:string}", func(ctx iris.Context) { ctx.Writef("before username (string), current route name: %s\n", ctx.RouteName()) ctx.Next() }, func(ctx iris.Context) { ctx.Writef("username (string): %s", ctx.Params().Get("username")) }) app.Get("/u/{id:int}", func(ctx iris.Context) { ctx.Writef("before id (int), current route name: %s\n", ctx.RouteName()) ctx.Next() }, func(ctx iris.Context) { ctx.Writef("id (int): %d", ctx.Params().GetIntDefault("id", 0)) }) app.Get("/u/{uid:uint}", func(ctx iris.Context) { ctx.Writef("before uid (uint), current route name: %s\n", ctx.RouteName()) ctx.Next() }, func(ctx iris.Context) { ctx.Writef("uid (uint): %d", ctx.Params().GetUintDefault("uid", 0)) }) app.Get("/u/{firstname:alphabetical}", func(ctx iris.Context) { ctx.Writef("before firstname (alphabetical), current route name: %s\n", ctx.RouteName()) ctx.Next() }, func(ctx iris.Context) { ctx.Writef("firstname (alphabetical): %s", ctx.Params().Get("firstname")) }) /* /u/abcd maps to :alphabetical (if :alphabetical registered otherwise :string) /u/42 maps to :uint (if :uint registered otherwise :int) /u/-1 maps to :int (if :int registered otherwise :string) /u/abcd123 maps to :string */ app.Get("/donate", donateHandler, donateFinishHandler) // Pssst, don't forget dynamic-path example for more "magic"! app.Get("/api/users/{userid:uint64 min(1)}", func(ctx iris.Context) { userID, err := ctx.Params().GetUint64("userid") if err != nil { ctx.Writef("error while trying to parse userid parameter," + "this will never happen if :uint64 is being used because if it's not a valid uint64 it will fire Not Found automatically.") ctx.StatusCode(iris.StatusBadRequest) return } ctx.JSON(map[string]interface{}{ // you can pass any custom structured go value of course. "user_id": userID, }) }) // app.Post("/", func(ctx iris.Context){}) -> for POST http method. // app.Put("/", func(ctx iris.Context){})-> for "PUT" http method. // app.Delete("/", func(ctx iris.Context){})-> for "DELETE" http method. // app.Options("/", func(ctx iris.Context){})-> for "OPTIONS" http method. // app.Trace("/", func(ctx iris.Context){})-> for "TRACE" http method. // app.Head("/", func(ctx iris.Context){})-> for "HEAD" http method. // app.Connect("/", func(ctx iris.Context){})-> for "CONNECT" http method. // app.Patch("/", func(ctx iris.Context){})-> for "PATCH" http method. // app.Any("/", func(ctx iris.Context){}) for all http methods. // More than one route can contain the same path with a different http mapped method. // You can catch any route creation errors with: // route, err := app.Get(...) // set a name to a route: route.Name = "myroute" // You can also group routes by path prefix, sharing middleware(s) and done handlers. adminRoutes := app.Party("/admin", adminMiddleware) adminRoutes.Done(func(ctx iris.Context) { // executes always last if ctx.Next() ctx.Application().Logger().Infof("response sent to " + ctx.Path()) }) // adminRoutes.Layout("/views/layouts/admin.html") // set a view layout for these routes, see more at view examples. // GET: http://localhost:8080/admin adminRoutes.Get("/", func(ctx iris.Context) { // [...] ctx.StatusCode(iris.StatusOK) // default is 200 == iris.StatusOK ctx.HTML("