1
0
mirror of https://github.com/labstack/echo.git synced 2024-12-24 20:14:31 +02:00
echo/website/content/guide/request.md
Vishal Rana 054a310e70 updated website
Signed-off-by: Vishal Rana <vr@labstack.com>
2016-11-20 14:51:17 -08:00

95 lines
1.7 KiB
Markdown

+++
title = "Request"
description = "Handling HTTP request in Echo"
[menu.main]
name = "Request"
parent = "guide"
weight = 6
+++
## 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*
```go
e.GET("/users", func(c echo.Context) error {
name := c.QueryParam("name")
return c.String(http.StatusOK, name)
})
```
```sh
$ curl -G -d "name=joe" http://localhost:1323/users
```
## Form Parameter
Form parameter can be retrieved by name using `Context#FormValue(name string)`.
*Example*
```go
e.POST("/users", func(c echo.Context) error {
name := c.FormValue("name")
return c.String(http.StatusOK, name)
})
```
```sh
$ curl -d "name=joe" http://localhost:1323/users
```
## Path Parameter
Registered path parameter can be retrieved by name `Context#Param(name string) string`.
*Example*
```go
e.GET("/users/:name", func(c echo.Context) error {
// By name
name := c.Param("name")
return c.String(http.StatusOK, name)
})
```
```sh
$ 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*
```go
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)
})
```