当前位置: 首页 > 工具软件 > N2CMS > 使用案例 >

N2CMS Mvc Examples 学习记录 (3) – 控制器类

慕容典
2023-12-01

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

 类似资料: