966839dfea
* [doc] adding graceful documentation and example. * adding myself to the maintainers list and minor comment formatting change * [doc] updating code on the guides/context.md and guides/cookies.md to use v3 code. * [doc] updating error-handling and request to v3 codebase * [doc] updating templates documentation
1.7 KiB
+++ title = "HTTP Request" description = "Handling HTTP request in Echo" [menu.side] name = "Request" parent = "guide" weight = 6 +++
Request
Bind Request Body
To bind request body into a provided Go type use Context#Bind(interface{}).
The default binder supports decoding application/json, application/xml and
application/x-www-form-urlencoded payload based on Context-Type header.
Example
TODO
Custom binder can be registered via
Echo#SetBinder(Binder)
Query Parameter
Query parameter can be retrieved by name using Context#QueryParam(name string).
Example
e.GET("/users", func(c echo.Context) error {
name := c.QueryParam("name")
return c.String(http.StatusOK, name)
})
$ curl -G -d "name=joe" http://localhost:1323/users
Form Parameter
Form parameter can be retrieved by name using Context#FormValue(name string).
Example
e.POST("/users", func(c echo.Context) error {
name := c.FormValue("name")
return c.String(http.StatusOK, name)
})
$ curl -d "name=joe" http://localhost:1323/users
Path Parameter
Registered path parameter can be retrieved by name Context#Param(name string) string.
Example
e.GET("/users/:name", func(c echo.Context) error {
// By name
name := c.Param("name")
return c.String(http.StatusOK, name)
})
$ curl http://localhost:1323/users/joe
Handler Path
Context#Path() returns the registered path for the handler, it can be used in the
middleware for logging purpose.
Example
e.Use(func(handler echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
println(c.Path())
return handler(c)
}
})
e.GET("/users/:name", func(c echo.Context) error) {
return c.String(http.StatusOK, name)
})