package
1.12.6
Repository: https://github.com/go-dev-frame/sponge.git
Documentation: pkg.go.dev

# 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 digitMiddle three digitsLast two digits
1 is http system-level error
2 is http business-level error
3 is grpc system-level error
4 is grpc system-level error
Table or module number, range 1~1000Custom number, range 1~100

Error code ranges:

Service TypeSystem-level Error Code RangeBusiness-level Error Code Range
http100000 ~ 200000200000 ~ 300000
grpc300000 ~ 400000400000 ~ 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.

# Structs

Detail error details.
ErrInfo error info.
Error error.
RPCStatus rpc status.

# Interfaces

Responser response interface.