enhance(error): with params

docs/error-handler/index.md

@@ -118,3 +118,42 @@ var (
 ```
 
 届时，前端可以根据获取到的 `scope` 和 `code` 来进行相应的处理。
+
+## 附加参数
+在 `v1.12.0` 中，我们新增了一个 `cosy.NewErrorWithParams` 方法，用于在创建错误时附加额外的参数。
+
+```go
+func NewErrorWithParams(code int32, message string, params ...string) error
+```
+
+需要注意的是，message 的内容需要包含 `{index}` 作为参数的占位符，否则在控制台的打印中不能输出正确的错误信息，例如：
+
+```go
+e = cosy.NewErrorScope("tracking")
+
+cErr := e.NewWithParams(500, "跟踪信息 {0} 的错误是 {1}", "foo", "bar")
+```
+
+当使用 `logger` 打印时候，它将会输出：
+```
+跟踪信息 foo 的错误是 bar
+```
+
+使用 `cosy.Errhander` 处理时，会响应：
+```json
+{
+  "scope": "tracking",
+  "code": 500,
+  "message": "跟踪信息 {0} 的错误是 {1}",
+  "params": ["foo", "bar"]
+}
+```
+
+您也可以直接使用 `cosy.NewErrorWithParams` 来创建一个无作用域的错误，在使用 `cosy.ErrHandler` 处理时，会响应：
+```json
+{
+  "code": 500,
+  "message": "跟踪信息 {0} 的错误是 {1}",
+  "params": ["foo", "bar"]
+}
+```

error.go

@@ -2,12 +2,14 @@ package cosy
 
 import (
 	"errors"
+	"fmt"
 	"github.com/gin-gonic/gin"
 	"github.com/uozi-tech/cosy/logger"
 	"github.com/uozi-tech/cosy/settings"
 	"go.uber.org/zap"
 	"gorm.io/gorm"
 	"net/http"
+	"strings"
 )
 
 type ErrorScope struct {
@@ -18,6 +20,7 @@ func NewErrorScope(scope string) *ErrorScope {
 	return &ErrorScope{scope}
 }
 
+// New create a new error with scope
 func (s *ErrorScope) New(code int32, message string) error {
 	return &Error{
 		Scope:   s.scope,
@@ -26,23 +29,51 @@ func (s *ErrorScope) New(code int32, message string) error {
 	}
 }
 
+// NewWithParams create a new error with scope and params
+func (s *ErrorScope) NewWithParams(code int32, message string, params ...string) error {
+	return &Error{
+		Scope:   s.scope,
+		Code:    code,
+		Message: message,
+		Params:  params,
+	}
+}
+
 type Error struct {
-	Scope   string `json:"scope,omitempty"`
-	Code    int32  `json:"code"`
-	Message string `json:"message"`
+	Scope   string   `json:"scope,omitempty"`
+	Code    int32    `json:"code"`
+	Message string   `json:"message"`
+	Params  []string `json:"params,omitempty"`
 }
 
 func (e *Error) Error() string {
-	return e.Message
+	if len(e.Params) == 0 {
+		return e.Message
+	}
+	msg := e.Message
+	for index, param := range e.Params {
+		msg = strings.Replace(msg, fmt.Sprintf("{%d}", index), param, 1)
+	}
+	return msg
 }
 
+// NewError create a new error
 func NewError(code int32, message string) error {
 	return &Error{
 		Code:    code,
 		Message: message,
 	}
 }
 
+// NewErrorWithParams create a new error with params
+func NewErrorWithParams(code int32, message string, params ...string) error {
+	return &Error{
+		Code:    code,
+		Message: message,
+		Params:  params,
+	}
+}
+
 // errorResp error response
 func errorResp(c *gin.Context, err error) {
 	var cErr *Error