RESTful's Error is a construct meeting Go error interface.
It contains HTTP status code besides traditional error.
Best used with Lambda, providing a smooth way of returning an HTTP status code.
func handlerX(ctx context.Context) (*myStruct, error) {
data, err := f(ctx)
if err != nil {
return nil, restful.NewError(err, http.StatusBadRequest) // Return the whole error to the client.
}
return data, nil
}One may hide the details and send a simpler response.
func handlerY(ctx context.Context) (*myStruct, error) {
data, err := f(ctx)
if err != nil {
fmt.Print(err) // Log detailed error.
return nil, restful.NewError(nil, http.StatusBadRequest, "Bad Request") // Return a simpler message only.
}
return data, nil
}RESTful's HTTP Client returns RESTful's Error object. Therefore HTTP status code can be checked.
func handlerZ(ctx context.Context) (*myStruct, error) {
var data myStruct
err := restful.NewClient().Get(ctx, "https://example.com", &data)
if err != nil {
if restful.IsConnectError(err) {
fmt.Print("Connection failed")
} else if restful.GetErrStatusCode(err) == http.StatusUnauthorized {
fmt.Print("We should have got authorized, first.")
} else {
contentType, body := restful.GetErrBody(err)
if len(body) != 0 {
fmt.Printf("received error content-type=%s, body=%v", contentType, body)
}
}
return nil, err
}
return &data, nil
}