clevergo · razonyang · Apr 4, 2020 · Apr 2, 2020 · Apr 2, 2020 · Apr 2, 2020
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,28 @@ Change Log
 under development
 -----------------
 
+v1.9.0 April 4, 2020
+--------------------
+- Add `Context.JSON` to send JSON response.
+- Add `Context.String` to send string response.
+- Add `Context.XML` to send XML response.
+- `Content.SetContentTypeJSON` and `Content.SetContentTypeXML` append `charset=utf-8` to content type header.
+- Add `Context.HTML` to send HTML response.
+- Add `Context.Cookie` and `Context.Cookies`.
+- Add `Context.FormValue`.
+- Add `Context.PostFormValue`.
+- Add `Context.QueryString`.
+- Add `Context.QueryParams` and `Context.QueryParam`.
+- Add `Context.JSONP` and `Context.JSONPCallback`.
+- Add `Context.Render` to render a template.
+- Add `Context.RouteURL` to generate URL of the naming route.
+- Add `Context.Emit` and `Context.Blob`.
+- Add `Context.HtmlBlob`.
+- Add `Context.XMLBlob`.
+- Add `Context.JSONBlob`.
+- Add `Context.JSONPBlob` and `Context.JSONPCallbackBlob`.
+- Add `RecoveryLogger`.
+
 v1.8.1 April 2, 2020
 --------------------
 - Fix `WrapHH` doesn't returns the error of final handle.

diff --git a/CREDIT.md b/CREDIT.md
@@ -3,4 +3,5 @@ Creadit
 
 - Thanks to all [contributors](https://github.com/clevergo/clevergo/graphs/contributors).
 - [Razon Yang](https://github.com/razonyang): author and maintainer of [CleverGo](https://github.com/clevergo).
-- [Julien Schmidt](https://github.com/julienschmidt): the author of [julienschmidt/httprouter](https://github.com/julienschmidt/httprouter).
+- [Julien Schmidt](https://github.com/julienschmidt): the author of [julienschmidt/httprouter](https://github.com/julienschmidt/httprouter).
+- [Echo](https://github.com/labstack/echo): Renderer is inspired by Echo framework.
diff --git a/README-ZH.md b/README-ZH.md
@@ -57,13 +57,11 @@ import (
 )
 
 func home(ctx *clevergo.Context) error {
-	ctx.WriteString("hello world")
-	return nil
+	return ctx.String(http.StatusOK, "hello world")
 }
 
 func hello(ctx *clevergo.Context) error {
-	ctx.WriteString(fmt.Sprintf("hello %s", ctx.Params.String("name")))
-	return nil
+	return ctx.HTML(http.StatusOk, fmt.Sprintf("hello %s", ctx.Params.String("name")))
 }
 
 func main() {
@@ -74,6 +72,38 @@ func main() {
 }
 ```
 
+### 响应
+
+```go
+func text(ctx *clevergo.Context) error {
+	return ctx.String(http.StatusOK, "hello world")
+}
+
+func html(ctx *clevergo.Context) error {
+	return ctx.HTML(http.StatusOK, "<html><body>hello world</body></html>")
+}
+
+func json(ctx *clevergo.Context) error {
+	return ctx.JSON(http.StatusOK, data)
+}
+
+func jsonp(ctx *clevergo.Context) error {
+	// equals to ctx.JSONPCallback(http.StatusOK, "callback", data)
+	return ctx.JSONP(http.StatusOK, data)
+}
+
+func xml(ctx *clevergo.Context) error {
+	return ctx.XML(http.StatusOK, data)
+}
+
+// 渲染一个模板，需要注册 Render。
+// https://github.com/clevergo/jetrenderer
+// router.Renderer = jetrenderer.New(jet.NewHTMLSet("./views"))
+func render(ctx *clevergo.Context) error {
+	return ctx.Render(http.StatusOK, view, data)
+}
+```
+
 ### 参数
 
 可以通过多种方式获取各种类型的参数值。
@@ -112,6 +142,10 @@ router.NotFound = http.FileServer(http.Dir("public"))
 queryPost := func (ctx *clevergo.Context) error {
 	// 通过匹配路由生成 URL
 	url, _ := ctx.Route.URL("year", "2020", "month", "02", "slug", "hello world")
+
+	// 通过命名路由生成 URL
+	// url, _ := ctx.RouteURL("post", "year", "2020", "month", "02", "slug", "hello world")
+
 	return nil
 }
 

diff --git a/README.md b/README.md
@@ -55,13 +55,11 @@ import (
 )
 
 func home(ctx *clevergo.Context) error {
-	ctx.WriteString("hello world")
-	return nil
+	return ctx.String(http.StatusOK, "hello world")
 }
 
 func hello(ctx *clevergo.Context) error {
-	ctx.WriteString(fmt.Sprintf("hello %s", ctx.Params.String("name")))
-	return nil
+	return ctx.HTML(http.StatusOk, fmt.Sprintf("hello %s", ctx.Params.String("name")))
 }
 
 func main() {
@@ -72,6 +70,38 @@ func main() {
 }
 ```
 
+### Response
+
+```go
+func text(ctx *clevergo.Context) error {
+	return ctx.String(http.StatusOK, "hello world")
+}
+
+func html(ctx *clevergo.Context) error {
+	return ctx.HTML(http.StatusOK, "<html><body>hello world</body></html>")
+}
+
+func json(ctx *clevergo.Context) error {
+	return ctx.JSON(http.StatusOK, data)
+}
+
+func jsonp(ctx *clevergo.Context) error {
+	// equals to ctx.JSONPCallback(http.StatusOK, "callback", data)
+	return ctx.JSONP(http.StatusOK, data)
+}
+
+func xml(ctx *clevergo.Context) error {
+	return ctx.XML(http.StatusOK, data)
+}
+
+// Renders a template, you should register renderer first.
+// https://github.com/clevergo/jetrenderer
+// router.Renderer = jetrenderer.New(jet.NewHTMLSet("./views"))
+func render(ctx *clevergo.Context) error {
+	return ctx.Render(http.StatusOK, view, data)
+}
+```
+
 ### Params
 
 There are some useful functions to retrieve the parameter value.
@@ -110,12 +140,16 @@ router.NotFound = http.FileServer(http.Dir("public"))
 queryPost := func (ctx *clevergo.Context) error {
 	// generates URL by matched route.
 	url, _ := ctx.Route.URL("year", "2020", "month", "02", "slug", "hello world")
+
+	// generates URL by naming route.
+	// url, _ := ctx.RouteURL("post", "year", "2020", "month", "02", "slug", "hello world")
+
 	return nil
 }
 
 router.Get("/posts/:year/:month/:slug", queryPost, router.RouteName("post"))
 
-// generates URL by named route.
+// generates URL by naming route.
 url, _ := router.URL("post", "year", "2020", "month", "02", "slug", "hello world")
 ```
 
@@ -142,7 +176,7 @@ router.ErrorHandler = MyErrorHandler{
 
 ### Middleware
 
-Middleware is a function `func(next Handle) Handle`. [WrapHH](https://pkg.go.dev/github.com/clevergo/clevergo?tab=doc#WrapHH) is an adapter that converts `func(http.Handler) http.Handler` as a middleware.
+Middleware is a function `func(next Handle) Handle`. [WrapHH](https://pkg.go.dev/github.com/clevergo/clevergo?tab=doc#WrapHH) is an adapter that converts `func(http.Handler) http.Handler` to a middleware.
 
 **Built-in middlewares:**