响应

发送 string 数据

Context#String(code int, s string) 用于发送一个带有状态码的纯文本响应。

示例

  1. func(c echo.Context) error {
  2. return c.String(http.StatusOK, "Hello, World!")
  3. }

发送 HTML 响应 (参考模板)

Context#HTML(code int, html string) 用于发送一个带有状态码的简单 HTML 响应。如果你需要动态生成 HTML 内容请查看模版

示例

  1. func(c echo.Context) error {
  2. return c.HTML(http.StatusOK, "<strong>Hello, World!</strong>")
  3. }

发送 HTML Blob

Context#HTMLBlob(code int, b []byte) 用于发送一个带状态码的 HTML blob(二进制长对象)响应。可以发现,使用输出 []byte 的模版引擎很方便。

模版引擎渲染

查看

发送 JSON 数据

Context#JSON(code int, i interface{}) 用于发送一个带状态码的 JSON 对象,它会将 Golang 的对象转换成 JSON 字符串。

示例

  1. // User
  2. type User struct {
  3. Name string `json:"name" xml:"name"`
  4. Email string `json:"email" xml:"email"`
  5. }
  6. // Handler
  7. func(c echo.Context) error {
  8. u := &User{
  9. Name: "Jon",
  10. Email: "jon@labstack.com",
  11. }
  12. return c.JSON(http.StatusOK, u)
  13. }

JSON 流

Context#JSON() 内部使用 json.Marshal 来转换 JSON 数据,但该方法面对大量的 JSON 数据会显得效率不足,对于这种情况可以直接使用 JSON 流。

示例

  1. func(c echo.Context) error {
  2. u := &User{
  3. Name: "Jon",
  4. Email: "jon@labstack.com",
  5. }
  6. c.Response().Header().Set(echo.HeaderContentType, echo.MIMEApplicationJSONCharsetUTF8)
  7. c.Response().WriteHeader(http.StatusOK)
  8. return json.NewEncoder(c.Response()).Encode(u)
  9. }

JSON 美化 (JSON Pretty)

Context#JSONPretty(code int, i interface{}, indent string) 可以发送带有缩进(可以使用空格和 tab)的更为好看的 JSON 数据。

示例

  1. func(c echo.Context) error {
  2. u := &User{
  3. Name: "Jon",
  4. Email: "joe@labstack.com",
  5. }
  6. return c.JSONPretty(http.StatusOK, u, " ")
  7. }
  1. {
  2. "email": "joe@labstack.com",
  3. "name": "Jon"
  4. }

通过在请求URL查询字符串中附加 pretty ,你也可以使用 Context#JSON() 来输出带有缩进的 JSON 数据。

示例

  1. curl http://localhost:1323/users/1?pretty

JSON Blob

Context#JSONBlob(code int, b []byte) 可用来从外部源(例如数据库)直接发送预编码的 JSON 对象。

示例

  1. func(c echo.Context) error {
  2. encodedJSON := []byte{} // Encoded JSON from external source
  3. return c.JSONBlob(http.StatusOK, encodedJSON)
  4. }

发送 JSONP 数据

Context#JSONP(code int, callback string, i interface{}) 可以将 Golang 的数据类型转换成 JSON 类型,并通过回调以带有状态码的 JSONNP 结构发送。

查看示例

发送 XML 数据

Context#XML(code int, i interface{}) 可以将 Golang 对象转换成 XML 类型,并带上状态码发送响应。

示例

  1. func(c echo.Context) error {
  2. u := &User{
  3. Name: "Jon",
  4. Email: "jon@labstack.com",
  5. }
  6. return c.XML(http.StatusOK, u)
  7. }

XML 流

Context#XML 内部使用 xml.Marshal 来转换 XML 数据,但该方法面对大量的 XML 数据会显得效率不足,对于这种情况可以直接使用 XML 流。

