back-app-configuration.cs 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. public interface IAppRuntimeFilter {
  2. // APP端专用策略属性, 可判定Vue-Store上所有支持的属性及子属性
  3. // AppConfigNode.content中任何数组属性或者数组子属性及后代属性,都支持implement该接口
  4. // 后台可以将此属性赋值到配置内容的相应属性,让前端自行筛选(这样可以减少API输出差异);
  5. // 也可以自行筛选将最终结果返回给不同用户(这样可以减少传输量),推荐前者。
  6. public string[] satisfyStoreGetters;
  7. public bool satisfyAny;
  8. }
  9. /// 可以定制具体的配置文件类
  10. public class AppConfigNode<out T> {
  11. // 对应APP配置模块中要替换的配置结点Key
  12. public string key;
  13. // 配置内容,任意内容
  14. public T content;
  15. }
  16. /// 也可以模糊处理
  17. public class AppConfigNode: AppConfigNode<object> {
  18. }
  19. /// 此接口用来生成最终配置文件
  20. public interface IAppConfigProvider {
  21. List<AppConfigNode> get(); // 获取正常开启的配置项
  22. Dictionary<string, object> output(); // 最终输出结果
  23. }
  24. /// Table - top entry
  25. public class AppConfigStrategy {
  26. public string key; // 要替换的app config key
  27. public string desc; // 配置说明,方便UI展示示意
  28. public string content; // 22.9.9 配置的序列化内容,可能为string/number/boolean/object/array。(这样就不需要下面的AppConfigContent和AppConfigContentItem表)
  29. /** 22.9.9 由 {key: content} 拼接,加载入JSONObject, 读取里面所有的object结点(包括array内部的,支持无限递归);
  30. 获取object的refPermissionId属性,如果没有该属性,不用处理;如果有该属性,则将此refPermissionId关联PC端的菜单与按钮权限;
  31. 计算当前用户是否存在该权限,并操作和修改refPermissionId的平级属性:satisfyStoreGetters 和 satisfyAny
  32. 第1版,可粗略返回:有权限时为satisfyStoreGetters赋值[], 无权限时为satisfyStoreGetters赋值['false']
  33. **/
  34. // 控制策略
  35. public bool disabled; // 禁用,总开关
  36. public string minVersion; // 最低启用版本,不填不限
  37. public string maxVersion; // 最高启用版本,不填不限
  38. public string[] osTypes; // 操作系统,不填不限
  39. public string[] roles; // 角色,不填不限
  40. public string[] periods; // 学阶,不填不限
  41. // 自定义策略
  42. public string[] customStrategies; // 可能需要更复杂的判定逻辑,比如要取某些业务表才能决定
  43. }
  44. [key:'indexElectiveBlocks','desc':'大数据选科模块']
  45. /// Table - config dynamic content
  46. public class AppConfigContent {
  47. public string scope; // parent key
  48. public EnumScopeType scopeType; // type builder
  49. public string desc; // 配置说明,方便UI展示示意
  50. public string itemKey; // map to AppConfigContentItem.key, 没有则直接作用于scope
  51. public string alias; // 别名,用于填充配置时使用,没有则使用itemKey,用于适配同名属性
  52. public string value; // single、multiple时可能要保存选择结果;或者直接填写值
  53. public string customValueFormatter; // 装配配置时的自定义格式转换器
  54. public long refPermissionId; // 菜单或者按钮权限ID
  55. }
  56. [scope:'indexElectiveBlocks.0.dataList.0',itemKey: 'satisfyStoreGetters',
  57. customValueFormatter: customFilterFormatter--ImplementByJava,
  58. refPermissionId: 直接填写菜单或者按钮权限ID]
  59. /// Table - content value shared item pool
  60. public class AppConfigContentItem {
  61. public string key;
  62. public string desc; // 配置说明,方便UI展示示意
  63. public string options; // 配置选项,供于前端选择
  64. public string customOptionsLoader; // 自定义选科加载类,解决固定配置无法完成的部分
  65. public EnumAppConfigOptionType enumOptionType; // 选项使用类型
  66. }
  67. [key:'satisfyStoreGetters', options:['isFrontStudent','isIOS','isMaster']]
  68. public enum EnumScopeType {
  69. none = 0,
  70. obj = 1,
  71. array = 2
  72. }
  73. public enum EnumAppConfigOptionType {
  74. copy = 0, // 直接复制选项值,不需要用户选择
  75. single = 1, // 需要用户选择,单选
  76. multiple = 2, // 需要用户选择,多选
  77. }
  78. public class AppConfigCustomStrategyContext {
  79. public List<ConfigCustomStrategy> strategies;
  80. public ConfigCustomStrategy current;
  81. }
  82. /// 此接口主要用来决策要不要启用某个key的配置替换
  83. public interface IAppConfigCustomStrategy {
  84. bool satisfy(AppConfigCustomStrategyContext context)
  85. }
  86. public class CustomOptionsLoaderContext: AppConfigCustomStrategyContext {
  87. public AppConfigContentItem Item;
  88. }
  89. /// 此接口用来加载配置值的动态选项
  90. public interface ICustomOptionsLoader {
  91. void load(CustomOptionsLoaderContext context)
  92. }
  93. public class CustomValueFormatterContext: AppConfigCustomStrategyContext {
  94. public AppConfigContent content;
  95. }
  96. /// 此接口用来做配置值的输出转换
  97. public interface ICustomValueFormatter {
  98. void format(CustomValueFormatterContext context)
  99. }