N2CMS Mvc Examples 学习记录 (3) – 控制器类
一共有 5 个控制器。
1. ContentCotroller
1: [Controls(typeof(AbstractPage))]
2: public class ContentController : ContentController
3: {
4: }
Controls特性指定控制器要使用哪种类型的内容项(模型)，这里指定的是AbstractPage，而不是ContentPage，说明它可以使用任何一种内容项，不过有些内容项已经有对应的控制器了，只有没有对应控制器的内容项才会被这个控制器使用。
另外可以看出，控制器的父类被指定为ContentController，这是N2中定义的控制器类，这个类中实现了Index方法（虚拟方法），对于普通内容项已经够用，所以这里不需要重写了。
2. NewsController
1: [Controls(typeof(NewsPage))]
2: public class NewsController : ContentController
3: {
4: public override ActionResult Index()
5: {
6: var vd = new NewsViewData
7: {
8: News = CurrentItem,
9: Back = CurrentItem.Parent,
10: Comments = CurrentItem.GetComments()
11: };
12: return View("index", vd);
13: }
14:
15: public ActionResult Comment()
16: {
17: return View("Comment", CurrentItem);
18: }
19:
20: public ActionResult Submit(string title, string text)
21: {
22: CommentItem comment = Engine.Definitions.CreateInstance(CurrentItem);
23: comment.Title = Server.HtmlEncode(title);
24: comment.Text = Server.HtmlEncode(text);
25: Engine.Persister.Save(comment);
26:
27: return RedirectToAction("index");
28: }
29: }
它控制新闻内容及其评论内容的所有请求和处理，包括获取某条新闻及其对它的所有评论、显示添加评论表单和提交评论。注意这里用到了NewsViewData类，这是视图数据类，它提供了新闻所需要的包括自己在内的必要信息，这个类在下篇中会看到代码。
Index方法在这里重写了，因为显示新闻内容的时候，还需要显示针对此新闻的所有评论和其他的一些辅助内容，比如后退到哪里，所以另外定义了专门的NewsViewData类来存储这些数据，并绑定到视图中。
Comment方法响应GET请求，它把添加评论的视图返回到浏览器让用户能够输入评论。
Submit方法响应POST请求，它负责创建一条评论对象并持久化。Engine.Definitions.CreateInstance(CurrentItem)的作用是在当前新闻内容项的子结点中添加一个评论项对象，设置了标题和文本之后，通过Engine.Persister.Save()方法把这个评论持久化到数据源中。最后回到新闻页面。
这里需要好好研究Engine对象，它提供了许多管理N2所必需的功能，如果以后要深度定制CMS的话，肯定会用的到。
3. NewsContainerController
1: [Controls(typeof(NewsContainer))]
2: public class NewsContainerController : ContentController
3: {
4: public override ActionResult Index()
5: {
6: return View("Index", new NewsContainerViewData { Container = CurrentItem, News = CurrentItem.GetNews()});
7: }
8:
9: public ActionResult JsonList()
10: {
11: var news = CurrentItem.GetNews().Select(n => new { n.Title, n.Url });
12: return Json(news);
13: }
14: }
这个控制器的作用就是获取所有的新闻，然后传给新闻容器视图。这里也用到了视图数据类，NewsContainerViewData，它存储了新闻容器项和所有的新闻列表。
这里还定义了一个JsonList方法，返回JSON格式的新闻列表，不知道会在哪里用到。
4. TextPartController
1: [Controls(typeof(Models.TextPart))]
2: public class TextPartController : ContentController
3: {
4: public override ActionResult Index()
5: {
6: return View(CurrentItem);
7: }
8: }
这里没有什么好说的，我感觉Index没有必要重写，因为父类的Index方法就是这样写的。
5. StaticController
代码不需要贴了，这个类没有用到N2的任何代码，似乎就是用VS新建的MVC项目中的HomeController改的。它不受N2的任何控制，也不会在N2的管理界面中出现，不过它可以和N2共存。