yarpcerrors

package
v1.17.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 20, 2017 License: MIT Imports: 4 Imported by: 309

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AbortedErrorf deprecated 

func AbortedErrorf(format string, args ...interface{}) error

AbortedErrorf returns a new Status with code CodeAborted.

Deprecated: Use Newf instead.

func AlreadyExistsErrorf deprecated 

func AlreadyExistsErrorf(format string, args ...interface{}) error

AlreadyExistsErrorf returns a new Status with code CodeAlreadyExists.

Deprecated: Use Newf instead.

func CancelledErrorf deprecated 

func CancelledErrorf(format string, args ...interface{}) error

CancelledErrorf returns a new Status with code CodeCancelled.

Deprecated: Use Newf instead.

func DataLossErrorf deprecated 

func DataLossErrorf(format string, args ...interface{}) error

DataLossErrorf returns a new Status with code CodeDataLoss.

Deprecated: Use Newf instead.

func DeadlineExceededErrorf deprecated 

func DeadlineExceededErrorf(format string, args ...interface{}) error

DeadlineExceededErrorf returns a new Status with code CodeDeadlineExceeded.

Deprecated: Use Newf instead.

func ErrorMessage deprecated 

func ErrorMessage(err error) string

ErrorMessage returns the message for the given error, or "" if the given error is nil, or err.Error() if the given error is not a YARPC error or the YARPC error had no message.

Deprecated: Use FromError and Message instead.

func ErrorName deprecated 

func ErrorName(err error) string

ErrorName returns the name for the given error, or "" if the given error is not a YARPC error created with NamedErrorf that has a non-empty name.

Deprecated: Use FromError and Name instead.

func FailedPreconditionErrorf deprecated 

func FailedPreconditionErrorf(format string, args ...interface{}) error

FailedPreconditionErrorf returns a new Status with code CodeFailedPrecondition.

Deprecated: Use Newf instead.

func FromHeaders deprecated 

func FromHeaders(code Code, name string, message string) error

FromHeaders returns a new Status from headers transmitted from the server side.

If the specified code is CodeOK, this will return nil.

The name must only contain lowercase letters from a-z and dashes (-), and cannot start or end in a dash. If the name is something else, an error with code CodeInternal will be returned.

This function should not be used by server implementations, use the individual error constructors instead. This should only be used by transport implementations.

Deprecated: Use Newf and WithName instead.

func InternalErrorf deprecated 

func InternalErrorf(format string, args ...interface{}) error

InternalErrorf returns a new Status with code CodeInternal.

Deprecated: Use Newf instead.

func InvalidArgumentErrorf deprecated 

func InvalidArgumentErrorf(format string, args ...interface{}) error

InvalidArgumentErrorf returns a new Status with code CodeInvalidArgument.

Deprecated: Use Newf instead.

func IsAborted deprecated 

func IsAborted(err error) bool

IsAborted returns true if ErrorCode(err) == CodeAborted.

Deprecated: Use FromError and Code instead.

func IsAlreadyExists deprecated 

func IsAlreadyExists(err error) bool

IsAlreadyExists returns true if ErrorCode(err) == CodeAlreadyExists.

Deprecated: Use FromError and Code instead.

func IsCancelled deprecated 

func IsCancelled(err error) bool

IsCancelled returns true if ErrorCode(err) == CodeCancelled.

Deprecated: Use FromError and Code instead.

func IsDataLoss deprecated 

func IsDataLoss(err error) bool

IsDataLoss returns true if ErrorCode(err) == CodeDataLoss.

Deprecated: Use FromError and Code instead.

func IsDeadlineExceeded deprecated 

func IsDeadlineExceeded(err error) bool

IsDeadlineExceeded returns true if ErrorCode(err) == CodeDeadlineExceeded.

Deprecated: Use FromError and Code instead.

func IsFailedPrecondition deprecated 

func IsFailedPrecondition(err error) bool

