feat: commit at 20241227173948

Author: colin404

pkg/core/core.go

@@ -42,7 +42,7 @@ func ShouldBindUri[T any](c *gin.Context, rq T, validators ...ValidatorFn[T]) er
 func ReadRequest[T any](c *gin.Context, rq T, bindFn BindFn, validators ...ValidatorFn[T]) error {
 	// 调用绑定函数绑定请求数据
 	if err := bindFn(rq); err != nil {
-		return err
+		return errorsx.ErrBind.WithMessage(err.Error())
 	}
 
 	// 如果目标结构体实现了 Default 接口，则调用其 Default 方法设置默认值

pkg/errorsx/code.go

@@ -0,0 +1,30 @@
+package errorsx
+
+import "net/http"
+
+// errorsx 预定义标准的错误.
+var (
+	// OK 代表请求成功.
+	OK = &ErrorX{Code: http.StatusOK, Message: ""}
+
+	// ErrInternal 表示所有未知的服务器端错误.
+	ErrInternal = &ErrorX{Code: http.StatusInternalServerError, Reason: "InternalError", Message: "Internal server error."}
+
+	// ErrNotFound 表示资源未找到.
+	ErrNotFound = &ErrorX{Code: http.StatusNotFound, Reason: "NotFound", Message: "Resource not found."}
+
+	// ErrBind 表示请求体绑定错误.
+	ErrBind = &ErrorX{Code: http.StatusBadRequest, Reason: "BindError", Message: "Error occurred while binding the request body to the struct."}
+
+	// ErrInvalidArgument 表示参数验证失败.
+	ErrInvalidArgument = &ErrorX{Code: http.StatusBadRequest, Reason: "InvalidArgument", Message: "Argument verification failed."}
+
+	// ErrUnauthenticated 表示认证失败.
+	ErrUnauthenticated = &ErrorX{Code: http.StatusUnauthorized, Reason: "Unauthenticated", Message: "Unauthenticated."}
+
+	// ErrPermissionDenied 表示请求没有权限.
+	ErrPermissionDenied = &ErrorX{Code: http.StatusForbidden, Reason: "PermissionDenied", Message: "Permission denied. Access to the requested resource is forbidden."}
+
+	// ErrOperationFailed 表示操作失败.
+	ErrOperationFailed = &ErrorX{Code: http.StatusConflict, Reason: "OperationFailed", Message: "The requested operation has failed. Please try again later."}
+)

pkg/errorsx/errorsx.go

@@ -10,13 +10,6 @@ import (
 	"google.golang.org/grpc/status"
 )
 
-const (
-	// UnknownCode 定义了未知错误的代码.
-	UnknownCode = http.StatusInternalServerError
-	// UnknownReason 定义了未知错误的原因.
-	UnknownReason = ""
-)
-
 // ErrorX 定义了 OneX 项目体系中使用的错误类型，用于描述错误的详细信息.
 type ErrorX struct {
 	// Code 表示错误的 HTTP 状态码，用于与客户端进行交互时标识错误的类型.
@@ -106,7 +99,7 @@ func Code(err error) int {
 // Reason 返回特定错误的原因.
 func Reason(err error) string {
 	if err == nil {
-		return UnknownReason
+		return ErrInternal.Reason
 	}
 	return FromError(err).Reason
 }
@@ -129,12 +122,12 @@ func FromError(err error) *ErrorX {
 	// 则返回一个带有默认值的 ErrorX，表示是一个未知类型的错误.
 	gs, ok := status.FromError(err)
 	if !ok {
-		return New(UnknownCode, UnknownReason, err.Error())
+		return New(ErrInternal.Code, ErrInternal.Reason, err.Error())
 	}
 
 	// 如果 err 是 gRPC 的错误类型，会成功返回一个 gRPC status 对象（gs）.
 	// 使用 gRPC 状态中的错误代码和消息创建一个 ErrorX.
-	ret := New(httpstatus.FromGRPCCode(gs.Code()), UnknownReason, gs.Message())
+	ret := New(httpstatus.FromGRPCCode(gs.Code()), ErrInternal.Reason, gs.Message())
 
 	// 遍历 gRPC 错误详情中的所有附加信息（Details）.
 	for _, detail := range gs.Details() {