示例

  1. func(c echo.Context) error {
  2. u := &User{
  3. Name: "Jon",
  4. Email: "jon@labstack.com",
  5. }
  6. c.Response().Header().Set(echo.HeaderContentType, echo.MIMEApplicationXMLCharsetUTF8)
  7. c.Response().WriteHeader(http.StatusOK)
  8. return xml.NewEncoder(c.Response()).Encode(u)
  9. }

XML 美化 (XML Pretty)

Context#XMLPretty(code int, i interface{}, indent string) 可以发送带有缩进(可以使用空格和 tab)的更为好看的 XML 数据。

示例

  1. func(c echo.Context) error {
  2. u := &User{
  3. Name: "Jon",
  4. Email: "joe@labstack.com",
  5. }
  6. return c.XMLPretty(http.StatusOK, u, " ")
  7. }
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <User>
  3. <Name>Jon</Name>
  4. <Email>joe@labstack.com</Email>
  5. </User>

通过在请求URL查询字符串中附加 pretty ,你也可以使用 Context#XML() 来输出带有缩进的 XML 数据。

示例

  1. curl http://localhost:1323/users/1?pretty

XML Blob

Context#XMLBlob(code int, b []byte) 可用来从外部源(例如数据库)直接发送预编码的 XML 对象。

示例

  1. func(c echo.Context) error {
  2. encodedXML := []byte{} // Encoded XML from external source
  3. return c.XMLBlob(http.StatusOK, encodedXML)
  4. }

发送文件

Context#File(file string) 可用来发送内容为文件的响应,并且它能自动设置正确的内容类型、优雅地处理缓存。

示例

  1. func(c echo.Context) error {
  2. return c.File("<文件路径>")
  3. }

发送附件

Context#Attachment(file, name string) 和发送文件 File() 的方法类似,只是它的方法名称不同。

示例

  1. func(c echo.Context) error {
  2. return c.Attachment("<PATH_TO_YOUR_FILE>")
  3. }

发送内嵌 (Inline)

Context#Inline(file, name string) 和发送文件 File() 的方法类似,只是它的方法名称不同。

示例

  1. func(c echo.Context) error {
  2. return c.Inline("<PATH_TO_YOUR_FILE>")
  3. }

发送二进制长文件 (Blob)

`Context#Blob(code int, contentType string, b []byte) 可用于发送带有内容类型 (content type) 和状态代码的任意类型数据。

示例

  1. func(c echo.Context) (err error) {
  2. data := []byte(`0306703,0035866,NO_ACTION,06/19/2006
  3. 0086003,"0005866",UPDATED,06/19/2006`)
  4. return c.Blob(http.StatusOK, "text/csv", data)
  5. }

发送流 (Stream)

Context#Stream(code int, contentType string, r io.Reader) 可用于发送带有内容类型 (content type) 、状态代码、io.Reader 的任意类型数据流。

示例

  1. func(c echo.Context) error {
  2. f, err := os.Open("<PATH_TO_IMAGE>")
  3. if err != nil {
  4. return err
  5. }
  6. return c.Stream(http.StatusOK, "image/png", f)
  7. }

发送空内容 (No Content)

Context#NoContent(code int) 可用于发送带有状态码的空内容。

示例

  1. func(c echo.Context) error {
  2. return c.NoContent(http.StatusOK)
  3. }

重定向

Context#Redirect(code int, url string) 可用于重定向至一个带有状态码的 URL。

示例

  1. func(c echo.Context) error {
  2. return c.Redirect(http.StatusMovedPermanently, "<URL>")
  3. }

Hooks

响应之前

Context#Response#Before(func()) 可以用来注册在写入响应之前调用的函数。

响应之后

Context#Response#After(func()) 可以用来注册在写入响应之后调用的函数。但是如果 “Content-Length” 是未知状态,则不会有任何方法会被执行。

示例

  1. func(c echo.Context) error {
  2. c.Response().Before(func() {
  3. println("before response")
  4. })
  5. c.Response().After(func() {
  6. println("after response")
  7. })
  8. return c.NoContent(http.StatusNoContent)
  9. }

可以在响应之前与之后注册多个方法