# README
errcode
Error codes usually include system-level error codes and business-level error codes, consisting of a total of 6 decimal digits, e.g. 200101
Error code structure:
First digit | Middle three digits | Last two digits |
---|---|---|
1 is http system-level error2 is http business-level error3 is grpc system-level error4 is grpc system-level error | Table or module number, range 1~1000 | Custom number, range 1~100 |
Error code ranges:
Service Type | System-level Error Code Range | Business-level Error Code Range |
---|---|---|
http | 100000 ~ 200000 | 200000 ~ 300000 |
grpc | 300000 ~ 400000 | 400000 ~ 500000 |
Example of use
Example of http error code usage
Web services created based on SQL, use the following error code:
import "github.com/go-dev-frame/sponge/pkg/gin/response"
// return error
response.Error(c, ecode.InvalidParams)
// rewrite error messages
response.Error(c, ecode.InvalidParams.RewriteMsg("custom error message"))
// convert error code to standard http status code
response.Out(c, ecode.InvalidParams)
// convert error code to standard http status code, and rewrite error messages
response.Out(c, ecode.InvalidParams.RewriteMsg("custom error message"))
Web services created based on Protobuf, use the following error code:
// return error
return nil, ecode.InvalidParams.Err()
// rewrite error messages
return nil, ecode.InvalidParams.Err("custom error message")
// convert error code to standard http status code
return nil, ecode.InvalidParams.ErrToHTTP()
// convert error code to standard http status code, and rewrite error messages
return nil, ecode.InvalidParams.ErrToHTTP("custom error message")
Example of grpc error code usage
// return error
return nil, ecode.StatusInvalidParams.Err()
// rewrite error messages
return nil, ecode.StatusInvalidParams.Err("custom error message")
// convert error code to standard grpc status code
return nil, ecode.StatusInvalidParams.ToRPCErr()
// convert error code to standard grpc status code, and rewrite error messages
return nil, ecode.StatusInvalidParams.ToRPCErr("custom error message")
// convert error code to standard http status code
return nil, ecode.StatusInvalidParams.ErrToHTTP()
// convert error code to standard http status code, and rewrite error messages
return nil, ecode.StatusInvalidParams.ErrToHTTP("custom error message")
# Functions
Any type key value.
GetErrorCode get Error code from error returned by http invoke.
GetStatusCode get status code from error returned by RPC invoke.
HCode Generate an error code between 200000 and 300000 according to the number
http service level error code, Err prefix, example.
ListGRPCErrCodes list grpc error codes, http handle func.
ListHTTPErrCodes list http error codes.
NewError create a new error message.
NewResponser creates a new responser, if isFromRPC=true, it means return from rpc, otherwise default return from http.
NewRPCStatus create a new rpc status.
ParseError parsing out error codes from error messages.
RCode Generate an error code between 400000 and 500000 according to the number
rpc service level error code, status prefix, example.
ShowConfig show config info @Summary show config info @Description show config info @Tags system @Accept json @Produce json @Router /config [get].
ToHTTPErr converted to http error.
# Constants
ToHTTPCodeLabel need to convert to standard http code label.
# Variables
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
Deprecated: use Conflict instead.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
nolint.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
http system level error code, error code range 10000~20000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
rpc system level error code with status prefix, error code range 30000~40000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
http system level error code, error code range 10000~20000.
# Interfaces
Responser response interface.