pcc 2017比赛.zip

#Gin Web Framework <img align="right" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.jpg"> [](https://travis-ci.org/gin-gonic/gin) [](https://codecov.io/gh/gin-gonic/gin) [](https://goreportcard.com/report/github.com/gin-gonic/gin) [](https://godoc.org/github.com/gin-gonic/gin) [](https://gitter.im/gin-gonic/gin?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) Gin is a web framework written in Go (Golang). It features a martini-like API with much better performance, up to 40 times faster thanks to [httprouter](https://github.com/julienschmidt/httprouter). If you need performance and good productivity, you will love Gin.  ```sh $ cat test.go ``` ```go package main import "gopkg.in/gin-gonic/gin.v1" func main() { r := gin.Default() r.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "pong", }) }) r.Run() // listen and serve on 0.0.0.0:8080 } ``` ## Benchmarks Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httprouter) [See all benchmarks](/BENCHMARKS.md) Benchmark name | (1) | (2) | (3) | (4) --------------------------------|----------:|----------:|----------:|------: BenchmarkAce_GithubAll | 10000 | 109482 | 13792 | 167 BenchmarkBear_GithubAll | 10000 | 287490 | 79952 | 943 BenchmarkBeego_GithubAll | 3000 | 562184 | 146272 | 2092 BenchmarkBone_GithubAll | 500 | 2578716 | 648016 | 8119 BenchmarkDenco_GithubAll | 20000 | 94955 | 20224 | 167 BenchmarkEcho_GithubAll | 30000 | 58705 | 0 | 0 **BenchmarkGin_GithubAll** | **30000** | **50991** | **0** | **0** BenchmarkGocraftWeb_GithubAll | 5000 | 449648 | 133280 | 1889 BenchmarkGoji_GithubAll | 2000 | 689748 | 56113 | 334 BenchmarkGoJsonRest_GithubAll | 5000 | 537769 | 135995 | 2940 BenchmarkGoRestful_GithubAll | 100 | 18410628 | 797236 | 7725 BenchmarkGorillaMux_GithubAll | 200 | 8036360 | 153137 | 1791 BenchmarkHttpRouter_GithubAll | 20000 | 63506 | 13792 | 167 BenchmarkHttpTreeMux_GithubAll | 10000 | 165927 | 56112 | 334 BenchmarkKocha_GithubAll | 10000 | 171362 | 23304 | 843 BenchmarkMacaron_GithubAll | 2000 | 817008 | 224960 | 2315 BenchmarkMartini_GithubAll | 100 | 12609209 | 237952 | 2686 BenchmarkPat_GithubAll | 300 | 4830398 | 1504101 | 32222 BenchmarkPossum_GithubAll | 10000 | 301716 | 97440 | 812 BenchmarkR2router_GithubAll | 10000 | 270691 | 77328 | 1182 BenchmarkRevel_GithubAll | 1000 | 1491919 | 345553 | 5918 BenchmarkRivet_GithubAll | 10000 | 283860 | 84272 | 1079 BenchmarkTango_GithubAll | 5000 | 473821 | 87078 | 2470 BenchmarkTigerTonic_GithubAll | 2000 | 1120131 | 241088 | 6052 BenchmarkTraffic_GithubAll | 200 | 8708979 | 2664762 | 22390 BenchmarkVulcan_GithubAll | 5000 | 353392 | 19894 | 609 BenchmarkZeus_GithubAll | 2000 | 944234 | 300688 | 2648 (1): Total Repetitions (2): Single Repetition Duration (ns/op) (3): Heap Memory (B/op) (4): Average Allocations per Repetition (allocs/op) ## Gin v1. stable - [x] Zero allocation router. - [x] Still the fastest http router and framework. From routing to writing. - [x] Complete suite of unit tests - [x] Battle tested - [x] API frozen, new releases will not break your code. ## Start using it 1. Download and install it: ```sh $ go get gopkg.in/gin-gonic/gin.v1 ``` 2. Import it in your code: ```go import "gopkg.in/gin-gonic/gin.v1" ``` 3. (Optional) Import `net/http`. This is required for example if using constants such as `http.StatusOK`. ```go import "net/http" ``` ## API Examples #### Using GET, POST, PUT, PATCH, DELETE and OPTIONS ```go func main() { // Creates a gin router with default middleware: // logger and recovery (crash-free) middleware router := gin.Default() router.GET("/someGet", getting) router.POST("/somePost", posting) router.PUT("/somePut", putting) router.DELETE("/someDelete", deleting) router.PATCH("/somePatch", patching) router.HEAD("/someHead", head) router.OPTIONS("/someOptions", options) // By default it serves on :8080 unless a // PORT environment variable was defined. router.Run() // router.Run(":3000") for a hard coded port } ``` #### Parameters in path ```go func main() { router := gin.Default() // This handler will match /user/john but will not match neither /user/ or /user router.GET("/user/:name", func(c *gin.Context) { name := c.Param("name") c.String(http.StatusOK, "Hello %s", name) }) // However, this one will match /user/john/ and also /user/john/send // If no other routers match /user/john, it will redirect to /user/john/ router.GET("/user/:name/*action", func(c *gin.Context) { name := c.Param("name") action := c.Param("action") message := name + " is " + action c.String(http.StatusOK, message) }) router.Run(":8080") } ``` #### Querystring parameters ```go func main() { router := gin.Default() // Query string parameters are parsed using the existing underlying request object. // The request responds to a url matching: /welcome?firstname=Jane&lastname=Doe router.GET("/welcome", func(c *gin.Context) { firstname := c.DefaultQuery("firstname", "Guest") lastname := c.Query("lastname") // shortcut for c.Request.URL.Query().Get("lastname") c.String(http.StatusOK, "Hello %s %s", firstname, lastname) }) router.Run(":8080") } ``` ### Multipart/Urlencoded Form ```go func main() { router := gin.Default() router.POST("/form_post", func(c *gin.Context) { message := c.PostForm("message") nick := c.DefaultPostForm("nick", "anonymous") c.JSON(200, gin.H{ "status": "posted", "message": message, "nick": nick, }) }) router.Run(":8080") } ``` ### Another example: query + post form ``` POST /post?id=1234&page=1 HTTP/1.1 Content-Type: application/x-www-form-urlencoded name=manu&message=this_is_great ``` ```go func main() { router := gin.Default() router.POST("/post", func(c *gin.Context) { id := c.Query("id") page := c.DefaultQuery("page", "0") name := c.PostForm("name") message := c.PostForm("message") fmt.Printf("id: %s; page: %s; name: %s; message: %s", id, page, name, message) }) router.Run(":8080") } ``` ``` id: 1234; page: 1; name: manu; message: this_is_great ``` ### Another example: upload file References issue [#548](https://github.com/gin-gonic/gin/issues/548). ```go func main() { router := gin.Default() router.POST("/upload", func(c *gin.Context) { file, header , err := c.Request.FormFile("upload") filename := header.Filename fmt.Println(header.Filename) out, err := os.Create("./tmp/"+filename+".png") if err != nil { log.Fatal(err) } defer out.Close() _, err = io.Copy(out, file) if err != nil { log.Fatal(err) } }) router.Run(":8080") } ``` #### Grouping routes ```go func main() { router := gin.Default() // Simple group: v1 v1 := router.Group("/v1") { v1.POST("/login", loginEndpoint) v1.POST("/submit", submitEndpoint) v1.POST("/read", readEndpoint) } // Simple group: v2 v2 := router.Group("/v2") { v2.POST("/login", loginEndpoint) v2.POST("/submit", submitEndpoint) v2.POST("/read", readEndpoint) } router.Run(":8080") } ``` #### Blank Gin without middleware by default Use ```go r := gin.New() ``` instead of ```go r := gin.Default() ``` #### Using middleware ```go func main() { // Creates a router without any middlewar