09.gin/

directory
v0.0.0-...-d0adc60 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 14, 2024 License: MIT

README

Gin Web framework

github

01.QuickStart
  • run example
go get github.com/gin-gonic/gin
cd 01.QuickStart;
go run example.go
curl http://localhost:8080/ping
02.Router
  • Using GET, POST, PUT, PATCH, DELETE and OPTIONS
  • run example
go get github.com/gin-gonic/gin
cd 02.Router;
go run example.go

curl -X GET localhost:8080/someGet
curl -X POST localhost:8080/somePost
curl -X PUT localhost:8080/somePut
curl -X DELETE localhost:8080/someDelete
curl -X PATCH localhost:8080/somePatch
curl -X HEAD localhost:8080/someHead
curl -X OPTIONS localhost:8080/someOptions
03.Parameters
  • Parameters in path
  • run example
go get github.com/gin-gonic/gin
cd 03.Parameters
go run example.go

curl -X GET localhost:8080/user/john
curl -X GET localhost:8080/user/john/run
curl -X POST localhost:8080/user/john/run
04.QueryString
  • QueryString parameters
  • run example
go get github.com/gin-gonic/gin
cd 04.QueryString;
go run example.go

curl -X GET "http://localhost:8080/welcome?firstname=Jane&lastname=Doe"
05.Multipart
  • Multipart/Urlencoded Form
  • run example
go get github.com/gin-gonic/gin
cd 05.Multipart
go run example.go

curl --form message="hello world" --form nick="john" http://localhost:8080/form_post
06.PostForm
  • query + post form
  • run example
go get github.com/gin-gonic/gin
cd 06.PostForm
go run example.go

curl --form message="hello world" --form name="john" "http://localhost:8080/post?id=1001&page=1"
07.Map
  • Map as querystring or postform parameters
  • run example
go get github.com/gin-gonic/gin
cd 07.Map
go run example.go

curl -d "names[first]=thinkerou&names[second]=tianou" -X POST "http://localhost:8080/post?ids[a]=1234&ids[b]=hello"
08.UploadFiles
1) Single file
go get github.com/gin-gonic/gin
cd 08.UploadFiles
go run singlefile.go

curl -X POST http://localhost:8080/upload \
  -F "file=@/go/src/README.md" \
  -H "Content-Type: multipart/form-data"
2) Multiple files
go get github.com/gin-gonic/gin
cd 08.UploadFiles
go run multiplefiles.go

curl -X POST http://localhost:8080/upload \
  -F "upload[]=@/go/src/README.md" \
  -F "upload[]=@/go/src/LICENSE" \
  -H "Content-Type: multipart/form-data"
09.GroupingRoutes
  • Grouping Routes
  • run example
go get github.com/gin-gonic/gin
cd 09.GroupingRoutes
go run example.go

curl -d "body" -X POST "http://localhost:8080/v1/login"
curl -d "body" -X POST "http://localhost:8080/v2/login"
10.UsingMiddleware
  • Using middleware
  • run example
go get github.com/gin-gonic/gin
cd 10.UsingMiddleware
go run example.go

curl -X GET "http://localhost:8080/benchmark"
curl -d "body" -X POST "http://localhost:8080/login"
curl -d "body" -X POST "http://localhost:8080/submit"
curl -d "body" -X POST "http://localhost:8080/read"
curl -X GET "http://localhost:8080/testing/analytics"
11.log
  • write log
  • run example
go get github.com/gin-gonic/gin
cd 11.log
go run example.go

curl -X GET "http://localhost:8080/ping"
12.customlog
  • custom log format
  • run example
go get github.com/gin-gonic/gin
cd 12.customlog
go run example.go

curl -X GET "http://localhost:8080/ping"
13.ModelBinding
  • Model binding and validation
  • run example
go get github.com/gin-gonic/gin
cd 13.ModelBinding
go run example.go

curl -v -d '{"user" : "manu", "password" : "123"}' -H 'content-type: application/json' -X POST "http://localhost:8080/loginJSON"
curl -v -d '{"user" : "manu"}' -H 'content-type: application/json' -X POST "http://localhost:8080/loginJSON"
curl -v -d '{"user" : "manu", "password" : "012"}' -H 'content-type: application/json' -X POST "http://localhost:8080/loginJSON"

curl -v -d '<?xml version="1.0" encoding="UTF-8"?><root><user>manu</user><password>123</password></root>' -H 'content-type: application/xml' -X POST "http://localhost:8080/loginXML"

curl -v -d 'user=manu&password=123' -X POST "http://localhost:8080/loginForm"
curl -v -X POST "http://localhost:8080/loginForm?user=manu&password=123"
14.CustomValidator
  • register custom validators
  • run example
go get github.com/gin-gonic/gin
go get github.com/go-playground/validator
cd 14.CustomValidator
go run example.go

curl -v -X GET "http://localhost:8080/bookable?check_in=2018-04-16&check_out=2018-04-17"
curl -v -X GET "http://localhost:8080/bookable?check_in=2018-04-16&check_out=2018-03-17"
15.BindQuery
  • run example for Only Bind Query String
go get github.com/gin-gonic/gin
cd 15.BindQuery
go run OnlyBindQuery.go

curl -X GET "http://localhost:8080/testing?name=eason&address=xyz"
curl -X POST "http://localhost:8080/testing?name=eason&address=xyz" --data 'name=ignore&address=ignore' -H "Content-Type:application/x-www-form-urlencoded"
  • run example to Bind Query String or Post Data
go run BindQueryString.go

