学习之模块架构 DotNetNuke 6

前面的博客介绍了：

如何在本地安装DNN6

如何创建DNN模块

博客园原文地址 ：  学习之模块架构 DotNetNuke 6

这篇博客主要是讲模块的架构和加载，以及模块与DotNetNuke门户网站（Portals）系统的关系。充分了解模块可以帮助DNN开发者根据需要更清晰的构建模块。
在DNN中，模块是一个可插入的用户接口组件，用来处理请求并生成动态的内容。它只能出现在ASP.NET页面上，而页面可以包括任意数量的模块"实例"。
整个模块架构包括四个部分 ： 门户网站（Portal），页面（Tab），模块（Module）和模块容器（Container）。

• 门户网站（Portal）

Portal可以定义为一个基于Web的应用程序，从不同的源聚集内容，并寄宿信息系统的表示层（模块）。下图描述了Portal的基本架构，DNN处理页面请求时需要执行许多步骤。下述步骤在页面初始化的过程中执行，用来在运行时动态地加载模块。动态创建的模块然后就能够处理它们自己的生存周期，包括诸如初始化、加载、呈现等各种事件。

图一 ： Portal的基本架构

第一步： 页面配置检索（Page Configuration Retrieval）

第1步就是为被请求的页面检索模块。检索步骤由许多重要的信息块构成，例如页面上出现的各个模块、模块在页面上显示的区域（即内容窗格Pane），以及与每个模块相关联的安全角色。

//Default.aspx.cs//OnInit//load skin control and register UI js
UI.Skins.Skin ctlSkin = UI.Skins.Skin.GetSkin(this);
//add skin to page
SkinPlaceHolder.Controls.Add(ctlSkin);

//DotNetNuke.UI.Skins.Skin.cs : OnInit()
bool success;
//Load the Module Control(s)
success = Globals.IsAdminControl() ? ProcessSlaveModule() : ProcessMasterModules();

//DotNetNuke.UI.Skins.Skin.cs : ProcessMasterModules()
bool success = true;
if (TabPermissionController.CanViewPage())
{
　　//check portal expiry date
　　if (!CheckExpired())
　　{
　　　　if ((PortalSettings.ActiveTab.StartDate < DateAndTime.Now && PortalSettings.ActiveTab.EndDate > DateAndTime.Now) || TabPermissionController.CanAdminPage() || Globals.IsLayoutMode())
　　　　{
　　　　　　//dynamically populate the panes with modules
　　　　　　if (PortalSettings.ActiveTab.Modules.Count > 0)
　　　　　　{
　　　　　　　　foreach (ModuleInfo objModule in PortalSettings.ActiveTab.Modules)
　　　　　　　　{
　　　　　　　　　　success = ProcessModule(objModule);
　　　　　　　　}
　　　　　　}

第二步： 安全审计（Security Audit）

第2步就是判断在上一步中检索出来的安全信息。通过检查当前用户的角色（是注册用户还是匿名用户）以及与每个模块相关联的查看角色，就可以为当前页面形成一列经过“授权”的模块。

private Boolean ProcessModule(ModuleInfo module)
{
　　bool success = true;
　　if (ModulePermissionController.CanViewModule(module) && module.IsDeleted == false &&
((module.StartDate < DateTime.Now && module.EndDate > DateTime.Now) || Globals.IsLayoutMode() || Globals.IsEditMode()))
　　{
　　//...
　　}
　　//...
}

第三步：内容注入（Content Injection）

第3步（也是最后一步）就是将“授权”模块动态地插入到页面上相应的内容窗格中。在所有的模块加载之后，每个模块就能够执行各自的事件并呈现内容。

Pane pane = GetPane(module);
if (pane != null)
{
　　success = InjectModule(pane, module);
}

• 页面（Tab）

图二描述了基本的Portal的Tab组件。页面本身表示一个完整的标记文档，由大量的内容窗格（Pane）组成，并且在每个内容窗格中还包含大量的模块。

图二：页面组件

每个模块都包含一个标题、若干装饰（Container）以及由模块生成的内容。装饰可以包括若干按钮、链接以及一个改变模块状态或者执行与模块相关功能的悬浮菜单。

• 模块（Module）

正如前面所述，Portal是基于Web的应用程序，处理各种请求并生成动态内容。每个模块都生成自己的标记块（称为段），再和皮肤的标记一起展示完整的文档。
因为每个模块都生成自己的标记，所以可以将模块视为较大应用程序中的微型应用程序。通常，用户通过单击链接或者提交表单（所提交的表单由门户网站系统及传递给相应模块的命令处理）与每个模块生成的内容交互。

• 模块容器（Container）

模块周围的装饰称为模块容器。通过容器，用户能够与模块交互，执行诸如最小化、最大化以及其他高级特性（如果用户拥有该页面的编辑特权）的动作。
图三示范了一个HTML模块在用户以编辑特权登录时的模块容器。这个模块容器包含许多项，例如拥有一列管理选项的悬浮菜单、模块的标题。

图三：模块容器

DotNetNuke est le plus gros projet open-source en technologie .Net.