2014-08-29 21:49:50 +04:00
|
|
|
// Copyright 2014 Manu Martinez-Almeida. All rights reserved.
|
|
|
|
// Use of this source code is governed by a MIT style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
2014-07-16 22:14:03 +04:00
|
|
|
package gin
|
|
|
|
|
|
|
|
import (
|
|
|
|
"encoding/xml"
|
2015-05-19 23:18:58 +03:00
|
|
|
"net/http"
|
2015-08-16 17:19:51 +03:00
|
|
|
"os"
|
2015-04-07 13:22:38 +03:00
|
|
|
"path"
|
2014-08-19 05:40:52 +04:00
|
|
|
"reflect"
|
|
|
|
"runtime"
|
2014-08-31 00:22:57 +04:00
|
|
|
"strings"
|
2022-03-17 06:56:16 +03:00
|
|
|
"unicode"
|
2014-07-16 22:14:03 +04:00
|
|
|
)
|
|
|
|
|
2018-09-15 05:23:32 +03:00
|
|
|
// BindKey indicates a default bind key.
|
2015-06-13 00:42:54 +03:00
|
|
|
const BindKey = "_gin-gonic/gin/bindkey"
|
|
|
|
|
2018-09-15 05:23:32 +03:00
|
|
|
// Bind is a helper function for given interface object and returns a Gin middleware.
|
2022-03-21 04:43:17 +03:00
|
|
|
func Bind(val any) HandlerFunc {
|
2015-06-13 01:01:02 +03:00
|
|
|
value := reflect.ValueOf(val)
|
|
|
|
if value.Kind() == reflect.Ptr {
|
|
|
|
panic(`Bind struct can not be a pointer. Example:
|
|
|
|
Use: gin.Bind(Struct{}) instead of gin.Bind(&Struct{})
|
|
|
|
`)
|
|
|
|
}
|
|
|
|
typ := value.Type()
|
|
|
|
|
2015-06-13 00:42:54 +03:00
|
|
|
return func(c *Context) {
|
|
|
|
obj := reflect.New(typ).Interface()
|
|
|
|
if c.Bind(obj) == nil {
|
|
|
|
c.Set(BindKey, obj)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-09-15 05:23:32 +03:00
|
|
|
// WrapF is a helper function for wrapping http.HandlerFunc and returns a Gin middleware.
|
2015-05-20 01:39:52 +03:00
|
|
|
func WrapF(f http.HandlerFunc) HandlerFunc {
|
2015-05-19 23:18:58 +03:00
|
|
|
return func(c *Context) {
|
|
|
|
f(c.Writer, c.Request)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-09-15 05:23:32 +03:00
|
|
|
// WrapH is a helper function for wrapping http.Handler and returns a Gin middleware.
|
2015-05-20 01:39:52 +03:00
|
|
|
func WrapH(h http.Handler) HandlerFunc {
|
|
|
|
return func(c *Context) {
|
|
|
|
h.ServeHTTP(c.Writer, c.Request)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-04-17 05:54:40 +03:00
|
|
|
// H is a shortcut for map[string]interface{}
|
2022-03-21 04:43:17 +03:00
|
|
|
type H map[string]any
|
2014-07-16 22:14:03 +04:00
|
|
|
|
2017-08-16 06:55:50 +03:00
|
|
|
// MarshalXML allows type H to be used with xml.Marshal.
|
2014-07-16 22:14:03 +04:00
|
|
|
func (h H) MarshalXML(e *xml.Encoder, start xml.StartElement) error {
|
|
|
|
start.Name = xml.Name{
|
|
|
|
Space: "",
|
|
|
|
Local: "map",
|
|
|
|
}
|
|
|
|
if err := e.EncodeToken(start); err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
for key, value := range h {
|
|
|
|
elem := xml.StartElement{
|
|
|
|
Name: xml.Name{Space: "", Local: key},
|
|
|
|
Attr: []xml.Attr{},
|
|
|
|
}
|
|
|
|
if err := e.EncodeElement(value, elem); err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
}
|
2017-12-25 08:58:02 +03:00
|
|
|
|
|
|
|
return e.EncodeToken(xml.EndElement{Name: start.Name})
|
2014-07-16 22:14:03 +04:00
|
|
|
}
|
|
|
|
|
2016-01-28 02:35:09 +03:00
|
|
|
func assert1(guard bool, text string) {
|
|
|
|
if !guard {
|
|
|
|
panic(text)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-07-16 22:14:03 +04:00
|
|
|
func filterFlags(content string) string {
|
2014-10-09 03:40:42 +04:00
|
|
|
for i, char := range content {
|
|
|
|
if char == ' ' || char == ';' {
|
2014-07-16 22:14:03 +04:00
|
|
|
return content[:i]
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return content
|
|
|
|
}
|
2014-08-19 05:40:52 +04:00
|
|
|
|
2022-03-21 04:43:17 +03:00
|
|
|
func chooseData(custom, wildcard any) any {
|
2020-05-14 06:35:14 +03:00
|
|
|
if custom != nil {
|
|
|
|
return custom
|
|
|
|
}
|
|
|
|
if wildcard != nil {
|
2014-08-31 20:28:18 +04:00
|
|
|
return wildcard
|
2014-08-31 00:22:57 +04:00
|
|
|
}
|
2020-05-14 06:35:14 +03:00
|
|
|
panic("negotiation config is invalid")
|
2014-08-31 00:22:57 +04:00
|
|
|
}
|
|
|
|
|
2015-04-08 03:58:35 +03:00
|
|
|
func parseAccept(acceptHeader string) []string {
|
|
|
|
parts := strings.Split(acceptHeader, ",")
|
|
|
|
out := make([]string, 0, len(parts))
|
|
|
|
for _, part := range parts {
|
2020-10-15 08:55:57 +03:00
|
|
|
if i := strings.IndexByte(part, ';'); i > 0 {
|
|
|
|
part = part[:i]
|
|
|
|
}
|
|
|
|
if part = strings.TrimSpace(part); part != "" {
|
2015-04-08 03:58:35 +03:00
|
|
|
out = append(out, part)
|
|
|
|
}
|
2014-08-31 00:22:57 +04:00
|
|
|
}
|
2015-04-08 03:58:35 +03:00
|
|
|
return out
|
2014-08-31 00:22:57 +04:00
|
|
|
}
|
|
|
|
|
2014-10-08 23:37:26 +04:00
|
|
|
func lastChar(str string) uint8 {
|
2017-09-28 19:22:35 +03:00
|
|
|
if str == "" {
|
2015-04-08 03:58:35 +03:00
|
|
|
panic("The length of the string can't be 0")
|
2014-10-08 23:37:26 +04:00
|
|
|
}
|
2017-09-28 19:22:35 +03:00
|
|
|
return str[len(str)-1]
|
2014-10-08 23:37:26 +04:00
|
|
|
}
|
|
|
|
|
2022-03-21 04:43:17 +03:00
|
|
|
func nameOfFunction(f any) string {
|
2014-08-19 05:40:52 +04:00
|
|
|
return runtime.FuncForPC(reflect.ValueOf(f).Pointer()).Name()
|
|
|
|
}
|
2015-03-31 22:39:06 +03:00
|
|
|
|
2015-04-07 13:22:38 +03:00
|
|
|
func joinPaths(absolutePath, relativePath string) string {
|
2017-09-28 19:22:35 +03:00
|
|
|
if relativePath == "" {
|
2015-04-07 13:22:38 +03:00
|
|
|
return absolutePath
|
|
|
|
}
|
2015-04-08 16:32:50 +03:00
|
|
|
|
|
|
|
finalPath := path.Join(absolutePath, relativePath)
|
2020-05-14 06:35:14 +03:00
|
|
|
if lastChar(relativePath) == '/' && lastChar(finalPath) != '/' {
|
2015-04-08 16:32:50 +03:00
|
|
|
return finalPath + "/"
|
2015-03-31 22:39:06 +03:00
|
|
|
}
|
2015-04-08 16:32:50 +03:00
|
|
|
return finalPath
|
2015-03-31 22:39:06 +03:00
|
|
|
}
|
2015-08-16 17:19:51 +03:00
|
|
|
|
|
|
|
func resolveAddress(addr []string) string {
|
|
|
|
switch len(addr) {
|
|
|
|
case 0:
|
2017-09-28 19:22:35 +03:00
|
|
|
if port := os.Getenv("PORT"); port != "" {
|
2015-08-16 17:19:51 +03:00
|
|
|
debugPrint("Environment variable PORT=\"%s\"", port)
|
2020-03-23 12:48:25 +03:00
|
|
|
return ":" + port
|
2015-08-16 17:19:51 +03:00
|
|
|
}
|
2016-04-15 02:16:46 +03:00
|
|
|
debugPrint("Environment variable PORT is undefined. Using port :8080 by default")
|
2020-03-23 12:48:25 +03:00
|
|
|
return ":8080"
|
2015-08-16 17:19:51 +03:00
|
|
|
case 1:
|
|
|
|
return addr[0]
|
|
|
|
default:
|
2019-07-04 02:57:52 +03:00
|
|
|
panic("too many parameters")
|
2015-08-16 17:19:51 +03:00
|
|
|
}
|
|
|
|
}
|
2022-03-17 06:56:16 +03:00
|
|
|
|
|
|
|
// https://stackoverflow.com/questions/53069040/checking-a-string-contains-only-ascii-characters
|
|
|
|
func isASCII(s string) bool {
|
|
|
|
for i := 0; i < len(s); i++ {
|
|
|
|
if s[i] > unicode.MaxASCII {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return true
|
|
|
|
}
|