curl -X GET "http://localhost:8080/testing?name=appleboy&address=xyz&birthday=1992-03-15&createTime=1562400033000000123&unixTime=1562400033"
curl -X POST "http://localhost:8080/testing?name=appleboy&address=xyz&birthday=1992-03-15&createTime=1562400033000000123&unixTime=1562400033"
curl -v -d '{"name" : "appleboy", "address" : "xyz", "birthday" : "1992-03-15", "createTime" : 1562400033000000123, "unixTime" : 1562400033 }' -H 'content-type: application/json' -X POST "http://localhost:8080/testing"
  • run example to Bind Uri
go run BindUri.go

curl -v -X GET "http://localhost:8080/thinkerou/987fbc97-4bed-5078-9f07-9141ba07c9f3"
curl -v -X GET "http://localhost:8080/thinkerou/not-uuid"
  • run example to Bind Header
go run BindHeader.go

curl -v -H "rate:300" -H "domain:music" -X GET "http://localhost:8080"
  • run example to bind Multipart/Urlencode
go run BindMultipart

curl -X POST -v --form name=user --form "avatar=@./README.md" http://localhost:8080/profile
16.ProtoBuf
  • run example for XML, JSON, YAML and ProtoBuf rendering
go get github.com/gin-gonic/gin
cd testdata; make ; cd ..;
go run 16.ProtoBuf/protobuf.go

curl -v -X GET "http://localhost:8080/someJSON"
curl -v -X GET "http://localhost:8080/moreJSON"
curl -v -X GET "http://localhost:8080/someXML"
curl -v -X GET "http://localhost:8080/someYAML"
curl -v -X GET "http://localhost:8080/someProtoBuf"
  • run example for SecureJSON
go run 16.ProtoBuf/securejson.go

curl -v -X GET "http://localhost:8080/someJSON"
  • run example for JSONP
go run 16.ProtoBuf/jsonp.go

curl -v -X GET "http://localhost:8080/JSONP?callback=x"
  • run example for AsciiJSON
go run 16.ProtoBuf/asciijson.go

curl -v -X GET "http://localhost:8080/someJSON"
  • run example for PureJSON
go run 16.ProtoBuf/purejson.go

curl -v -X GET "http://localhost:8080/json"
curl -v -X GET "http://localhost:8080/purejson"
17.Serving
  • run example to serving static files
go get github.com/gin-gonic/gin
go run 17.Serving/staticfiles.go

curl -v -X GET "http://localhost:8080/assets/test.txt"
curl -v -X GET "http://localhost:8080/more_static/test.txt"
  • run example to serving data from reader
go get github.com/gin-gonic/gin
go run 17.Serving/dataFromReader.go

curl -v -X GET "http://localhost:8080/someDataFromReader" --output gopher.png
18.Rendering
  • run example to using LoadHTMLGlob
go run 18.Rendering/loadhtml.go

curl -v -X GET "http://localhost:8080/index"
  • run example to Using templates with same name in different directories
go run 18.Rendering/loadhtml.go

curl -v -X GET "http://localhost:8080/posts/index"
curl -v -X GET "http://localhost:8080/users/index"
  • run example to Using Custom Template Funcs
go run 18.Rendering/customtempl.go

curl -v -X GET "http://localhost:8080/raw"
19.multitemplate
  • run simple example using multitemplate
go get github.com/gin-contrib/multitemplate
go run 19.multitemplate/simple.go

curl -v -X GET "http://localhost:8080/"
curl -v -X GET "http://localhost:8080/article"
20.Redirect
  • run example to HTTP redirect
go run 20.redirect/example.go

curl -v -iL -X GET "http://localhost:8080/test"
curl -v -iL -X GET "http://localhost:8080/test1"
curl -v -iL -X GET "http://localhost:8080/test2"
21.Middleware
  • run example to custom middleware
go run 21.middleware/custom.go

curl -v -X GET "http://localhost:8080/test"
  • run example to using basicAuth middleware
go run 21.middleware/basicauth.go

curl -u foo:bar -v -X GET "http://localhost:8080/admin/secrets"
  • run example to using goroutines inside a middleware
go run 21.middleware/goroutines.go

curl -v -X GET "http://localhost:8080/long_async"
curl -v -X GET "http://localhost:8080/long_sync"
22.CustomConfig
  • run example to using custom HTTP configuration
go run 22.customconfig/example.go

curl -v -X GET "http://localhost:8080/"
23.Encrypt
  • run example for 1-line LetsEncrypt HTTPS Server
go get github.com/gin-gonic/autotls
go run 23.Encrypt/example01.go

curl -v -X GET "https://127-0-0-1.sslip.io/ping"
curl -v -X GET "https://172-17-0-2.sslip.io/ping"
  • run example for custom autocert manager.
go run 23.Encrypt/example02.go

curl -v -X GET "https://127-0-0-1.sslip.io/ping"
curl -v -X GET "https://172-17-0-2.sslip.io/ping"
curl -v -X GET "https://172-17-0-2.nip.io/ping"
24.multiple
  • run example to run multiple service using Gin
go get golang.org/x/sync/errgroup
go run 24.multiple/example.go

curl -v -X GET "http://127.0.0.1:8080"
curl -v -X GET "http://127.0.0.1:8081"
25.graceful
  • run example to stop graceful
go run 25.graceful/example.go
26.formdata
  • run example to Bind form-data request with custom struct
go run 26.formdata/example.go

curl -v -X GET "http://localhost:8080/getb?field_a=hello&field_b=world"
curl -v -X GET "http://localhost:8080/getc?field_a=hello&field_c=world"
curl -v -X GET "http://localhost:8080/getd?field_x=hello&field_d=world"

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.