The highest tagged major version is
Documentation
¶
Index ¶
- func FieldsProducer(_ context.Context, err error) logrus.Fields
- func GRPCCode(err error) codes.Code
- func StreamInterceptor(srv interface{}, stream grpc.ServerStream, info *grpc.StreamServerInfo, ...) error
- func UnaryInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, ...) (interface{}, error)
- type Error
- func New(format string, a ...any) Error
- func NewAborted(format string, a ...any) Error
- func NewAlreadyExists(format string, a ...any) Error
- func NewCanceled(format string, a ...any) Error
- func NewDataLoss(format string, a ...any) Error
- func NewDeadlineExceeded(format string, a ...any) Error
- func NewFailedPrecondition(format string, a ...any) Error
- func NewInternal(format string, a ...any) Error
- func NewInvalidArgument(format string, a ...any) Error
- func NewNotFound(format string, a ...any) Error
- func NewPermissionDenied(format string, a ...any) Error
- func NewResourceExhausted(format string, a ...any) Error
- func NewUnauthenticated(format string, a ...any) Error
- func NewUnavailable(format string, a ...any) Error
- func NewUnimplemented(format string, a ...any) Error
- func (e Error) Code() codes.Code
- func (e Error) Details() []proto.Message
- func (e Error) Error() string
- func (e Error) GRPCStatus() *status.Status
- func (e Error) Is(targetErr error) bool
- func (e Error) Metadata() map[string]any
- func (e Error) Unwrap() error
- func (e Error) WithDetail(detail proto.Message) Error
- func (e Error) WithGRPCCode(code codes.Code) Error
- func (e Error) WithInterceptedMetadata(key string, value any) Error
- func (e Error) WithMetadata(key string, value any) Error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FieldsProducer ¶
FieldsProducer extracts metadata from err if it contains a `structerr.Error` and exposes it as logged fields. This function is supposed to be used with `log.MessageProducer()`.
func GRPCCode ¶ added in v15.8.0
GRPCCode translates errors into codes.Code values.
- If present, it will un-wrap the top-level error that implements the `GRPCStatus()` function and return its error code. As we internally use `structerr`s to propagate gRPC error codes the error code propagation semantics match what the `structerr` is doing in that case.
- If no error is found in the chain that implements `GRPCStatus()` then `codes.Unknown` is returned.
- If err is nil then `codes.OK` is returned.
Semantics of this function thus match what the calling-side of an RPC would see if the given error was returned from that RPC.
func StreamInterceptor ¶ added in v15.8.0
func StreamInterceptor(srv interface{}, stream grpc.ServerStream, info *grpc.StreamServerInfo, handler grpc.StreamHandler) error
StreamInterceptor is an interceptor for streaming RPC calls that injects error metadata as detailed error. This is only supposed to be used for testing purposes as error metadata is considered to be a server-side detail. No clients should start to rely on it.
func UnaryInterceptor ¶ added in v15.8.0
func UnaryInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error)
UnaryInterceptor is an interceptor for unary RPC calls that injects error metadata as detailed error. This is only supposed to be used for testing purposes as error metadata is considered to be a server-side detail. No clients should start to rely on it.
Types ¶
type Error ¶
type Error struct {
// contains filtered or unexported fields
}
Error is a structured error that contains additional details.
func New ¶
New returns a new Error with an Unknown error code. This constructor should be used in the general case where it is not clear what the specific error category is. As Unknown errors get treated specially, they will be overridden when wrapped with an error that has a more specific error code.
func NewAborted ¶
NewAborted constructs a new error code with the Aborted error code. Please refer to New for further details.
func NewAlreadyExists ¶
NewAlreadyExists constructs a new error code with the AlreadyExists error code. Please refer to New for further details.
func NewCanceled ¶
NewCanceled constructs a new error code with the Canceled error code. Please refer to New for further details.
func NewDataLoss ¶
NewDataLoss constructs a new error code with the DataLoss error code. Please refer to New for further details.
func NewDeadlineExceeded ¶
NewDeadlineExceeded constructs a new error code with the DeadlineExceeded error code. Please refer to New for further details.
func NewFailedPrecondition ¶
NewFailedPrecondition constructs a new error code with the FailedPrecondition error code. Please refer to New for further details.
func NewInternal ¶
NewInternal constructs a new error code with the Internal error code. Please refer to New for further details.
func NewInvalidArgument ¶
NewInvalidArgument constructs a new error code with the InvalidArgument error code. Please refer to New for further details.
func NewNotFound ¶
NewNotFound constructs a new error code with the NotFound error code. Please refer to New for further details.
func NewPermissionDenied ¶
NewPermissionDenied constructs a new error code with the PermissionDenied error code. Please refer to New for further details.
func NewResourceExhausted ¶
NewResourceExhausted constructs a new error code with the ResourceExhausted error code. Please refer to New for further details.
func NewUnauthenticated ¶
NewUnauthenticated constructs a new error code with the Unauthenticated error code. Please refer to New for further details.
func NewUnavailable ¶
NewUnavailable constructs a new error code with the Unavailable error code. Please refer to New for further details.
func NewUnimplemented ¶
NewUnimplemented constructs a new error code with the Unimplemented error code. Please refer to New for further details.
func (Error) Details ¶
Details returns the chain error details set by this and any wrapped Error. The returned array contains error details ordered from top-level error details to bottom-level error details.
func (Error) GRPCStatus ¶
GRPCStatus returns the gRPC status of this error.
func (Error) Is ¶
Is checks whether the error is equivalent to the target error. Errors are only considered equivalent if the GRPC representation of this error is the same.
func (Error) Metadata ¶
Metadata returns the Error's metadata. The metadata will contain the combination of all added metadata of this error as well as any wrapped Errors.
When the same metada key exists multiple times in the error chain, then the value that is highest up the callchain will be returned. This is done because in general, the higher up the callchain one is the more context is available.
func (Error) WithDetail ¶
WithDetail sets the Error detail that provides additional structured information about the error via gRPC so that callers can programmatically determine the exact circumstances of an error.
func (Error) WithGRPCCode ¶ added in v15.8.0
WithGRPCCode overrides the gRPC code embedded into the error.
func (Error) WithInterceptedMetadata ¶ added in v15.8.0
WithInterceptedMetadata adds an additional metadata item to the Error in the form of an error detail. Note that this is only intended to be used in the context of tests where we convert error metadata into structured errors via the UnaryInterceptor and StreamInterceptor so that we can test that metadata has been set as expected on the client-side of a gRPC call.
func (Error) WithMetadata ¶
WithMetadata adds an additional metadata item to the Error. The metadata has the intent to provide more context around errors to the consumer of the Error. Calling this function multiple times with the same key will override any previous values.
Source Files