mirror of https://github.com/go-gitea/gitea
Clarify path param naming (#32969)
In history (from some legacy frameworks), both `:name` and `name` are supported as path path name, `:name` is an alias to `name`. To make code consistent, now we should only use `name` but not `:name`. Also added panic check in related functions to make sure the name won't be abused in case some downstreams still use them.pull/32967/head^2
parent
b8b690feb9
commit
2a828e2798
@ -0,0 +1,72 @@ |
||||
// Copyright 2024 The Gitea Authors. All rights reserved.
|
||||
// SPDX-License-Identifier: MIT
|
||||
|
||||
package context |
||||
|
||||
import ( |
||||
"strconv" |
||||
"strings" |
||||
|
||||
"code.gitea.io/gitea/modules/optional" |
||||
) |
||||
|
||||
// FormString returns the first value matching the provided key in the form as a string
|
||||
func (b *Base) FormString(key string) string { |
||||
return b.Req.FormValue(key) |
||||
} |
||||
|
||||
// FormStrings returns a string slice for the provided key from the form
|
||||
func (b *Base) FormStrings(key string) []string { |
||||
if b.Req.Form == nil { |
||||
if err := b.Req.ParseMultipartForm(32 << 20); err != nil { |
||||
return nil |
||||
} |
||||
} |
||||
if v, ok := b.Req.Form[key]; ok { |
||||
return v |
||||
} |
||||
return nil |
||||
} |
||||
|
||||
// FormTrim returns the first value for the provided key in the form as a space trimmed string
|
||||
func (b *Base) FormTrim(key string) string { |
||||
return strings.TrimSpace(b.Req.FormValue(key)) |
||||
} |
||||
|
||||
// FormInt returns the first value for the provided key in the form as an int
|
||||
func (b *Base) FormInt(key string) int { |
||||
v, _ := strconv.Atoi(b.Req.FormValue(key)) |
||||
return v |
||||
} |
||||
|
||||
// FormInt64 returns the first value for the provided key in the form as an int64
|
||||
func (b *Base) FormInt64(key string) int64 { |
||||
v, _ := strconv.ParseInt(b.Req.FormValue(key), 10, 64) |
||||
return v |
||||
} |
||||
|
||||
// FormBool returns true if the value for the provided key in the form is "1", "true" or "on"
|
||||
func (b *Base) FormBool(key string) bool { |
||||
s := b.Req.FormValue(key) |
||||
v, _ := strconv.ParseBool(s) |
||||
v = v || strings.EqualFold(s, "on") |
||||
return v |
||||
} |
||||
|
||||
// FormOptionalBool returns an optional.Some(true) or optional.Some(false) if the value
|
||||
// for the provided key exists in the form else it returns optional.None[bool]()
|
||||
func (b *Base) FormOptionalBool(key string) optional.Option[bool] { |
||||
value := b.Req.FormValue(key) |
||||
if len(value) == 0 { |
||||
return optional.None[bool]() |
||||
} |
||||
s := b.Req.FormValue(key) |
||||
v, _ := strconv.ParseBool(s) |
||||
v = v || strings.EqualFold(s, "on") |
||||
return optional.Some(v) |
||||
} |
||||
|
||||
func (b *Base) SetFormString(key, value string) { |
||||
_ = b.Req.FormValue(key) // force parse form
|
||||
b.Req.Form.Set(key, value) |
||||
} |
@ -0,0 +1,47 @@ |
||||
// Copyright 2024 The Gitea Authors. All rights reserved.
|
||||
// SPDX-License-Identifier: MIT
|
||||
|
||||
package context |
||||
|
||||
import ( |
||||
"net/url" |
||||
"strconv" |
||||
"strings" |
||||
|
||||
"code.gitea.io/gitea/modules/setting" |
||||
|
||||
"github.com/go-chi/chi/v5" |
||||
) |
||||
|
||||
// PathParam returns the param in request path, eg: "/{var}" => "/a%2fb", then `var == "a/b"`
|
||||
func (b *Base) PathParam(name string) string { |
||||
s, err := url.PathUnescape(b.PathParamRaw(name)) |
||||
if err != nil && !setting.IsProd { |
||||
panic("Failed to unescape path param: " + err.Error() + ", there seems to be a double-unescaping bug") |
||||
} |
||||
return s |
||||
} |
||||
|
||||
// PathParamRaw returns the raw param in request path, eg: "/{var}" => "/a%2fb", then `var == "a%2fb"`
|
||||
func (b *Base) PathParamRaw(name string) string { |
||||
if strings.HasPrefix(name, ":") { |
||||
setting.PanicInDevOrTesting("path param should not start with ':'") |
||||
name = name[1:] |
||||
} |
||||
return chi.URLParam(b.Req, name) |
||||
} |
||||
|
||||
// PathParamInt64 returns the param in request path as int64
|
||||
func (b *Base) PathParamInt64(p string) int64 { |
||||
v, _ := strconv.ParseInt(b.PathParam(p), 10, 64) |
||||
return v |
||||
} |
||||
|
||||
// SetPathParam set request path params into routes
|
||||
func (b *Base) SetPathParam(name, value string) { |
||||
if strings.HasPrefix(name, ":") { |
||||
setting.PanicInDevOrTesting("path param should not start with ':'") |
||||
name = name[1:] |
||||
} |
||||
chi.RouteContext(b).URLParams.Add(name, url.PathEscape(value)) |
||||
} |
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue