codec

type Decoder interface {
	Decode(v any) error
}

type DecoderFunc func(v any) error

type Encoder interface {
	Encode(v any) error
}

type EncoderFunc func(v any) error

type FormCodec interface {
	Encode(v any) (url.Values, error)
	Decode(vs url.Values, v any) error
}

type FormMarshaler interface {
	Marshaler
	FormCodec
}

type Marshaler interface {
	// ContentType returns the Content-Type which this marshaler is responsible for.
	// The parameter describes the type which is being marshalled, which can sometimes
	// affect the content type returned.
	ContentType(v any) string
	// Marshal marshals "v" into byte sequence.
	Marshal(v any) ([]byte, error)
	// Unmarshal unmarshals "data" into "v".
	// "v" must be a pointer value.
	Unmarshal(data []byte, v any) error
	// NewDecoder returns a Decoder which reads byte sequence from "r".
	NewDecoder(r io.Reader) Decoder
	// NewEncoder returns an Encoder which writes bytes sequence into "w".
	NewEncoder(w io.Writer) Encoder
}

type UriEncoder interface {
	// EncodeURL encode v to url path.
	// pathTemplate is a template of url path like http://helloworld.dev/{name}/sub/{sub.name},
	EncodeURL(pathTemplate string, v any, needQuery bool) string
}

type UriMarshaler interface {
	Marshaler
	FormCodec
	UriEncoder
}