feat: new http binding

Author: xiaost

http/binding/binding.go

@@ -0,0 +1,133 @@
+/*
+ * Copyright 2025 CloudWeGo Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package binding
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"reflect"
+)
+
+// Decoder decodes request data into a struct.
+// The Decode method binds values from RequestContext into the provided value v,
+// which must be a pointer to a struct.
+type Decoder interface {
+	Decode(req RequestContext, v any) (bool, error)
+}
+
+type fieldDecoder interface {
+	Decode(req RequestContext, rv reflect.Value) (bool, error)
+	GetFieldName() string
+}
+
+type DecodeConfig struct {
+	// JSONUnmarshalFunc is the function used for JSON unmarshaling
+	// If nil, will use encoding/json.Unmarshal as default
+	JSONUnmarshalFunc func(data []byte, v interface{}) error
+
+	// Tags specifies the tags to use for decoding in order of preference.
+	// If not set (nil or empty), the default tags are used: path, form, query, cookie, header
+	// If set (e.g., []string{"form", "query"}), only the specified tags are used in the given order.
+	Tags []string
+}
+
+func (c *DecodeConfig) getJSONUnmarshal() func(data []byte, v interface{}) error {
+	if c.JSONUnmarshalFunc != nil {
+		return c.JSONUnmarshalFunc
+	}
+	// Default to encoding/json
+	return json.Unmarshal
+}
+
+// NewDecoder creates a new Decoder for the given struct type.
+// The rt parameter must be a pointer to struct type (e.g., reflect.TypeOf((*MyStruct)(nil))).
+// The config parameter specifies decoding behavior (tags, JSON unmarshaler, etc.).
+// If config is nil, default configuration is used.
+//
+// Supported struct tags (in default priority order):
+//   - path: binds from path parameters
+//   - form: binds from POST form data, falls back to query parameters
+//   - query: binds from URL query parameters
+//   - cookie: binds from HTTP cookies
+//   - header: binds from HTTP headers
+//
+// Returns an error if rt is not a pointer to struct type.
+func NewDecoder(rt reflect.Type, config *DecodeConfig) (Decoder, error) {
+	if rt.Kind() != reflect.Pointer {
+		return nil, errors.New("not pointer type")
+	}
+	rt = rt.Elem()
+	if rt.Kind() != reflect.Struct {
+		return nil, fmt.Errorf("unsupported %s type binding", rt)
+	}
+	if config == nil {
+		config = &DecodeConfig{}
+	}
+	return newStructDecoder(rt, config)
+}
+
+func getFieldDecoder(fi *fieldInfo) (fieldDecoder, error) {
+	ft := fi.fieldType
+
+	fp := reflect.PointerTo(ft)
+	// Priority: UnmarshalParam (custom) > TextUnmarshaler (standard) > base types
+	if fp.Implements(paramUnmarshalerType) {
+		return newUnmarshalParamDecoder(fi), nil
+	}
+	if fp.Implements(textUnmarshalerType) {
+		return newTextUnmarshalerDecoder(fi), nil
+	}
+
+	switch ft.Kind() {
+	case reflect.Slice, reflect.Array:
+		elemType := dereferenceType(ft.Elem())
+		// Check if it's a file slice
+		if elemType == fileBindingType {
+			return newFileTypeSliceDecoder(fi), nil
+		}
+
+		ep := reflect.PointerTo(elemType)
+		// Check if element type implements UnmarshalParam
+		if ep.Implements(paramUnmarshalerType) {
+			return newUnmarshalParamSliceDecoder(fi), nil
+		}
+		// Check if element type implements TextUnmarshaler
+		if ep.Implements(textUnmarshalerType) {
+			return newTextUnmarshalerSliceDecoder(fi), nil
+		}
+		return newSliceDecoder(fi), nil
+
+	case reflect.Struct:
+		if ft == fileBindingType {
+			return newFileTypeDecoder(fi), nil
+		}
+	}
+	return newBaseDecoder(fi), nil
+}
+
+type textUnmarshaler interface {
+	UnmarshalText(text []byte) error
+}
+
+var textUnmarshalerType = reflect.TypeOf((*textUnmarshaler)(nil)).Elem()
+
+type paramUnmarshaler interface {
+	UnmarshalParam(param string) error
+}
+
+var paramUnmarshalerType = reflect.TypeOf((*paramUnmarshaler)(nil)).Elem()

http/binding/binding_base.go

@@ -0,0 +1,203 @@
+/*
+ * Copyright 2025 CloudWeGo Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package binding
+
+import (
+	"fmt"
+	"reflect"
+	"strconv"
+)
+
+type baseDecoder struct {
+	*fieldInfo
+
+	decodeValue func(rv reflect.Value, s string) error
+}
+
+func newBaseDecoder(fi *fieldInfo) fieldDecoder {
+	decoder := &baseDecoder{fieldInfo: fi}
+	fn := getBaseDecodeByKind(fi.fieldType.Kind())
+	if fn == nil {
+		// Use method that has access to jsonUnmarshal
+		fn = decoder.decodeJSONValue
+	}
+	decoder.decodeValue = fn
+	return decoder
+}
+
+func (d *baseDecoder) Decode(req RequestContext, rv reflect.Value) (bool, error) {
+	v, ok, err := d.FetchBindValue(req)
+	if !ok || err != nil {
+		return false, err
+	}
+
+	f := d.FieldSetter(rv)
+	rv = f.Value()
+
+	s := b2s(v)
+	if err := d.decodeValue(rv, s); err != nil {
+		f.Reset()
+		return false, fmt.Errorf("unable to decode '%s' as %s: %w", s, d.fieldType.String(), err)
+	}
+	return true, nil
+}
+
+// use slice for better performance,
+var type2decoder = [...]func(rv reflect.Value, s string) error{
+	reflect.Bool:    decodeBool,
+	reflect.Uint:    decodeUint,
+	reflect.Uint8:   decodeUint8,
+	reflect.Uint16:  decodeUint16,
+	reflect.Uint32:  decodeUint32,
+	reflect.Uint64:  decodeUint64,
+	reflect.Int:     decodeInt,
+	reflect.Int8:    decodeInt8,
+	reflect.Int16:   decodeInt16,
+	reflect.Int32:   decodeInt32,
+	reflect.Int64:   decodeInt64,
+	reflect.String:  decodeString,
+	reflect.Float32: decodeFloat32,
+	reflect.Float64: decodeFloat64,
+}
+
+func getBaseDecodeByKind(k reflect.Kind) (ret func(rv reflect.Value, s string) error) {
+	if int(k) >= len(type2decoder) {
+		return nil
+	}
+	return type2decoder[k]
+}
+
+// decodeJSONValue is a method on baseDecoder that uses the configured JSON unmarshal function
+func (d *baseDecoder) decodeJSONValue(rv reflect.Value, s string) error {
+	return d.jsonUnmarshal(s2b(s), rv.Addr().Interface())
+}
+
+func decodeBool(rv reflect.Value, s string) error {
+	v, err := strconv.ParseBool(s)
+	if err == nil {
+		*(*bool)(rvUnsafePointer(&rv)) = v
+	}
+	return err
+
+}
+
+func decodeUint(rv reflect.Value, s string) error {
+	v, err := strconv.ParseUint(s, 10, 0)
+	if err == nil {
+		*(*uint)(rvUnsafePointer(&rv)) = uint(v)
+	}
+	return err
+
+}
+
+func decodeUint8(rv reflect.Value, s string) error {
+	v, err := strconv.ParseUint(s, 10, 8)
+	if err == nil {
+		*(*uint8)(rvUnsafePointer(&rv)) = uint8(v)
+	}
+	return err
+
+}
+
+func decodeUint16(rv reflect.Value, s string) error {
+	v, err := strconv.ParseUint(s, 10, 16)
+	if err == nil {
+		*(*uint16)(rvUnsafePointer(&rv)) = uint16(v)
+	}
+	return err
+}
+
+func decodeUint32(rv reflect.Value, s string) error {
+	v, err := strconv.ParseUint(s, 10, 32)
+	if err == nil {
+		*(*uint32)(rvUnsafePointer(&rv)) = uint32(v)
+	}
+	return err
+
+}
+
+func decodeUint64(rv reflect.Value, s string) error {
+	v, err := strconv.ParseUint(s, 10, 64)
+	if err == nil {
+		*(*uint64)(rvUnsafePointer(&rv)) = v
+	}
+	return err
+
+}
+
+func decodeInt(rv reflect.Value, s string) error {
+	v, err := strconv.Atoi(s)
+	if err == nil {
+		*(*int)(rvUnsafePointer(&rv)) = v
+	}
+	return err
+
+}
+
+func decodeInt8(rv reflect.Value, s string) error {
+	v, err := strconv.ParseInt(s, 10, 8)
+	if err == nil {
+		*(*int8)(rvUnsafePointer(&rv)) = int8(v)
+	}
+	return err
+
+}
+
+func decodeInt16(rv reflect.Value, s string) error {
+	v, err := strconv.ParseInt(s, 10, 16)
+	if err == nil {
+		*(*int16)(rvUnsafePointer(&rv)) = int16(v)
+	}
+	return err
+}
+
+func decodeInt32(rv reflect.Value, s string) error {
+	v, err := strconv.ParseInt(s, 10, 32)
+	if err == nil {
+		*(*int32)(rvUnsafePointer(&rv)) = int32(v)
+	}
+	return err
+}
+
+func decodeInt64(rv reflect.Value, s string) error {
+	v, err := strconv.ParseInt(s, 10, 64)
+	if err == nil {
+		*(*int64)(rvUnsafePointer(&rv)) = v
+	}
+	return err
+}
+
+func decodeString(rv reflect.Value, s string) error {
+	*(*string)(rvUnsafePointer(&rv)) = s
+	return nil
+}
+
+func decodeFloat32(rv reflect.Value, s string) error {
+	v, err := strconv.ParseFloat(s, 32)
+	if err == nil {
+		*(*float32)(rvUnsafePointer(&rv)) = float32(v)
+	}
+	return err
+}
+
+func decodeFloat64(rv reflect.Value, s string) error {
+	v, err := strconv.ParseFloat(s, 64)
+	if err == nil {
+		*(*float64)(rvUnsafePointer(&rv)) = v
+	}
+	return err
+}