feat: Support custom status code conversion from HTTP and gRPC. (#1410)

* feat: Support custom status code conversion from HTTP and gRPC.

Co-authored-by: Letian Yi <yiletian@webull.com>
pull/1425/head
letian 3 years ago committed by GitHub
parent 1ac50be94c
commit fa54a1dd3a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 7
      errors/errors.go
  2. 82
      internal/httputil/http.go
  3. 66
      internal/httputil/http_test.go
  4. 110
      transport/http/status/status.go
  5. 71
      transport/http/status/status_test.go

@ -4,7 +4,8 @@ import (
"errors"
"fmt"
"github.com/go-kratos/kratos/v2/internal/httputil"
httpstatus "github.com/go-kratos/kratos/v2/transport/http/status"
"google.golang.org/genproto/googleapis/rpc/errdetails"
"google.golang.org/grpc/status"
"google.golang.org/protobuf/proto"
@ -27,7 +28,7 @@ func (e *Error) Error() string {
// GRPCStatus returns the Status represented by se.
func (e *Error) GRPCStatus() *status.Status {
s, _ := status.New(httputil.GRPCCodeFromStatus(int(e.Code)), e.Message).
s, _ := status.New(httpstatus.ToGRPCCode(int(e.Code)), e.Message).
WithDetails(&errdetails.ErrorInfo{
Reason: e.Reason,
Metadata: e.Metadata,
@ -105,7 +106,7 @@ func FromError(err error) *Error {
switch d := detail.(type) {
case *errdetails.ErrorInfo:
return New(
httputil.StatusFromGRPCCode(gs.Code()),
httpstatus.FromGRPCCode(gs.Code()),
d.Reason,
gs.Message(),
).WithMetadata(d.Metadata)

@ -1,19 +1,11 @@
package httputil
import (
"net/http"
"strings"
"google.golang.org/grpc/codes"
)
const (
baseContentType = "application"
// StatusClientClosed is non-standard http status code,
// which defined by nginx.
// https://httpstatus.in/499/
StatusClientClosed = 499
)
// ContentType returns the content-type with base prefix.
@ -40,77 +32,3 @@ func ContentSubtype(contentType string) string {
}
return contentType[left+1 : right]
}
// GRPCCodeFromStatus converts a HTTP error code into the corresponding gRPC response status.
// See: https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
func GRPCCodeFromStatus(code int) codes.Code {
switch code {
case http.StatusOK:
return codes.OK
case http.StatusBadRequest:
return codes.InvalidArgument
case http.StatusUnauthorized:
return codes.Unauthenticated
case http.StatusForbidden:
return codes.PermissionDenied
case http.StatusNotFound:
return codes.NotFound
case http.StatusConflict:
return codes.Aborted
case http.StatusTooManyRequests:
return codes.ResourceExhausted
case http.StatusInternalServerError:
return codes.Internal
case http.StatusNotImplemented:
return codes.Unimplemented
case http.StatusServiceUnavailable:
return codes.Unavailable
case http.StatusGatewayTimeout:
return codes.DeadlineExceeded
case StatusClientClosed:
return codes.Canceled
}
return codes.Unknown
}
// StatusFromGRPCCode converts a gRPC error code into the corresponding HTTP response status.
// See: https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
func StatusFromGRPCCode(code codes.Code) int {
switch code {
case codes.OK:
return http.StatusOK
case codes.Canceled:
return StatusClientClosed
case codes.Unknown:
return http.StatusInternalServerError
case codes.InvalidArgument:
return http.StatusBadRequest
case codes.DeadlineExceeded:
return http.StatusGatewayTimeout
case codes.NotFound:
return http.StatusNotFound
case codes.AlreadyExists:
return http.StatusConflict
case codes.PermissionDenied:
return http.StatusForbidden
case codes.Unauthenticated:
return http.StatusUnauthorized
case codes.ResourceExhausted:
return http.StatusTooManyRequests
case codes.FailedPrecondition:
return http.StatusBadRequest
case codes.Aborted:
return http.StatusConflict
case codes.OutOfRange:
return http.StatusBadRequest
case codes.Unimplemented:
return http.StatusNotImplemented
case codes.Internal:
return http.StatusInternalServerError
case codes.Unavailable:
return http.StatusServiceUnavailable
case codes.DataLoss:
return http.StatusInternalServerError
}
return http.StatusInternalServerError
}

@ -1,10 +1,7 @@
package httputil
import (
"net/http"
"testing"
"google.golang.org/grpc/codes"
)
func TestContentSubtype(t *testing.T) {
@ -31,69 +28,6 @@ func TestContentSubtype(t *testing.T) {
}
}
func TestGRPCCodeFromStatus(t *testing.T) {
tests := []struct {
name string
code int
want codes.Code
}{
{"http.StatusOK", http.StatusOK, codes.OK},
{"http.StatusBadRequest", http.StatusBadRequest, codes.InvalidArgument},
{"http.StatusUnauthorized", http.StatusUnauthorized, codes.Unauthenticated},
{"http.StatusForbidden", http.StatusForbidden, codes.PermissionDenied},
{"http.StatusNotFound", http.StatusNotFound, codes.NotFound},
{"http.StatusConflict", http.StatusConflict, codes.Aborted},
{"http.StatusTooManyRequests", http.StatusTooManyRequests, codes.ResourceExhausted},
{"http.StatusInternalServerError", http.StatusInternalServerError, codes.Internal},
{"http.StatusNotImplemented", http.StatusNotImplemented, codes.Unimplemented},
{"http.StatusServiceUnavailable", http.StatusServiceUnavailable, codes.Unavailable},
{"http.StatusGatewayTimeout", http.StatusGatewayTimeout, codes.DeadlineExceeded},
{"StatusClientClosed", StatusClientClosed, codes.Canceled},
{"else", 100000, codes.Unknown},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := GRPCCodeFromStatus(tt.code); got != tt.want {
t.Errorf("GRPCCodeFromStatus() = %v, want %v", got, tt.want)
}
})
}
}
func TestStatusFromGRPCCode(t *testing.T) {
tests := []struct {
name string
code codes.Code
want int
}{
{"codes.OK", codes.OK, http.StatusOK},
{"codes.Canceled", codes.Canceled, StatusClientClosed},
{"codes.Unknown", codes.Unknown, http.StatusInternalServerError},
{"codes.InvalidArgument", codes.InvalidArgument, http.StatusBadRequest},
{"codes.DeadlineExceeded", codes.DeadlineExceeded, http.StatusGatewayTimeout},
{"codes.NotFound", codes.NotFound, http.StatusNotFound},
{"codes.AlreadyExists", codes.AlreadyExists, http.StatusConflict},
{"codes.PermissionDenied", codes.PermissionDenied, http.StatusForbidden},
{"codes.Unauthenticated", codes.Unauthenticated, http.StatusUnauthorized},
{"codes.ResourceExhausted", codes.ResourceExhausted, http.StatusTooManyRequests},
{"codes.FailedPrecondition", codes.FailedPrecondition, http.StatusBadRequest},
{"codes.Aborted", codes.Aborted, http.StatusConflict},
{"codes.OutOfRange", codes.OutOfRange, http.StatusBadRequest},
{"codes.Unimplemented", codes.Unimplemented, http.StatusNotImplemented},
{"codes.Internal", codes.Internal, http.StatusInternalServerError},
{"codes.Unavailable", codes.Unavailable, http.StatusServiceUnavailable},
{"codes.DataLoss", codes.DataLoss, http.StatusInternalServerError},
{"else", codes.Code(10000), http.StatusInternalServerError},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := StatusFromGRPCCode(tt.code); got != tt.want {
t.Errorf("StatusFromGRPCCode() = %v, want %v", got, tt.want)
}
})
}
}
func TestContentType(t *testing.T) {
tests := []struct {
name string

@ -0,0 +1,110 @@
package status
import (
"net/http"
"google.golang.org/grpc/codes"
)
const (
// ClientClosed is non-standard http status code,
// which defined by nginx.
// https://httpstatus.in/499/
ClientClosed = 499
)
type Converter interface {
// ToGRPCCode converts an HTTP error code into the corresponding gRPC response status.
ToGRPCCode(code int) codes.Code
// FromGRPCCode converts a gRPC error code into the corresponding HTTP response status.
FromGRPCCode(code codes.Code) int
}
type statusConverter struct{}
var DefaultConverter Converter = statusConverter{}
// ToGRPCCode converts a HTTP error code into the corresponding gRPC response status.
// See: https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
func (c statusConverter) ToGRPCCode(code int) codes.Code {
switch code {
case http.StatusOK:
return codes.OK
case http.StatusBadRequest:
return codes.InvalidArgument
case http.StatusUnauthorized:
return codes.Unauthenticated
case http.StatusForbidden:
return codes.PermissionDenied
case http.StatusNotFound:
return codes.NotFound
case http.StatusConflict:
return codes.Aborted
case http.StatusTooManyRequests:
return codes.ResourceExhausted
case http.StatusInternalServerError:
return codes.Internal
case http.StatusNotImplemented:
return codes.Unimplemented
case http.StatusServiceUnavailable:
return codes.Unavailable
case http.StatusGatewayTimeout:
return codes.DeadlineExceeded
case ClientClosed:
return codes.Canceled
}
return codes.Unknown
}
// FromGRPCCode converts a gRPC error code into the corresponding HTTP response status.
// See: https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
func (c statusConverter) FromGRPCCode(code codes.Code) int {
switch code {
case codes.OK:
return http.StatusOK
case codes.Canceled:
return ClientClosed
case codes.Unknown:
return http.StatusInternalServerError
case codes.InvalidArgument:
return http.StatusBadRequest
case codes.DeadlineExceeded:
return http.StatusGatewayTimeout
case codes.NotFound:
return http.StatusNotFound
case codes.AlreadyExists:
return http.StatusConflict
case codes.PermissionDenied:
return http.StatusForbidden
case codes.Unauthenticated:
return http.StatusUnauthorized
case codes.ResourceExhausted:
return http.StatusTooManyRequests
case codes.FailedPrecondition:
return http.StatusBadRequest
case codes.Aborted:
return http.StatusConflict
case codes.OutOfRange:
return http.StatusBadRequest
case codes.Unimplemented:
return http.StatusNotImplemented
case codes.Internal:
return http.StatusInternalServerError
case codes.Unavailable:
return http.StatusServiceUnavailable
case codes.DataLoss:
return http.StatusInternalServerError
}
return http.StatusInternalServerError
}
// ToGRPCCode converts an HTTP error code into the corresponding gRPC response status.
func ToGRPCCode(code int) codes.Code {
return DefaultConverter.ToGRPCCode(code)
}
// FromGRPCCode converts a gRPC error code into the corresponding HTTP response status.
func FromGRPCCode(code codes.Code) int {
return DefaultConverter.FromGRPCCode(code)
}

@ -0,0 +1,71 @@
package status
import (
"net/http"
"testing"
"google.golang.org/grpc/codes"
)
func TestToGRPCCode(t *testing.T) {
tests := []struct {
name string
code int
want codes.Code
}{
{"http.StatusOK", http.StatusOK, codes.OK},
{"http.StatusBadRequest", http.StatusBadRequest, codes.InvalidArgument},
{"http.StatusUnauthorized", http.StatusUnauthorized, codes.Unauthenticated},
{"http.StatusForbidden", http.StatusForbidden, codes.PermissionDenied},
{"http.StatusNotFound", http.StatusNotFound, codes.NotFound},
{"http.StatusConflict", http.StatusConflict, codes.Aborted},
{"http.StatusTooManyRequests", http.StatusTooManyRequests, codes.ResourceExhausted},
{"http.StatusInternalServerError", http.StatusInternalServerError, codes.Internal},
{"http.StatusNotImplemented", http.StatusNotImplemented, codes.Unimplemented},
{"http.StatusServiceUnavailable", http.StatusServiceUnavailable, codes.Unavailable},
{"http.StatusGatewayTimeout", http.StatusGatewayTimeout, codes.DeadlineExceeded},
{"StatusClientClosed", ClientClosed, codes.Canceled},
{"else", 100000, codes.Unknown},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := ToGRPCCode(tt.code); got != tt.want {
t.Errorf("GRPCCodeFromStatus() = %v, want %v", got, tt.want)
}
})
}
}
func TestFromGRPCCode(t *testing.T) {
tests := []struct {
name string
code codes.Code
want int
}{
{"codes.OK", codes.OK, http.StatusOK},
{"codes.Canceled", codes.Canceled, ClientClosed},
{"codes.Unknown", codes.Unknown, http.StatusInternalServerError},
{"codes.InvalidArgument", codes.InvalidArgument, http.StatusBadRequest},
{"codes.DeadlineExceeded", codes.DeadlineExceeded, http.StatusGatewayTimeout},
{"codes.NotFound", codes.NotFound, http.StatusNotFound},
{"codes.AlreadyExists", codes.AlreadyExists, http.StatusConflict},
{"codes.PermissionDenied", codes.PermissionDenied, http.StatusForbidden},
{"codes.Unauthenticated", codes.Unauthenticated, http.StatusUnauthorized},
{"codes.ResourceExhausted", codes.ResourceExhausted, http.StatusTooManyRequests},
{"codes.FailedPrecondition", codes.FailedPrecondition, http.StatusBadRequest},
{"codes.Aborted", codes.Aborted, http.StatusConflict},
{"codes.OutOfRange", codes.OutOfRange, http.StatusBadRequest},
{"codes.Unimplemented", codes.Unimplemented, http.StatusNotImplemented},
{"codes.Internal", codes.Internal, http.StatusInternalServerError},
{"codes.Unavailable", codes.Unavailable, http.StatusServiceUnavailable},
{"codes.DataLoss", codes.DataLoss, http.StatusInternalServerError},
{"else", codes.Code(10000), http.StatusInternalServerError},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := FromGRPCCode(tt.code); got != tt.want {
t.Errorf("StatusFromGRPCCode() = %v, want %v", got, tt.want)
}
})
}
}
Loading…
Cancel
Save