当前位置：首页 > article >正文

贴代码框架PasteForm特性介绍之query,linkquery

article 2024/11/24 22:15:01

简介

PasteForm是贴代码推出的 “新一代CRUD” ，基于ABPvNext，目的是通过对Dto的特性的标注，从而实现管理端的统一UI，借助于配套的PasteBuilder代码生成器，你可以快速的为自己的项目构建后台管理端！目前管理端只有Html+js版本的，后续将支持小程序，Vue等

案例源码

案例源码在

https://gitee.com/pastecode/paste-template

不定期升级

AllInDto!

通过引入PasteForm，一个项目哪怕100个数据表，一般的管理页面也才不到10个，除非有非常多的特殊功能，否则都能用PasteForm中的表格和表单来实现！

在这里插入图片描述

本次的特性介绍，涉及的东西会多一些，你可以下载源码后，看看详细的，我们先来查看下各个特性的信息

需求说明

对于前端来说，query太熟悉不过了，比如编辑一般都有?id=xxx，有些时候也会有一些特殊的需求，比如你想看下某一个权限下面有哪些子权限，如果没有的话新增(新增在这个权限下，也就是作为当前权限的子集),那么你就需要linkquery和query,一个是传递参数给下一个页面，另外一个是获取query到指定的地方！

query

如果从query中获取到了数据，则对应的字段隐藏,注意不要配置hidden,因为查询的时候是从表单读取数据的，hidden的话是不写入到form中的，那样查询就没法获取query来的值了

字段	类型	示例	说明
args1	字符	cateid	表示使用url中的哪个参数读取值
args2	字符	hide	如果从query中获取到值后，是否隐藏这个项

linkquery

把当前页面的某一个或者多个query传递给下一个页面，多个之间用,隔开。在ListDto中，其实是传递给上方的搜索区域的！对于表单就是传递给表单了!接收需要使用query特性

字段	类型	示例	说明
args1	字符	需要传递的参数	多个之间用,隔开，比如serviceid,ftype

下面就以上面的案例来举例子，就是查看某一个权限的子集，可以在查看页面直接添加，则有

Dto

    ///<summary>
    ///权限列表
    ///</summary>
    [PasteLinkQuery("fatherId")]
    public class RoleInfoListDto
    {

		// 其他干扰字段，先隐藏了

        /// <summary>
        /// 查看子集
        /// </summary>
        [ColumnDataType("menu", "查看子集", "open_window('查看子集','./index.html?path=roleInfo&fatherId={{:=item.id}}');")]
        public int Menu3 { get; set; }

    }

由于上面是ListDto的范畴，也就是表格，那么在搜索区域就需要对应的接收这个query的配置

        /// <summary>
        /// 读取ListDto的数据模型
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        [TypeFilter(typeof(RoleAttribute), Arguments = new object[] { "root", "root" })]
        public PasteBuilderHelper.VoloModelInfo ReadListModel()
        {
            var _model = PasteBuilderHelper.ReadModelProperty<RoleInfoListDto>(new RoleInfoListDto());
            var _query_model = PasteBuilderHelper.ReadModelProperty(new InputQueryRoleInfo());
            if (_query_model != null)
            {
                _model.QueryProperties = _query_model.Properties;
            }
            return _model;
        }

看上面的数据模型，可以知道，搜索区域的数据模型为InputQueryRoleInfo,由如下代码

    ///<summary>
    /// 查询
    ///</summary>
    public class InputQueryRoleInfo : InputSearchBase
    {

        /// <summary>
        /// 父级ID 基于父级ID查询
        /// </summary>
        [PasteOuter("roleInfo")]
        [ColumnDataType("query", "fatherId","hide")]
        public int FatherId { get; set; }

		//其他字段，这里隐藏

    }

看上面的代码，使用了特性query接收fatherId这个参数，然后赋值给当前字段，也就是赋值给FatherId,由于PasteForm框架的API接口返回，首单次小写，所以也就是给fatherId了！当然如果上面的你修改成

        /// <summary>
        /// 父级ID 基于父级ID查询
        /// </summary>
        [PasteOuter("roleInfo")]
        [ColumnDataType("query", "fatherId","hide")]
        public int father_id { get; set; }

也是可以的，到时候会把url的query中的fatherId赋值给这个father_id字段
按照上面的意思，已经可以把fatherId传递给表格页面了，那么如果页面上没有数据，或者要新增，就需要把这个fatherId传递给下一个页面(view.html)，同样的，需要在UserInfoAddDto接收这个参数，则有如下的

    ///<summary>
    ///权限 新增权限的数据模型
    ///</summary>
    public class RoleInfoAddDto
    {
        ///<summary>
        ///名称 权限的友好名称
        ///</summary>
        [MaxLength(16)]
        [Required]
        public string Name { get; set; }

        ///<summary>
        ///模块
        ///</summary>
        [MaxLength(16)]
        public string Model { get; set; }

        ///<summary>
        ///权限
        ///</summary>
        [MaxLength(16)]
        public string Role { get; set; }

        /// <summary>
        /// 图标名称 一般表示样式名称
        /// </summary>
        [MaxLength(32)]
        public string Icon { get; set; }

        /// <summary>
        /// 路径 作为菜单类型的路径
        /// </summary>
        [MaxLength(128)]
        public string Path { get; set; }

        /// <summary>
        /// 权限类型 0权限1菜单2按钮
        /// </summary>
        [PasteSelect(PasteFormString.SelectRoleType)]
        public int RoleType { get; set; }

        ///<summary>
        ///描述
        ///</summary>
        [MaxLength(64)]
        public string Desc { get; set; }

        ///<summary>
        ///状态
        ///</summary>
        public bool IsEnable { get; set; }

        ///<summary>
        ///排序
        ///</summary>
        public int Sort { get; set; }

        ///<summary>
        ///父级的概念
        ///</summary>
        [ColumnDataType("query", "fatherId","hide")]
        [ColumnDataType("outer", "roleInfo", "extendRole", "id", "name")]
        public int FatherId { get; set; }

    }