IsFailedPrecondition returns true if ErrorCode(err) == CodeFailedPrecondition.

Deprecated: Use FromError and Code instead.

func IsInternal deprecated 

func IsInternal(err error) bool

IsInternal returns true if ErrorCode(err) == CodeInternal.

Deprecated: Use FromError and Code instead.

func IsInvalidArgument deprecated 

func IsInvalidArgument(err error) bool

IsInvalidArgument returns true if ErrorCode(err) == CodeInvalidArgument.

Deprecated: Use FromError and Code instead.

func IsNotFound deprecated 

func IsNotFound(err error) bool

IsNotFound returns true if ErrorCode(err) == CodeNotFound.

Deprecated: Use FromError and Code instead.

func IsOutOfRange deprecated 

func IsOutOfRange(err error) bool

IsOutOfRange returns true if ErrorCode(err) == CodeOutOfRange.

Deprecated: Use FromError and Code instead.

func IsPermissionDenied deprecated 

func IsPermissionDenied(err error) bool

IsPermissionDenied returns true if ErrorCode(err) == CodePermissionDenied.

Deprecated: Use FromError and Code instead.

func IsResourceExhausted deprecated 

func IsResourceExhausted(err error) bool

IsResourceExhausted returns true if ErrorCode(err) == CodeResourceExhausted.

Deprecated: Use FromError and Code instead.

func IsStatus added in v1.17.0 

func IsStatus(err error) bool

IsStatus returns true if err is a Status.

func IsUnauthenticated deprecated 

func IsUnauthenticated(err error) bool

IsUnauthenticated returns true if ErrorCode(err) == CodeUnauthenticated.

Deprecated: Use FromError and Code instead.

func IsUnavailable deprecated 

func IsUnavailable(err error) bool

IsUnavailable returns true if ErrorCode(err) == CodeUnavailable.

Deprecated: Use FromError and Code instead.

func IsUnimplemented deprecated 

func IsUnimplemented(err error) bool

IsUnimplemented returns true if ErrorCode(err) == CodeUnimplemented.

Deprecated: Use FromError and Code instead.

func IsUnknown deprecated 

func IsUnknown(err error) bool

IsUnknown returns true if ErrorCode(err) == CodeUnknown.

Deprecated: Use FromError and Code instead.

func IsYARPCError deprecated 

func IsYARPCError(err error) bool

IsYARPCError is a convenience function that returns true if the given error is a non-nil YARPC error.

Deprecated: use IsStatus instead.

func NamedErrorf deprecated 

func NamedErrorf(name string, format string, args ...interface{}) error

NamedErrorf returns a new Status with code CodeUnknown and the given name.

This should be used for user-defined errors.

The name must only contain lowercase letters from a-z and dashes (-), and cannot start or end in a dash. If the name is something else, an error with code CodeInternal will be returned.

Deprecated: Use Newf and WithName instead.

func NotFoundErrorf deprecated 

func NotFoundErrorf(format string, args ...interface{}) error

NotFoundErrorf returns a new Status with code CodeNotFound.

Deprecated: Use Newf instead.

func OutOfRangeErrorf deprecated 

func OutOfRangeErrorf(format string, args ...interface{}) error

OutOfRangeErrorf returns a new Status with code CodeOutOfRange.

Deprecated: Use Newf instead.

func PermissionDeniedErrorf deprecated 

func PermissionDeniedErrorf(format string, args ...interface{}) error

PermissionDeniedErrorf returns a new Status with code CodePermissionDenied.

Deprecated: Use Newf instead.

func ResourceExhaustedErrorf deprecated 

func ResourceExhaustedErrorf(format string, args ...interface{}) error

ResourceExhaustedErrorf returns a new Status with code CodeResourceExhausted.

Deprecated: Use Newf instead.

func UnauthenticatedErrorf deprecated 

func UnauthenticatedErrorf(format string, args ...interface{}) error

