|
| 1 | +# 魔方core说明 |
| 2 | + |
| 3 | +## 菜单注册 |
| 4 | + |
| 5 | +### 区域使用AreaBaseX区域特性 |
| 6 | + |
| 7 | +- 自定义一个继承AreaBaseX的区域特性类，命名为“区域名”+“Area” |
| 8 | +- 继承构造函数base(areaName) |
| 9 | +- 定义的新区域特性要声明一个静态构造函数，调用RegisterArea静态方法 |
| 10 | +- 示例 |
| 11 | + |
| 12 | +```csharp |
| 13 | + /// <summary>权限管理区域注册</summary> |
| 14 | + [DisplayName("系统管理")] |
| 15 | + public class AdminArea : AreaBaseX |
| 16 | + { |
| 17 | + public static string AreaName => nameof(AdminArea).TrimEnd("Area"); |
| 18 | + |
| 19 | + /// <inheritdoc /> |
| 20 | + public AdminArea() : base(AreaName) |
| 21 | + { |
| 22 | + |
| 23 | + } |
| 24 | + |
| 25 | + static AdminArea() |
| 26 | + { |
| 27 | + RegisterArea<AdminArea>(); |
| 28 | + } |
| 29 | + } |
| 30 | +``` |
| 31 | + |
| 32 | +- 如果不使用AreaBaseX区域特性路由，添加权限特性EntityAuthorizeAttribute，会自动添加此菜单 |
| 33 | + |
| 34 | +- 在区域控制器加上上面区域特性类 |
| 35 | + |
| 36 | +```csharp |
| 37 | +[AdminArea] |
| 38 | + public class UserController : EntityController<UserX> |
| 39 | +{ |
| 40 | + |
| 41 | +} |
| 42 | +``` |
| 43 | + |
| 44 | +### 控制器设置 |
| 45 | + |
| 46 | +- 如果控制器继承自魔方的功能控制器，那么会默认菜单相关选项 |
| 47 | +- 如果需要自定义，则需要继承自`ControllerBaseX` |
| 48 | +- 重载`ScanActionMenu`方法，将菜单设置为可见`menu.Visible = true` |
| 49 | +- 声明一个静态变量设置菜单顺序`protected static Int32 MenuOrder { get; set; } = 100;` |
| 50 | +- 示例 |
| 51 | + |
| 52 | +```csharp |
| 53 | + [ApiArea] |
| 54 | + [DisplayName("SwaggerApi")] |
| 55 | + [Description("SwaggerApi")] |
| 56 | + public class SwaggerController : ControllerBaseX |
| 57 | + { |
| 58 | + |
| 59 | + protected static Int32 MenuOrder { get; set; } = 100; |
| 60 | + |
| 61 | + protected override IDictionary<MethodInfo, int> ScanActionMenu(IMenu menu) |
| 62 | + { |
| 63 | + // 设置显示名 |
| 64 | + if (menu.DisplayName.IsNullOrEmpty()) |
| 65 | + { |
| 66 | + menu.DisplayName = typeof(SwaggerController).GetCustomAttribute<DisplayNameAttribute>().DisplayName; |
| 67 | + menu.Visible = true; |
| 68 | + } |
| 69 | + |
| 70 | + var dic = base.ScanActionMenu(menu); |
| 71 | + |
| 72 | + return dic; |
| 73 | + } |
| 74 | + |
| 75 | + // GET: Swagger |
| 76 | + [EntityAuthorize(PermissionFlags.Detail)] |
| 77 | + public ActionResult Index() |
| 78 | + { |
| 79 | + return View(); |
| 80 | + } |
| 81 | + } |
| 82 | +``` |
| 83 | + |
| 84 | +或者 |
| 85 | + |
| 86 | +```csharp |
| 87 | + [ApiArea] |
| 88 | + public class HomeController : EntityController<UserX> |
| 89 | + { |
| 90 | + public override ActionResult Index(Pager p = null) |
| 91 | + { |
| 92 | + return View(); |
| 93 | + } |
| 94 | + } |
| 95 | +``` |
| 96 | + |
| 97 | +## 视图 |
| 98 | + |
| 99 | +### 覆盖优先级 |
| 100 | + |
| 101 | +- 如果项目添加并引用Razor类库，那么它的优先级仅次于项目自身的视图 |
| 102 | +- 其次，要引用nuget包里面的视图或者直接引用一个视图dll，需要手动进行注册，否则不会被出现在系统的查找范围 |
| 103 | +- 可以同时存在多个视图资源，通过这个优先级选择对应视图，请查看下面更多说明 |
| 104 | +- 魔方的视图结构请[查看这里](查看这里还什么也没有) |
| 105 | + |
| 106 | +### 注册方法 |
| 107 | + |
| 108 | +- 可通过`typeof(Areas_Admin_Views_Index_Index).Assembly.FullName`这样子的名称获得视图所在程序集名称，注册方法如下 |
| 109 | + |
| 110 | +```csharp |
| 111 | + services.AddCustomApplicationParts(asmNaneList => |
| 112 | + { |
| 113 | + asmNaneList.Add(typeof(Areas_Admin_Views_Index_Index).Assembly.FullName); |
| 114 | + }); |
| 115 | +``` |
| 116 | + |
| 117 | +- 如果你想进行模块化开发，加载多个包含控制器的程序集，也是使用上面的方法进行注册 |
| 118 | +- 但请注意控制名不要重复，否则你需要在对[路由命名空间优先级](这部分还没有说明)进行设置 |
| 119 | + |
| 120 | +### 更多说明 |
| 121 | + |
| 122 | +- 所有编译之后的视图程序集，生成的类名和命名空间都是一样的，所以如果同时引用多个含有视图的nuget包，编译器会`typeof(Areas_Admin_Views_Index_Index)`在这里报错 |
| 123 | +- 那为什么Razor类库和项目本身都存在同样名字的视图，又不会报错呢？因为它们都还是源代码，还没编译啊。 |
| 124 | +- core mvc 加载项目本身的控制器和视图的方法`ApplicationPartManager.PopulateDefaultParts`是内部的，不能调用，里面会根据引入的外部控制器所在程序集（比如你的项目引用了A程序集），寻找所有依赖于A程序集的程序集（比如A程序集对应的`A.Views.dll`），一起加载进系统成为系统的一部分。魔方提供`AddCustomApplicationParts`拓展方法自定义加载程序集，即使`A.Views.dll`依赖于A,你也可以选择不加载`A.Views.dll`，通过自己实现自己视图来呈现页面，给你更多的选择！ |
0 commit comments