descriptor

type Annotation interface {
	// Equal assert the given key/value is this Annotation
	Equal(key, value string) bool // for search
	// Handle the handle function of the Annotation
	Handle() interface{} // one of NewHttpMapping/NewKeyMapping/NewValueMapping/NewRoute
}

type Cookies map[string]string

type FieldDescriptor struct {
	Name         string // field name
	Alias        string // alias name
	ID           int32
	Required     bool
	Optional     bool
	DefaultValue interface{}
	IsException  bool
	Type         *TypeDescriptor
	HTTPMapping  HTTPMapping
	ValueMapping ValueMapping
}

type FiledMapping interface {
	Handle(field *FieldDescriptor)
}

type FunctionDescriptor struct {
	Name           string
	Oneway         bool
	Request        *TypeDescriptor
	Response       *TypeDescriptor
	HasRequestBase bool
}

type HTTPMapping interface {
	// get value from request
	Request(ctx context.Context, req *HTTPRequest, field *FieldDescriptor) (interface{}, bool, error)
	// set value to response
	Response(ctx context.Context, resp *HTTPResponse, field *FieldDescriptor, val interface{}) error
}

type HTTPRequest struct {
	Header      http.Header
	Query       url.Values
	Cookies     Cookies
	Method      string
	Host        string
	Path        string
	Params      *Params // path params
	RawBody     []byte
	Body        map[string]interface{}
	GeneralBody interface{} // body of other representation, used with ContentType
	ContentType MIMEType
}

type HTTPResponse struct {
	Header      http.Header
	StatusCode  int32
	Body        map[string]interface{}
	GeneralBody interface{} // body of other representation, used with ContentType
	ContentType MIMEType
	Renderer    Renderer
}

type JsonRenderer struct{}

type MIMEType string

type NewFieldMapping func(value string) FiledMapping

type NewHTTPMapping func(value string) HTTPMapping

type NewRoute func(value string, function *FunctionDescriptor) Route

type NewValueMapping func(value string) ValueMapping

type Param struct {
	Key   string
	Value string
}

type Params struct {
	// contains filtered or unexported fields
}

type PbRenderer struct{}

type Renderer interface {
	Render(w http.ResponseWriter, body interface{}) error
	WriteContentType(w http.ResponseWriter)
}

type Route interface {
	Method() string
	Path() string
	Function() *FunctionDescriptor
}

type Router interface {
	// Handle register Route to Router
	Handle(rt Route)
	// Lookup FunctionDescriptor from HTTPRequest
	Lookup(req *HTTPRequest) (*FunctionDescriptor, error)
}

type ServiceDescriptor struct {
	Name      string
	Functions map[string]*FunctionDescriptor
	Router    Router
}

type StructDescriptor struct {
	Name           string
	FieldsByID     map[int32]*FieldDescriptor
	FieldsByName   map[string]*FieldDescriptor
	RequiredFields map[int32]*FieldDescriptor
	DefaultFields  map[string]*FieldDescriptor
}

type Type byte

type TypeDescriptor struct {
	Name          string
	Type          Type
	Key           *TypeDescriptor   // for map key
	Elem          *TypeDescriptor   // for slice or map element
	Struct        *StructDescriptor // for struct
	IsRequestBase bool
}

type ValueMapping interface {
	Request(ctx context.Context, val interface{}, field *FieldDescriptor) (interface{}, error)
	Response(ctx context.Context, val interface{}, field *FieldDescriptor) (interface{}, error)
}

type Void struct{}