UnauthenticatedErrorf returns a new Status with code CodeUnauthenticated.

Deprecated: Use Newf instead.

func UnavailableErrorf deprecated 

func UnavailableErrorf(format string, args ...interface{}) error

UnavailableErrorf returns a new Status with code CodeUnavailable.

Deprecated: Use Newf instead.

func UnimplementedErrorf deprecated 

func UnimplementedErrorf(format string, args ...interface{}) error

UnimplementedErrorf returns a new Status with code CodeUnimplemented.

Deprecated: Use Newf instead.

func UnknownErrorf deprecated 

func UnknownErrorf(format string, args ...interface{}) error

UnknownErrorf returns a new Status with code CodeUnknown.

Deprecated: Use Newf instead.

Types

type Code 

type Code int

Code represents the type of error for an RPC call.

Sometimes multiple error codes may apply. Services should return the most specific error code that applies. For example, prefer `OutOfRange` over `FailedPrecondition` if both codes apply. Similarly prefer `NotFound` or `AlreadyExists` over `FailedPrecondition`. 

const (
	// CodeOK means no error; returned on success
	CodeOK Code = 0

	// CodeCancelled means the operation was cancelled, typically by the caller.
	CodeCancelled Code = 1

	// CodeUnknown means an unknown error. Errors raised by APIs
	// that do not return enough error information
	// may be converted to this error.
	CodeUnknown Code = 2

	// CodeInvalidArgument means the client specified an invalid argument.
	// Note that this differs from `FailedPrecondition`. `InvalidArgument`
	// indicates arguments that are problematic regardless of the state of
	// the system (e.g., a malformed file name).
	CodeInvalidArgument Code = 3

	// CodeDeadlineExceeded means the deadline expired before the operation could
	// complete. For operations that change the state of the system, this error
	// may be returned even if the operation has completed successfully. For example,
	// a successful response from a server could have been delayed long
	// enough for the deadline to expire.
	CodeDeadlineExceeded Code = 4

	// CodeNotFound means some requested entity (e.g., file or directory) was not found.
	// For privacy reasons, this code *may* be returned when the client
	// does not have the access rights to the entity, though such usage is
	// discouraged.
	CodeNotFound Code = 5

	// CodeAlreadyExists means the entity that a client attempted to create
	// (e.g., file or directory) already exists.
	CodeAlreadyExists Code = 6

	// CodePermissionDenied means the caller does not have permission to execute
	// the specified operation. `PermissionDenied` must not be used for rejections
	// caused by exhausting some resource (use `ResourceExhausted`
	// instead for those errors). `PermissionDenied` must not be
	// used if the caller can not be identified (use `Unauthenticated`
	// instead for those errors).
	CodePermissionDenied Code = 7

	// CodeResourceExhausted means some resource has been exhausted, perhaps a per-user
	// quota, or perhaps the entire file system is out of space.
	CodeResourceExhausted Code = 8

	// CodeFailedPrecondition means the operation was rejected because the system is not
	// in a state required for the operation's execution. For example, the directory
	// to be deleted is non-empty, an rmdir operation is applied to
	// a non-directory, etc.
	//
	// Service implementors can use the following guidelines to decide
	// between `FailedPrecondition`, `Aborted`, and `Unavailable`:
	//  (a) Use `Unavailable` if the client can retry just the failing call.
	//  (b) Use `Aborted` if the client should retry at a higher level
	//      (e.g., restarting a read-modify-write sequence).
	//  (c) Use `FailedPrecondition` if the client should not retry until
	//      the system state has been explicitly fixed. E.g., if an "rmdir"
	//      fails because the directory is non-empty, `FailedPrecondition`
	//      should be returned since the client should not retry unless
	//      the files are deleted from the directory.
	CodeFailedPrecondition Code = 9

	// CodeAborted means the operation was aborted, typically due to a concurrency issue
	// such as a sequencer check failure or transaction abort.
	//
	// See the guidelines above for deciding between `FailedPrecondition`,
	// `Aborted`, and `Unavailable`.
	CodeAborted Code = 10

	// CodeOutOfRange means the operation was attempted past the valid range.
	// E.g., seeking or reading past end-of-file.
	//
	// Unlike `InvalidArgument`, this error indicates a problem that may
	// be fixed if the system state changes. For example, a 32-bit file
	// system will generate `InvalidArgument` if asked to read at an
	// offset that is not in the range [0,2^32-1], but it will generate
	// `OutOfRange` if asked to read from an offset past the current
	// file size.
	//
	// There is a fair bit of overlap between `FailedPrecondition` and
	// `OutOfRange`.  We recommend using `OutOfRange` (the more specific
	// error) when it applies so that callers who are iterating through
	// a space can easily look for an `OutOfRange` error to detect when
	// they are done.
	CodeOutOfRange Code = 11

	// CodeUnimplemented means the operation is not implemented or is not
	// supported/enabled in this service.
	CodeUnimplemented Code = 12

	// CodeInternal means an internal error. This means that some invariants expected
	// by the underlying system have been broken. This error code is reserved
	// for serious errors.
	CodeInternal Code = 13

	// CodeUnavailable means the service is currently unavailable. This is most likely a
	// transient condition, which can be corrected by retrying with a backoff.
	//
	// See the guidelines above for deciding between `FailedPrecondition`,
	// `Aborted`, and `Unavailable`.
	CodeUnavailable Code = 14

	// CodeDataLoss means unrecoverable data loss or corruption.
	CodeDataLoss Code = 15

	// CodeUnauthenticated means the request does not have valid authentication
	// credentials for the operation.
	CodeUnauthenticated Code = 16
)

