File: errors.go

package info (click to toggle)
golang-github-notaryproject-notation-go 1.2.1-4
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,652 kB
  • sloc: makefile: 21
file content (117 lines) | stat: -rw-r--r-- 4,329 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
// Copyright The Notary Project Authors.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package proto

import (
	"encoding/json"
	"errors"
	"fmt"

	"github.com/notaryproject/notation-plugin-framework-go/plugin"
)

// Deprecated: ErrorCode exists for historical compatibility and should not be used.
// To access ErrorCode, use the notation-plugin-framework-go's plugin.ErrorCode type.
type ErrorCode = plugin.ErrorCode

const (
	// ErrorCodeValidation is used when any of the required request fields is empty ormalformed/invalid.
	//
	// Deprecated: ErrorCodeValidation exists for historical compatibility and should not be used.
	// To access ErrorCodeValidation, use the notation-plugin-framework-go's [plugin.ErrorCodeValidation].
	ErrorCodeValidation = plugin.ErrorCodeValidation

	// ErrorCodeUnsupportedContractVersion is used when when the contract version used in the request is unsupported.
	//
	// Deprecated: ErrorCodeUnsupportedContractVersion exists for historical compatibility and should not be used.
	// To access ErrorCodeUnsupportedContractVersion, use the notation-plugin-framework-go's [plugin.ErrorCodeUnsupportedContractVersion].
	ErrorCodeUnsupportedContractVersion = plugin.ErrorCodeUnsupportedContractVersion

	// ErrorCodeAccessDenied is used when user doesn't have required permission to access the key.
	//
	// Deprecated: ErrorCodeAccessDenied exists for historical compatibility and should not be used.
	// To access ErrorCodeAccessDenied, use the notation-plugin-framework-go's [plugin.ErrorCodeAccessDenied].
	ErrorCodeAccessDenied = plugin.ErrorCodeAccessDenied

	// ErrorCodeTimeout is used when an operation to generate signature timed out and can be retried by Notation.
	//
	// Deprecated: ErrorCodeTimeout exists for historical compatibility and should not be used.
	// To access ErrorCodeTimeout, use the notation-plugin-framework-go's [plugin.ErrorCodeTimeout].
	ErrorCodeTimeout = plugin.ErrorCodeTimeout

	// ErrorCodeThrottled is used when an operation to generate signature was throttles
	// and can be retried by Notation.
	//
	// Deprecated: ErrorCodeThrottled exists for historical compatibility and should not be used.
	// To access ErrorCodeThrottled, use the notation-plugin-framework-go's [plugin.ErrorCodeThrottled].
	ErrorCodeThrottled = plugin.ErrorCodeThrottled

	// ErrorCodeGeneric  is used when an general error occurred that does not fall into any categories.
	//
	// Deprecated: ErrorCodeGeneric exists for historical compatibility and should not be used.
	// To access ErrorCodeGeneric, use the notation-plugin-framework-go's [plugin.ErrorCodeGeneric].
	ErrorCodeGeneric = plugin.ErrorCodeGeneric
)

// RequestError is the common error response for any request.
type RequestError struct {
	Code     plugin.ErrorCode
	Err      error
	Metadata map[string]string
}

func (e RequestError) Error() string {
	return fmt.Sprintf("%v", e.Err)
}

func (e RequestError) Unwrap() error {
	return e.Err
}

func (e RequestError) Is(target error) bool {
	if et, ok := target.(RequestError); ok {
		if e.Code != et.Code {
			return false
		}
		if e.Err == et.Err {
			return true
		}
		return e.Err != nil && et.Err != nil && e.Err.Error() == et.Err.Error()
	}
	return false
}

func (e RequestError) MarshalJSON() ([]byte, error) {
	var msg string
	if e.Err != nil {
		msg = e.Err.Error()
	}
	return json.Marshal(plugin.Error{ErrCode: e.Code, Message: msg, Metadata: e.Metadata})
}

func (e *RequestError) UnmarshalJSON(data []byte) error {
	var tmp plugin.Error
	err := json.Unmarshal(data, &tmp)
	if err != nil {
		return err
	}
	if tmp.ErrCode == "" && tmp.Message == "" && tmp.Metadata == nil {
		return errors.New("incomplete json")
	}
	*e = RequestError{Code: tmp.ErrCode, Metadata: tmp.Metadata}
	if tmp.Message != "" {
		e.Err = errors.New(tmp.Message)
	}
	return nil
}