9dcff95a29
Define base `Status` interface. Provide the functionality to distinguish success and failure returns. Provide functionality to transport statuses over NeoFS API V2 protocol. Support success `OK` and failure `INTERNAL` returns. Signed-off-by: Leonard Lyubich <leonard@nspcc.ru>
99 lines
2.7 KiB
Go
99 lines
2.7 KiB
Go
package apistatus
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/nspcc-dev/neofs-api-go/v2/status"
|
|
)
|
|
|
|
// StatusV2 defines a variety of Status instances compatible with NeoFS API V2 protocol.
|
|
//
|
|
// Note: it is not recommended to use this type directly, it is intended for documentation of the library functionality.
|
|
type StatusV2 interface {
|
|
Status
|
|
|
|
// ToStatusV2 returns the status as github.com/nspcc-dev/neofs-api-go/v2/status.Status message structure.
|
|
ToStatusV2() *status.Status
|
|
}
|
|
|
|
// FromStatusV2 converts status.Status message structure to Status instance. Inverse to ToStatusV2 operation.
|
|
//
|
|
// If result is not nil, it implements StatusV2. This fact should be taken into account only when passing
|
|
// the result to the inverse function ToStatusV2, casts are not compatibility-safe.
|
|
//
|
|
// Below is the mapping of return codes to Status instance types (with a description of parsing details).
|
|
// Note: notice if the return type is a pointer.
|
|
//
|
|
// Successes:
|
|
// * status.OK: *SuccessDefaultV2 (this also includes nil argument).
|
|
//
|
|
// Common failures:
|
|
// * status.Internal: *ServerInternal.
|
|
func FromStatusV2(st *status.Status) Status {
|
|
var decoder interface {
|
|
fromStatusV2(*status.Status)
|
|
}
|
|
|
|
switch code := st.Code(); {
|
|
case status.IsSuccess(code):
|
|
switch status.LocalizeSuccess(&code); code {
|
|
case status.OK:
|
|
decoder = new(SuccessDefaultV2)
|
|
}
|
|
case status.IsCommonFail(code):
|
|
switch status.LocalizeCommonFail(&code); code {
|
|
case status.Internal:
|
|
decoder = new(ServerInternal)
|
|
}
|
|
}
|
|
|
|
if decoder == nil {
|
|
decoder = new(unrecognizedStatusV2)
|
|
}
|
|
|
|
decoder.fromStatusV2(st)
|
|
|
|
return decoder
|
|
}
|
|
|
|
// ToStatusV2 converts Status instance to status.Status message structure. Inverse to FromStatusV2 operation.
|
|
//
|
|
// If argument is the StatusV2 instance, it is converted directly.
|
|
// Otherwise, successes are converted with status.OK code w/o details and message, failures - with status.Internal.
|
|
func ToStatusV2(st Status) *status.Status {
|
|
if v, ok := st.(StatusV2); ok {
|
|
return v.ToStatusV2()
|
|
}
|
|
|
|
if IsSuccessful(st) {
|
|
return newStatusV2WithLocalCode(status.OK, status.GlobalizeSuccess)
|
|
}
|
|
|
|
return newStatusV2WithLocalCode(status.Internal, status.GlobalizeCommonFail)
|
|
}
|
|
|
|
func errMessageStatusV2(code interface{}, msg string) string {
|
|
const (
|
|
noMsgFmt = "status: code = %v"
|
|
msgFmt = noMsgFmt + " message = %s"
|
|
)
|
|
|
|
if msg != "" {
|
|
return fmt.Sprintf(msgFmt, code, msg)
|
|
}
|
|
|
|
return fmt.Sprintf(noMsgFmt, code)
|
|
}
|
|
|
|
func newStatusV2WithLocalCode(code status.Code, globalizer func(*status.Code)) *status.Status {
|
|
var st status.Status
|
|
|
|
st.SetCode(globalizeCodeV2(code, globalizer))
|
|
|
|
return &st
|
|
}
|
|
|
|
func globalizeCodeV2(code status.Code, globalizer func(*status.Code)) status.Code {
|
|
globalizer(&code)
|
|
return code
|
|
}
|