MES开发与应用 课件 控制器控制器实现介绍- 平台编辑器使用配置

3.4平台通用配置深圳市信息职业技术学院——控制器与界面分组介绍目

录控制器实现介绍01框架分组介绍及自定义分组的实现方式02自定义分组的实现示例03自定义分组的注意事项04知识回顾提交事件的使用场景介绍；提交前事件的开发实现步骤；提交后事件的开发实现步骤；提交事件的经验总结；学习目标通过本节学习可以：掌握控制器的使用；掌握自定义分组的开发实现；掌握自定义分组可能引发的异常并能对其进行修复；了解框架分组的实现逻辑。01控制器实现介绍控制器类介绍控制器类介绍控制器：主要用于处理业务的后端数据库操作的逻辑实现，通常一个实体对应一个控制器，如实体名为Item，则控制器的名称为ItemController，对Item进行增删改查方法的实现在ItemController中进行实现。控制器命名规范：XXXController，即以Controller结尾。控制器类实现：

控制器类：必须建在服务端工程中

访问修饰符：public

继承：DomainController

方法：非私有方法必须是虚方法virtual，且功能逻辑相似的方法尽量放到一起，方法的编写与C#基础的方法编写规范一致。控制器类方法的调用：RT.Service.Resolve<控制器类名>().方法名(方法参数)；思考题本地代码启用代理调试，客户端调用控制器的方法执行不了报错的原因？调用的控制器方法未标记为virtual。02框架分组介绍及自定义分组的实现方式框架分组介绍框架ViewConfig的默认分组包括：ListView、DetailsView、SelectionView、QueryView、ImportView。框架默认的分组原理：界面首先进入到ConfigView方法中，在该方法中通过对ViewGroup进行分组判断，如果分组ViewGroup为ListView则进入到ConfigListView方法中，进行列表界面呈现的配置；如果分组ViewGroup为DetailsView则进入到ConfigDetailsView方法中，进行添加修改命令界面呈现配置；如果分组ViewGroup为SelectionView则进入到ConfigSelectionView方法中，进行下拉选择列表的界面配置；如果分组ViewGroup为QueryView则进入到ConfigQueryView方法中，进行查询条件的界面配置；如果分组ViewGroup为ImportView则进入到ConfigImportView方法中，进行下载Excel模板的列头配置。框架分组介绍自定义分组的实现方式在很多场景下，使用框架默认的列表和表单分组方法是无法满足项目需求的，比如框架从菜单进入页面默认是列表界面，如果想点击菜单就打开为表单；又比如我们希望在表单操作时，新增和修改的操作界面不一样等等之类的需求，框架提供的默认分组是无法满足这种个性化的需求，这个时候就需要引入自定义分组来解决这种需求。从前面的框架默认分组原理能够看出，要使用自定义分组其实就是更改ViewGroup的值，不进入到框架的视图配置方法中，自己定义视图配置方法去实现项目需求。框架自定义分组的实现方式包括三种：主界面自定义分组的实现、子列表或者子表单自定义分组的实现、命令自定义分组的实现。自定义分组的实现方式思考题ConfigDetailsView方法默认什么情况下会执行进来？设置编辑模式为表单编辑，点击添加或者修改按钮会执行进来。03自定义分组的实现示例思考题点击菜单，进入菜单主界面，展示为表单形式，应该如何实现？主界面自定义分组的使用

功能描述：在读者分类中点击菜单进入到界面功能，不进入配置列表视图，而是进入到我们自定义的视图配置方法中。实现步骤：1、在读者分类中定义一个分组的常量（这里不直接用字符串是字符串出了问题难定位问题）主界面自定义分组的使用主界面自定义分组的使用

2、在配置菜单中使用分组，分组名为上面定义的常量名。主界面自定义分组的使用主界面自定义分组的使用

3、在读者分类中自定义一个视图配置方法。主界面自定义分组的使用主界面自定义分组的使用

