MenuDefinition:封装了导航栏上的主菜单的属性。
MenuItemDefinition:封装了主菜单的子菜单的属性。子菜单可以引用其他子菜单构成一个菜单树
UserMenu/UserMenuItem:封装了用于显示给用户的菜单/以及子菜单集合。 ABP通过MenuDefinition/MenuItemDefinition构成了完整的系统菜单集合(超集)。而UserMenu/UserMenuItem只构成用户所能访问的菜单集合,并且其DisplayName是本地化以后的DisplayName。
INavigationManager:这个接口封装了一个字典类型的Menus和MenuDefinition类型的MainMenu。
NavigationManager:实现了INavigationManager,运行时是一个单例对象。完成菜单集的初始化。navigationManager在Initialize方法中先从configuration中获取NavigationProvider派生类的type,然后通过容器生成该类型的实例,并调用NavigationProvider实例的SetNavigation完成菜单项的初始化。navigationManager的Initialize方法是在AbpKernelModule的PostInitialize方法中被调用的。
INavigationProviderContext/NavigationProviderContext:上下文类,被用做方法的参数。这边只封装了INavigationManager对象
NavigationProvider: 功能类似于FeatureProvider。抽象基类,用于设置NavigationManager的Menus和MainMenu(通过 INavigationProviderContext对象访问NavigationManager)。 Abp框架只提供了抽象类,下面代码是一个简单的示例。实际项目中可以创建自定义NavigationProvider来从数据库中读取Menu信息来填充到NavigationManager对象中。
下面以SimpleTask项目为例: 该项目自定义了NavigationProvider的派生类,并且在module的preinitialize方法中将其注册到abp底层框架的configuration 中。
INavigationConfiguration/NavigationConfiguration: NavigationManager通过具体的NavigationProvider来初始化Menus和MainMenu。但是ABP核心模块处于最底层,怎么能知道上层定义的NavigationProvider的类型呢? NavigationConfiguration为解决这个问题引入了NavigationProvider配置项。NavigationProvider就是一个Type 列表 (ITypeList<NavigationProvider>),注意是NavigationProvider的Type,不是实例。在需要NavigationProvider的地方,可以使用容器根据Type构造出实例。
下面代码演示了怎么往ABP中添加具体的NavigationProvider。
IUserNavigationManager/UserNavigationManager: 通过INavigationManager的menus和用户信息,生成该用户可访问的菜单集合。主要检查两点:一是通过PermissionChecker检查一个用户是否拥有对某个菜单项的访问权限,另一项则是通过featurechecker检查一个用户所在的tenant是否有对该菜单项的访问权限。