func ErrorCode deprecated 

func ErrorCode(err error) Code

ErrorCode returns the Code for the given error, CodeOK if the error is nil, or CodeUnknown if the given error is not a YARPC error.

Deprecated: Use FromError and Code instead.

func (Code) MarshalJSON 

func (c Code) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler.

func (Code) MarshalText 

func (c Code) MarshalText() ([]byte, error)

MarshalText implements encoding.TextMarshaler.

func (Code) String 

func (c Code) String() string

String returns the the string representation of the Code.

func (*Code) UnmarshalJSON 

func (c *Code) UnmarshalJSON(text []byte) error

UnmarshalJSON implements json.Unmarshaler.

func (*Code) UnmarshalText 

func (c *Code) UnmarshalText(text []byte) error

UnmarshalText implements encoding.TextUnmarshaler.

type Status added in v1.17.0 

type Status struct {
	// contains filtered or unexported fields
}

Status represents a YARPC error.

func FromError added in v1.17.0 

func FromError(err error) *Status

FromError returns the Status for the error.

If the error is nil, ut returns nil If the error is a Status, it returns err. If the error is not a Status, it returns a new error with the Code CodeUnknown and the message err.Error()

func Newf added in v1.17.0 

func Newf(code Code, format string, args ...interface{}) *Status

Newf returns a new Status.

The Code should never be CodeOK, if it is, this will return nil.

func (*Status) Code added in v1.17.0 

func (s *Status) Code() Code

Code returns the code for the Status.

func (*Status) Error added in v1.17.0 

func (s *Status) Error() string

Error implements the error interface.

func (*Status) Message added in v1.17.0 

func (s *Status) Message() string

Message returns the message for the Status.

func (*Status) Name added in v1.17.0 

func (s *Status) Name() string

Name returns the name for the Status.

func (*Status) WithName added in v1.17.0 

func (s *Status) WithName(name string) *Status

WithName returns a new Status with the given name.

If s is nil, this will still return nil.

This should be used for user-defined errors.

The name must only contain lowercase letters from a-z and dashes (-), and cannot start or end in a dash. If the name is something else, an error with code CodeInternal will be returned.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.