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共存。