prepare for animal mode

app/global/consts/consts.go

@@ -72,4 +72,7 @@ const (
 	CaptchaCheckOkMsg             string = "验证码校验通过"
 	CaptchaCheckFailCode          int    = -400355
 	CaptchaCheckFailMsg           string = "验证码校验失败"
+
+	// TAG animal/ 接口模式
+	AnimalPreferMode string = "prefer"
 )

app/http/controller/web/animal_controller.go

@@ -31,12 +31,22 @@ func (a *Animals) List(context *gin.Context) {
 	skip := context.GetFloat64(consts.ValidatorPrefix + "skip")
 	userId := context.GetFloat64(consts.ValidatorPrefix + "user_id")
 
+	mode := context.GetString(consts.ValidatorPrefix + "mode")
+
+	if mode == consts.AnimalPreferMode {
+		preferList(context)
+	} else { // 其余都是 默认模式。
 		animals := curd.CreateAnimalsCurdFactory().List(attrs, gender, breed, sterilization, status, department, int(num), int(skip), int(userId))
 		if animals != nil {
 			response.Success(context, consts.CurdStatusOkMsg, animals)
 		} else {
 			response.Fail(context, errcode.AnimalNoFind, errcode.ErrMsg[errcode.AnimalNoFind], "")
 		}
+	}
+}
+
+func preferList(context *gin.Context) {
+	// TODO 先去考虑一下前端筛选的实现方式。
 }
 
 // v0.1

app/http/validator/web/animal/list.go

@@ -19,10 +19,12 @@ type List struct {
 	Num           int    `form:"num" json:"num"`
 	Skip          int    `form:"skip" json:"skip"`
 	UserId        int    `form:"user_id" json:"user_id"`
+
+	Mode string `form:"mode" json:"mode"` // INFO 控制 animal_ctl 的查询模式。 // default: 简单调用 List 函数 || prefer: 优先返回和用户关联度更高的目标。
 }
 
 func (l List) CheckParams(context *gin.Context) {
-	if err := context.ShouldBind(&l); err != nil { // INFO 这一条是必要的，看来对数据的解析页在其中。
+	if err := context.ShouldBind(&l); err != nil {
 		// 将表单参数验证器出现的错误直接交给错误翻译器统一处理即可
 		response.ValidatorError(context, err)
 		return

routers/web.go

@@ -3,12 +3,10 @@ package routers
 import (
 	"catface/app/global/consts"
 	"catface/app/global/variable"
-
 	// "catface/app/http/controller/captcha"	// 验证码组件
 	// "catface/app/http/middleware/authorization"
 	"catface/app/http/middleware/cors"
 	validatorFactory "catface/app/http/validator/core/factory"
-
 	// TODO validatorFactory "catface/app/http/validator/core/factory"
 	"catface/app/utils/gin_release"
 	"net/http"