修改连接错误,修正一些报引用错误 (#1655)
修复了全角括号导致超链接不能正常访问的错误。 修复了一些URL中的"/"被改成" / "的错误。 修复了一些包引用中"/"被改成" / "的错误。 修复有超链接被翻译成中文的错误。
This commit is contained in:
parent
6053156eed
commit
1f576fb27c
62
README_ZH.md
62
README_ZH.md
@ -200,7 +200,7 @@ BenchmarkVulcan_GithubAll | 5000 | 394253 | 19894
|
|||||||
|
|
||||||
## 使用 [jsoniter](https://github.com/json-iterator/go) 构建
|
## 使用 [jsoniter](https://github.com/json-iterator/go) 构建
|
||||||
|
|
||||||
Gin使用`encoding / json`作为默认的json包,但您可以通过其他标签的构建更改为[jsoniter](https://github.com/json-iterator/go)。
|
Gin使用`encoding/json`作为默认的json包,但您可以通过其他标签的构建更改为[jsoniter](https://github.com/json-iterator/go)。
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ go build -tags=jsoniter .
|
$ go build -tags=jsoniter .
|
||||||
@ -359,7 +359,7 @@ ids: map[b:hello a:1234], names: map[second:tianou first:thinkerou]
|
|||||||
|
|
||||||
#### 单个文件上传
|
#### 单个文件上传
|
||||||
|
|
||||||
参考问题[#774](https://github.com/gin-gonic/gin/issues/774)和详细[示例代码](examples / upload-file / single)。
|
参考问题[#774](https://github.com/gin-gonic/gin/issues/774)和详细[示例代码](examples/upload-file/single)。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
func main() {
|
func main() {
|
||||||
@ -390,7 +390,7 @@ curl -X POST http://localhost:8080/upload \
|
|||||||
|
|
||||||
#### 多文件上传
|
#### 多文件上传
|
||||||
|
|
||||||
查看详细信息[示例代码](examples / upload-file / multiple)。
|
查看详细信息[示例代码](examples/upload-file/multiple)。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
func main() {
|
func main() {
|
||||||
@ -530,14 +530,14 @@ func main() {
|
|||||||
|
|
||||||
要将请求主体绑定到类型中,请使用模型绑定。我们目前支持JSON,XML和标准表单值的绑定(foo = bar&boo = baz)。
|
要将请求主体绑定到类型中,请使用模型绑定。我们目前支持JSON,XML和标准表单值的绑定(foo = bar&boo = baz)。
|
||||||
|
|
||||||
Gin使用[** go-playground / validator.v8 **](https://github.com/go-playground/validator)进行验证。检查有关标签用法的完整文档[此处](http://godoc.org/gopkg.in/go-playground/validator.v8#hdr-Baked_In_Validators_and_Tags)。
|
Gin使用[** go-playground/validator.v8 **](https://github.com/go-playground/validator)进行验证。检查有关标签用法的完整文档[此处](http://godoc.org/gopkg.in/go-playground/validator.v8#hdr-Baked_In_Validators_and_Tags)。
|
||||||
|
|
||||||
请注意,您需要在要绑定的所有字段上设置相应的绑定标记。例如,从JSON绑定时,设置`json:“fieldname”`。
|
请注意,您需要在要绑定的所有字段上设置相应的绑定标记。例如,从JSON绑定时,设置`json:“fieldname”`。
|
||||||
|
|
||||||
此外,Gin提供了两组绑定方法:
|
此外,Gin提供了两组绑定方法:
|
||||||
- **类型** - 必须绑定
|
- **类型** - 必须绑定
|
||||||
- **方法** - `Bind`,`BindJSON`,`BindXML`,`BindQuery`
|
- **方法** - `Bind`,`BindJSON`,`BindXML`,`BindQuery`
|
||||||
- **行为** - 这些方法在引擎盖下使用`MustBindWith`。如果存在绑定错误,则使用`c.AbortWithError(400,err).SetType(ErrorTypeBind)`中止请求。这将响应状态代码设置为400,并将`Content-Type`标头设置为`text / plain;字符集= UTF-8`。请注意,如果您在此之后尝试设置响应代码,则会发出警告“[GIN-debug] [警告]标题已经写入。想用422`覆盖状态代码400。如果您希望更好地控制行为,请考虑使用`ShouldBind`等效方法。
|
- **行为** - 这些方法在引擎盖下使用`MustBindWith`。如果存在绑定错误,则使用`c.AbortWithError(400,err).SetType(ErrorTypeBind)`中止请求。这将响应状态代码设置为400,并将`Content-Type`标头设置为`text/plain;字符集= UTF-8`。请注意,如果您在此之后尝试设置响应代码,则会发出警告“[GIN-debug] [警告]标题已经写入。想用422`覆盖状态代码400。如果您希望更好地控制行为,请考虑使用`ShouldBind`等效方法。
|
||||||
- **类型** - 应该绑定
|
- **类型** - 应该绑定
|
||||||
- **方法** - `ShouldBind`,`ShouldBindJSON`,`ShouldBindXML`,`ShouldBindQuery`
|
- **方法** - `ShouldBind`,`ShouldBindJSON`,`ShouldBindXML`,`ShouldBindQuery`
|
||||||
- **行为** - 这些方法在引擎盖下使用`ShouldBindWith`。如果存在绑定错误,则返回错误,开发人员有责任正确处理请求和错误。
|
- **行为** - 这些方法在引擎盖下使用`ShouldBindWith`。如果存在绑定错误,则返回错误,开发人员有责任正确处理请求和错误。
|
||||||
@ -643,9 +643,9 @@ $ curl -v -X POST \
|
|||||||
|
|
||||||
### 自定义验证器
|
### 自定义验证器
|
||||||
|
|
||||||
也可以注册自定义验证器。 请参阅[示例代码](examples / custom-validation / server.go)。
|
也可以注册自定义验证器。 请参阅[示例代码](examples/custom-validation/server.go)。
|
||||||
|
|
||||||
[embedmd]:#(examples / custom-validation / server.go go)
|
[embedmd]:#(examples/custom-validation/server.go go)
|
||||||
```go
|
```go
|
||||||
package main
|
package main
|
||||||
|
|
||||||
@ -707,12 +707,12 @@ $ curl "localhost:8085/bookable?check_in=2018-03-08&check_out=2018-03-09"
|
|||||||
{"error":"Key: 'Booking.CheckIn' Error:Field validation for 'CheckIn' failed on the 'bookabledate' tag"}
|
{"error":"Key: 'Booking.CheckIn' Error:Field validation for 'CheckIn' failed on the 'bookabledate' tag"}
|
||||||
```
|
```
|
||||||
|
|
||||||
[结构级验证](https://github.com/go-playground/validator/releases/tag/v8.7)也可以这种方式注册。
|
[结构级验证](https://github.com/go-playground/validator/releases/tag/v8.7)也可以这种方式注册。
|
||||||
请参阅[struct-lvl-validation示例](examples / struct-lvl-validations)以了解更多信息。
|
请参阅[struct-lvl-validation示例](examples/struct-lvl-validations)以了解更多信息。
|
||||||
|
|
||||||
### 只绑定查询字符串
|
### 只绑定查询字符串
|
||||||
|
|
||||||
`ShouldBindQuery` 函数只绑定查询参数而不是后期数据。 请参阅[详细信息](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017)。
|
`ShouldBindQuery` 函数只绑定查询参数而不是后期数据。 请参阅[详细信息](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017)。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
package main
|
package main
|
||||||
@ -748,7 +748,7 @@ func startPage(c *gin.Context) {
|
|||||||
|
|
||||||
### 绑定查询字符串或发布数据
|
### 绑定查询字符串或发布数据
|
||||||
|
|
||||||
请参阅[详细信息](https://github.com/gin-gonic/gin/issues/742#issuecomment-264681292)。
|
请参阅[详细信息](https://github.com/gin-gonic/gin/issues/742#issuecomment-264681292)。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
package main
|
package main
|
||||||
@ -794,7 +794,7 @@ $ curl -X GET "localhost:8085/testing?name=appleboy&address=xyz&birthday=1992-03
|
|||||||
|
|
||||||
### 绑定 HTML 复选框
|
### 绑定 HTML 复选框
|
||||||
|
|
||||||
参见[详细信息](https://github.com/gin-gonic/gin/issues/129#issuecomment-124260092)
|
参见[详细信息](https://github.com/gin-gonic/gin/issues/129#issuecomment-124260092)
|
||||||
|
|
||||||
main.go
|
main.go
|
||||||
|
|
||||||
@ -931,7 +931,7 @@ func main() {
|
|||||||
|
|
||||||
#### SecureJSON
|
#### SecureJSON
|
||||||
|
|
||||||
使用 SecureJSON 来防止 json 劫持。 如果给定的结构是数组值,则默认预 置`“while(1),”` 到响应体。
|
使用 SecureJSON 来防止 json 劫持。 如果给定的结构是数组值,则默认预 置`“while(1),”` 到响应体。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
func main() {
|
func main() {
|
||||||
@ -1067,7 +1067,7 @@ func main() {
|
|||||||
|
|
||||||
### HTML 渲染
|
### HTML 渲染
|
||||||
|
|
||||||
使用LoadHTMLGlob()或LoadHTMLFiles()
|
使用LoadHTMLGlob()或LoadHTMLFiles()
|
||||||
|
|
||||||
```go
|
```go
|
||||||
func main() {
|
func main() {
|
||||||
@ -1159,12 +1159,12 @@ func main() {
|
|||||||
```go
|
```go
|
||||||
r := gin.Default()
|
r := gin.Default()
|
||||||
r.Delims("{[{", "}]}")
|
r.Delims("{[{", "}]}")
|
||||||
r.LoadHTMLGlob("/path/to/templates"))
|
r.LoadHTMLGlob("/path/to/templates")
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 自定义模板功能
|
#### 自定义模板功能
|
||||||
|
|
||||||
查看详细信息[示例代码](示例/模板)。
|
查看详细信息[示例代码](examples/template)。
|
||||||
|
|
||||||
main.go
|
main.go
|
||||||
|
|
||||||
@ -1215,7 +1215,7 @@ Date: 2017/07/01
|
|||||||
|
|
||||||
### 多模板
|
### 多模板
|
||||||
|
|
||||||
Gin 允许默认只使用一个 html 模板。 检查[多模板渲染](https://github.com/gin-contrib/multitemplate)以使用 go 1.6 `block template` 等功能。
|
Gin 允许默认只使用一个 html 模板。 检查[多模板渲染](https://github.com/gin-contrib/multitemplate)以使用 go 1.6 `block template` 等功能。
|
||||||
|
|
||||||
### 重定向
|
### 重定向
|
||||||
|
|
||||||
@ -1355,7 +1355,7 @@ func main() {
|
|||||||
|
|
||||||
### 自定义 HTTP 配置
|
### 自定义 HTTP 配置
|
||||||
|
|
||||||
直接使用`http.ListenAndServe()`,如下所示:
|
直接使用`http.ListenAndServe()`,如下所示:
|
||||||
|
|
||||||
```go
|
```go
|
||||||
func main() {
|
func main() {
|
||||||
@ -1441,7 +1441,7 @@ func main() {
|
|||||||
|
|
||||||
### 使用 Gin 运行多个服务
|
### 使用 Gin 运行多个服务
|
||||||
|
|
||||||
请参阅[问题](https://github.com/gin-gonic/gin/issues/346)并尝试以下示例:
|
请参阅[问题](https://github.com/gin-gonic/gin/issues/346)并尝试以下示例:
|
||||||
|
|
||||||
[embedmd]:# (examples/multiple-service/main.go go)
|
[embedmd]:# (examples/multiple-service/main.go go)
|
||||||
```go
|
```go
|
||||||
@ -1526,7 +1526,7 @@ func main() {
|
|||||||
您想要优雅地重启或停止您的Web服务器吗?
|
您想要优雅地重启或停止您的Web服务器吗?
|
||||||
有一些方法可以做到这一点。
|
有一些方法可以做到这一点。
|
||||||
|
|
||||||
我们可以使用[fvbock / endless](https://github.com/fvbock/endless)来替换默认的`ListenAndServe`。 有关更多详细信息,请参阅问题[#296](https://github.com/gin-gonic/gin/issues/296)。
|
我们可以使用[fvbock/endless](https://github.com/fvbock/endless)来替换默认的`ListenAndServe`。 有关更多详细信息,请参阅问题[#296](https://github.com/gin-gonic/gin/issues/296)。
|
||||||
|
|
||||||
```go
|
```go
|
||||||
router := gin.Default()
|
router := gin.Default()
|
||||||
@ -1537,11 +1537,11 @@ endless.ListenAndServe(":4242", router)
|
|||||||
|
|
||||||
另一种替代方案:
|
另一种替代方案:
|
||||||
|
|
||||||
* [manners](https://github.com/braintree/manners):礼貌的Go HTTP服务器,可以正常关闭。
|
* [manners](https://github.com/braintree/manners):礼貌的Go HTTP服务器,可以正常关闭。
|
||||||
* [graceful](https://github.com/tylerb/graceful):Graceful是一个Go包,可以正常关闭http.Handler服务器。
|
* [graceful](https://github.com/tylerb/graceful):Graceful是一个Go包,可以正常关闭http.Handler服务器。
|
||||||
* [grace](https://github.com/facebookgo/grace):Go服务器的平滑重启和零停机时间部署。
|
* [grace](https://github.com/facebookgo/grace):Go服务器的平滑重启和零停机时间部署。
|
||||||
|
|
||||||
如果您使用的是Go 1.8,则可能不需要使用此库! 考虑使用http.Server的内置[Shutdown()](https://golang.org/pkg/net/http/#Server.Shutdown)方法进行正常关机。 请参阅gin的完整[graceful-shutdown](./ examples / graceful-shutdown)示例。
|
如果您使用的是Go 1.8,则可能不需要使用此库! 考虑使用http.Server的内置[Shutdown()](https://golang.org/pkg/net/http/#Server.Shutdown)方法进行正常关机。 请参阅gin的完整[graceful-shutdown](./examples /graceful-shutdown)示例。
|
||||||
|
|
||||||
[embedmd]:# (examples/graceful-shutdown/graceful-shutdown/server.go go)
|
[embedmd]:# (examples/graceful-shutdown/graceful-shutdown/server.go go)
|
||||||
```go
|
```go
|
||||||
@ -1788,13 +1788,13 @@ func SomeHandler(c *gin.Context) {
|
|||||||
足以立刻调用绑定。
|
足以立刻调用绑定。
|
||||||
*只有某些格式需要此功能 - “JSON”,“XML”,“MsgPack”,
|
*只有某些格式需要此功能 - “JSON”,“XML”,“MsgPack”,
|
||||||
`ProtoBuf`。 对于其他格式,`Query`,`Form`,`FormPost`,`FormMultipart`,
|
`ProtoBuf`。 对于其他格式,`Query`,`Form`,`FormPost`,`FormMultipart`,
|
||||||
可以被`c.ShouldBind()`多次调用而不会造成任何损害
|
可以被`c.ShouldBind()`多次调用而不会造成任何损害
|
||||||
表现(见[#1341](https://github.com/gin-gonic/gin/pull/1341))。
|
表现(见[#1341](https://github.com/gin-gonic/gin/pull/1341)。
|
||||||
|
|
||||||
### http2 server 推送
|
### http2 server 推送
|
||||||
|
|
||||||
|
|
||||||
http.Pusher仅支持** go1.8 + **。 有关详细信息,请参阅[golang blog](https://blog.golang.org/h2push)。
|
http.Pusher仅支持** go1.8 + **。 有关详细信息,请参阅[golang blog](https://blog.golang.org/h2push)。
|
||||||
|
|
||||||
[embedmd]:# (examples/http-pusher/main.go go)
|
[embedmd]:# (examples/http-pusher/main.go go)
|
||||||
```go
|
```go
|
||||||
@ -1933,8 +1933,8 @@ func TestPingRoute(t *testing.T) {
|
|||||||
## 用户
|
## 用户
|
||||||
|
|
||||||
|
|
||||||
使用[Gin](https://github.com/gin-gonic/gin)Web框架的令人敬畏的项目列表。
|
使用[Gin](https://github.com/gin-gonic/gin)Web框架的令人尊敬的项目列表。
|
||||||
|
|
||||||
* [drone](https://github.com/drone/drone):drone,用Go编写。
|
* [drone](https://github.com/drone/drone):drone,用Go编写。
|
||||||
* [gorush](https://github.com/appleboy/gorush):用Go编写的推送通知服务器。
|
* [gorush](https://github.com/appleboy/gorush):用Go编写的推送通知服务器。
|
||||||
* [fnproject](https://github.com/fnproject/fn):容器本机,云无关的无服务器平台。
|
* [fnproject](https://github.com/fnproject/fn):容器本机,云无关的无服务器平台。
|
||||||
|
Loading…
Reference in New Issue
Block a user