// Copyright (c) 2022-Now 少林寺驻北固山办事处大神父王喇嘛 // // SimpleAdmin 基于 Apache License Version 2.0 协议发布,可用于商业项目,但必须遵守以下补充条款: // 1.请不要删除和修改根目录下的LICENSE文件。 // 2.请不要删除和修改SimpleAdmin源码头部的版权声明。 // 3.分发源码时候,请注明软件出处 https://gitee.com/dotnetmoyu/SimpleAdmin // 4.基于本软件的作品,只能使用 SimpleAdmin 作为后台服务,除外情况不可商用且不允许二次分发或开源。 // 5.请不得将本软件应用于危害国家安全、荣誉和利益的行为,不能以任何形式用于非法为目的的行为。 // 6.任何基于本软件而产生的一切法律纠纷和责任,均于我司无关。 namespace SimpleAdmin.Core; /// /// 全局分页查询输入参数 /// public class BasePageInput : IValidatableObject { /// /// 当前页码 /// [DataValidation(ValidationTypes.Numeric)] public virtual int PageNum { get; set; } = 1; /// /// 每页条数 /// [Range(1, 100, ErrorMessage = "页码容量超过最大限制")] [DataValidation(ValidationTypes.Numeric)] public virtual int PageSize { get; set; } = 10; /// /// 排序字段 /// public virtual string SortField { get; set; } /// /// 排序方式,升序:ascend;降序:descend" /// public virtual string SortOrder { get; set; } = "desc"; /// /// 关键字 /// public virtual string SearchKey { get; set; } public IEnumerable Validate(ValidationContext validationContext) { SortOrder = (string.IsNullOrWhiteSpace(SortOrder) ? "desc" : SortOrder.Trim().ToLowerInvariant()) switch { "ascend" => "asc", "descend" => "desc", var value => value }; if (SortOrder != "asc" && SortOrder != "desc") yield return new ValidationResult("排序方向仅支持 asc/desc", new[] { nameof(SortOrder) }); if (!string.IsNullOrEmpty(SortField) && !global::System.Text.RegularExpressions.Regex.IsMatch( SortField, @"\A[A-Za-z_][A-Za-z0-9_]{0,63}\z")) yield return new ValidationResult("排序字段格式不正确", new[] { nameof(SortField) }); } /// /// 将客户端字段映射为服务端白名单列,禁止把排序表达式传入 ORM。 /// 服务层再次校验,避免非 HTTP 调用绕过 MVC 参数校验。 /// public string GetSafeOrderBy(params string[] allowedFields) { var error = Validate(new ValidationContext(this)).FirstOrDefault(); if (error != null) throw Oops.Bah(error.ErrorMessage); if (string.IsNullOrEmpty(SortField)) return string.Empty; var field = allowedFields.FirstOrDefault(item => string.Equals(item, SortField, StringComparison.OrdinalIgnoreCase)); if (field == null) throw Oops.Bah("不支持按此字段排序"); return $"{field} {SortOrder}"; } }