4、在读者分类的配置视图ConfigView方法中添加分组的判断，分组为我们自定义的分组名时，调用步骤3的方法。主界面自定义分组的使用主界面自定义分组的使用

5、效果。主界面自定义分组的使用思考题主从结构，主表为表单编辑，从表为行内编辑，主界面从表的展示与主表添加修改按钮从表的展示不一致，如何实现？子列表自定义分组的使用步骤

功能描述：图书分类添加修改命令中图书小类使用自定义分组实现。需求描述子列表自定义分组的使用步骤

1、在读书小类视图配置中定义一个分组常量。子列表自定义分组的使用子列表自定义分组的使用步骤

2、在图书大类的明细视图ConfigDetailsView的图书小类的子列表属性中使用分组。子列表自定义分组的使用子列表自定义分组的使用步骤

3、在图书小类中添加自定义视图配置方法。子列表自定义分组的使用子列表自定义分组的使用步骤

4、在图书小类的配置视图ConfigView方法中添加分组的判断，分组为我们自定义的分组名，调用步骤3的方法。子列表自定义分组的使用子列表自定义分组的使用步骤

5、效果。子列表自定义分组的使用说明：附加子列表和附加子表单的自定义分组的实现步骤与子列表自定义分组实现步骤一致。思考题表单编辑模式，添加和修改按钮的界面配置不一致，应该如何实现？命令自定义分组的使用步骤

命令的自定义分组主要是指表单编辑模式下的自定义分组，列表编辑模式(行内编辑模式)的操作命令都是在表格内操作，没有分组的设置。功能描述：这里以图书分类的添加命令为例，点击添加命令进入到自定义分组视图配置的实现，如下图描述。业务需求命令自定义分组的使用步骤

1、在读书大类中添加自定义视图配置方法。业务需求命令自定义分组的使用步骤

2、在读书大类的ConfigView方法中调用自定义视图配置方法。业务需求命令自定义分组的使用步骤

3、重写添加命令(js文件需要嵌入到资源)，更改框架默认的ViewGroup（与步骤2的分组名一致），这里只需要掌握命令分组的更改，添加命令的具体使用在添加命令中再详细介绍。业务需求命令自定义分组的使用步骤

4、在读书大类的ConfigListView方法中替换添加命令。业务需求命令自定义分组的使用步骤

5、效果。业务需求04自定义分组的注意事项自定义分组注意事项1、自定义分组的分组名尽量不要使用字符串，容易出错；2、自定义分组一定要记得进行额外授权，否则普通权限会存在问题；

通过View.DeclareExtendViewGroup(分组名)进行授权。3、自定义视图配置方法使用默认命令组合不生效（即View.UseDefaultCommands()失效），必须通过View.UseCommands(WebCommandNames.Add)一个个将命令加上；4、自定义视图配置方法的属性后面必须加show()，否则属性显示不出来，如下必须将show配置上

View.Property(p=>p.Code).Show();5、自定义视图配置方法要使用using(View.OrderProperties())对列显示顺序进行排序，否则列显示顺序会乱。注意事项思考题自定义分组普通账号界面权限异常的排查思路？1、检查分配权限的用户是否为普通账号对应的库存组织的管理员；2、有没有在菜单中进行“更新功能模块”或“更新选定模块”；3、自定义的分组名有没有使用View.DeclareExtendViewGroup()加到额外的视图中。练习1、自定义分组的列要按顺序显示，需要在自定义视图方法中使用（）指定列显示顺序。2、自定义分组方法中，列要能正常显示，需要在属性列配置后面加（）。3、自定义分组普通账号权限正常，需要在界面配置ConfigView方法中配置（）。4、自定义分组方法中可以使用View.UseDefaultCommands()配置界面命令。（）View.OrderProperties()View.DeclareExtendViewGroup(自定义分组名);错Show()本章小结本章主