Documentation
¶
Index ¶
- Constants
- Variables
- func ExecuteFunc(ctx context.Context, fn, param interface{}, cType contentType) (interface{}, bool, error)
- func Handler(fn, param interface{}, cType contentType) (http.Handler, error)
- func Render(w http.ResponseWriter, data interface{}, cType contentType)
- func RenderStatus(w http.ResponseWriter, statusCode int, data interface{}, cType contentType)
- func ReqBodyHandler(fn interface{}, cType contentType) (http.Handler, error)
- type OptString
- type RawObject
Constants ¶
const ( JSON contentType = iota HALJSON HEALTHJSON )
Variables ¶
var DefaultResponse = json.RawMessage(`{"message":"ok"}`)
var ErrBadRequest = errors.New("bad request")
var ErrNotJSONObject = errors.New("input is not a json object")
ErrNotJSONObject is returned when Object.UnmarshalJSON is called with bytes not representing a valid json object. A valid json object means it starts with `null` or `{`, not `[`.
Functions ¶
func ExecuteFunc ¶
func ExecuteFunc(ctx context.Context, fn, param interface{}, cType contentType) (interface{}, bool, error)
ExecuteFunc executes the fn with the param after checking whether the function signature is valid or not by calling Handler. The first return value is the result that fn returns. The second return value is a boolean indicating whether the caller should panic on the err or not. If it's true, it means the caller can process the error normally; if it's false, it means the caller should probably panic on the error. The third return value is an error either from Handler() or from fn, if any.
func Handler ¶
Handler returns an HTTP Handler for function fn. If fn returns a non-nil error, the handler will use problem.Render. Please refer to funcParamType for the allowed function signature. The caller of this function should probably panic on the returned error, if any.
func Render ¶
func Render(w http.ResponseWriter, data interface{}, cType contentType)
Render write data to w, after marshaling to json. The response header is set based on cType.
func RenderStatus ¶
func RenderStatus(w http.ResponseWriter, statusCode int, data interface{}, cType contentType)
RenderStatus write data to w, after marshaling to json. The response header is set based on cType. The response status code is set to the statusCode.
func ReqBodyHandler ¶
ReqBodyHandler returns an HTTP Handler for function fn. If fn has an input type, it will try to decode the request body into the function's input type. If fn returns a non-nil error, the handler will use problem.Render. Please refer to funcParamType for the allowed function signature. The caller of this function should probably panic on the returned error, if any.
Types ¶
type OptString ¶
This type is used to tell whether a JSON key is presented with its value being a JSON null value or is not presented.
func (*OptString) UnmarshalJSON ¶
type RawObject ¶
type RawObject []byte
RawObject can be used directly to make sure that what's in the request body is not a json array:
func example(ctx context.Context, in httpjson.RawObject)
It can also be used as a field in a struct:
type example struct {
name string
extra httpjson.RawObject
}
In this case, Unmarshaler will check whether extra is a json object ot not. It will error if extra is a json number/string/array/boolean.
RawObject also implements Marshaler so that we would populate an empty json object is extra is not set.
Source Files