处理输出
controller完成处理请求后,通常需要生产响应。当我们直接实现 IController 接口创建controller时,我们就需要对处理请求的各个方面负责,包括对客户端的响应。如果我们需要生成HTML响应。比如,我们需要创建组合HTML数据,并使用使用 Response.Write方法传给客户端。相似的,如果我们想给用户浏览器返回另一个URL,我们需要调用Response.Redirect方法,直接传递URL。这些方法都在下面列出:
using System.Web.Mvc;
using System.Web.Routing;
namespace ControllersAndActions.Controllers {
public class BasicController : IController {
public void Execute(RequestContext requestContext) {
string controller = (string)requestContext.RouteData.Values["controller"];
string action = (string)requestContext.RouteData.Values["action"];
requestContext.HttpContext.Response.Write(
string.Format("Controller: {0}, Action: {1}", controller, action));
// ... or ...
requestContext.HttpContext.Response.Redirect("/Some/Other/Url");
}
}
}
当你从Controller类中继承了一个controller,你就使用相同的方法。当你通过Controller.Response属性,在Execute方法鲜中读取requestContext.HttpContext.Response属性时,你得到的返回值是HttpResponseBase类。如下:
using System.Web.Mvc;
namespace ControllersAndActions.Controllers {
public class DerivedController : Controller {
public void Index() {
string controller = (string)RouteData.Values["controller"];
string action = (string)RouteData.Values["action"];
Response.Write(
string.Format("Controller: {0}, Action: {1}", controller, action));
// ... or ...
Response.Redirect("/Some/Other/Url");
}
}
}
This approach works, but it has a few problems:
这个方法也是可行的,但是有几个小问题:
controller类必须包含HTML或者URL结构的详细信息。这就让类的可读性和可维护性变差。
对controller单元测试变的困难,你需要创建模拟的Response信息,使之能从controller接受并处理输出,这意味着要转换HTML关键字,这都是很痛苦的过程。
对每个请求都用这种方法处理非常乏味,而且容易出错。一些程序员喜欢绝对控制,喜欢创建一个未处理过的controller,但是大多数程序员对这种方法很不习惯。
幸运的是,MVC Framework能很好的处理这些问题,这个功能叫做action results。下面会介绍action result的概念,并展示几种不同的从controller生成响应的方法。
理解Action Results
MVC并不直接和Response对象交互,而是返回一个ActionResult类的子类,以此描述我们想从controller中得到的响应,比如呈现视图或者跳转到URL或者另一个action方法。
注意,action result系统只是command模式的一个实例。更多信息,看http://en.wikipedia.org/wiki/Command pattern。
当MVC Framework从action方法中收到一个ActionResult对象,它会调用这个类所定义的ExecuteResult方法。这个action result就会处理response对象。生成符合你意图的输出。一个简单的关于RedirectResult 类的例子。如下。MVC Framework开源的一个好处是,你可以看到背后的工作方式。我们简化了这个类,使之容易读懂。
public class RedirectResult : ActionResult {
public RedirectResult(string url): this(url, permanent: false) {
}
public RedirectResult(string url, bool permanent) {
Permanent = permanent;
Url = url;
}
public bool Permanent {
get;
private set;
}
public string Url {
get;
private set;
}
public override void ExecuteResult(ControllerContext context) {
string destinationUrl = UrlHelper.GenerateContentUrl(Url, context.HttpContext);
if (Permanent) {
context.HttpContext.Response.RedirectPermanent(destinationUrl,
endResponse: false);
}
else {
context.HttpContext.Response.Redirect(destinationUrl, endResponse: false);
}
}
}
当我们创建一个RedirectResult类的实例时,我们传入要定位给用户的URL。 MVC Framework在action方法完成后,会执行ExecuteResult方法,通过framework提供方的 ControllerContext 对象得到query的response对象,同时调用RedirectPermanent方法或者Redirect方法。
我们可以通过创建一个新的RedirectResult实例,并且从action方法返回它。如下代码,展示了DerivedController类有2个action方法,其中之一使用了RedirectResult来重定向请求。
using System.Web.Mvc;
namespace ControllersAndActions.Controllers {
public class DerivedController : Controller {
public void Index() {
string controller = (string)RouteData.Values["controller"];
string action = (string)RouteData.Values["action"];
Response.Write(
string.Format("Controller: {0}, Action: {1}", controller, action));
}
public ActionResult Redirect() {
return new RedirectResult("/Derived/Index");
}
}
}
如果你导航到 /Derived/Redirect,浏览器会重定位到/Derived/Index。为了是代码更简洁,Controller类提供简单的方法来生成不同的ActionResults,比如,我们可以通过返回Redirect方法的结果,实现同样的效果。
public ActionResult Redirect() {
return Redirect("/Derived/Index");
}
这对复杂的action result来说没有什么复杂的,但是你却能写出简洁一致的代码。你也可以很方便的对你的action方法做单元测试。MVC Framework包含了很多内建的action result类型,在下面列出,这些类型都继承自ActionResult,而且大多使用起来都很简单。
通过呈现View来返回HTML
最常用的响应是要从action方法中生成一个HTML,发送给浏览器。当使用action result系统,你通过创建ViewResult实例来指定想要生成的HTML。如下演示代码
using System.Web.Mvc;
namespace ControllersAndActions.Controllers {
public class ExampleController : Controller {
public ViewResult Index() {
return View("Homepage");
}
}
}
这些代码,使用View方法创建了ViewResult类的实例,该实例作为action方法的结果返回。
注意,返回类型是ViewResult,如果把返回值设为ActionResult,那么此方法也会编译运行的很好。事实上,一些MVC程序员喜欢吧每一个action的返回值都定义成ActionResult,即使他们知道返回的是一个特定的类型。在此,我们偏向于只要知道该返回的是什么类型,我们就使用这个返回类型。在下面的例子中我们都会这样做,这会让你清楚的知道返回的是什么类型的值。
这个例子中,我们指定了想要呈现的view,在这个例子中,我们指定的是Homepage view。
注意,我们可以显式的创建ViewResult对象,(返回new ViewResult { ViewName ="Homepage" };)这是一个完美的可行的方法,但是我们哈市偏向使用Controller类中定义的简便方法。
当MVC调用ViewResult对象的ExecuteResult方法,在指定的view上开始一个搜索。如果你项目中使用了area,那么framework会查询下面几个地址:
/Areas/<AreaName>/Views/<ControllerName>/<ViewName>.aspx
/Areas/<AreaName>/Views/<ControllerName>/<ViewName>.ascx
/Areas/<AreaName>/Views/Shared/<ViewName>.aspx
/Areas/<AreaName>/Views/Shared/<ViewName>.ascx
/Areas/<AreaName>/Views/<ControllerName>/<ViewName>.cshtml
/Areas/<AreaName>/Views/<ControllerName>/<ViewName>.vbhtml
/Areas/<AreaName>/Views/Shared/<ViewName>.cshtml
/Areas/<AreaName>/Views/Shared/<ViewName>.vbhtml
你可以看到,framework查询的序列中有ASPX视图引擎创建的view,即使我们指定了Razor。Framework有人会查询C#和Visual Basic.NET Razor模板。MVC Framework会依次检查这些文件是否存在,只要有一个匹配了,就会使用这个view作为action方法的结果来呈现。
如果你没有使用area,或者你使用了area但是要呈现的文件不在上述清单中,那么framework会使用下面的地址继续查询“
/Views/<ControllerName>/<ViewName>.aspx
/Views/<ControllerName>/<ViewName>.ascx
/Views/Shared/<ViewName>.aspx
/Views/Shared/<ViewName>.ascx
/Views/<ControllerName>/<ViewName>.cshtml
/Views/<ControllerName>/<ViewName>.vbhtml
/Views/Shared/<ViewName>.cshtml
/Views/Shared/<ViewName>.vbhtml
同样的,只要MVC找到一个匹配项,就停止搜寻,这个找到的view就作为对客户端的响应。
MVC Framework查找目录顺序也是一个约定的配置,你不需要注册view文件。你只需要把它们放在正确的地方,framework会找到它们的。防止view的这种约定也是可以配置的,在后续会讲到。
我们可以在更进一步,在调用view方法时,忽略掉想要呈现的view的名字。如下代码
using System.Web.Mvc;
namespace ControllersAndActions.Controllers {
public class ExampleController : Controller {
public ViewResult Index() {
return View();
}
}
}
当我我们这么做的时候,MVC Framework假设我们需要呈现的view和action方法的名字是一致的。意思就,上例中的View方法的调用会开始查询命名为Index的视图。注意,这样做的结果就是MVC Framework会寻找和action方法同名的view,但是view的名字事实上由RouteData.Values["action"]的值决定。
View 有多个重载方法,分别可以在创建的ViewResult对象属性上设置不同的值。比如,你可以显式的覆盖view的laout属性,如下:
public ViewResult Index() {
return View("Index", "_AlternateLayoutPage");
}
使用view的路径设置view
命名约定的方法非常简洁,但是限制了你能呈现的view。如果你想要呈现一个指定的view,你可以显式的输入路径。如下:
using System.Web.Mvc;
namespace ControllersAndActions.Controllers {
public class ExampleController : Controller {
public ViewResult Index() {
return View("~/Views/Other/Index.cshtml");
}
}
}
当你如上那样设定了view,路径必须以/或者~/开头,而且必须包含文件扩展名,比如cshtml。
从action方法中传值给view
我们经常会从action方法中传数据给view。 MVC Framework提供很多方法来实现这种功能。这里我们会讨论一下,在后续我们还会深入讨论。
提供View Model对象
你可以通过View方法的参数传递对象给view,如下代码:
public ViewResult Index() {
DateTime date = DateTime.Now;
return View(date);
}
我们传递了一个DateTime对象作为view model。我们可以在view中,使用Razor Model关键字,访问这个对象,如下:
@{
ViewBag.Title = "Index";
}
<h3>Index</h3>
The day is: @(((DateTime)Model).DayOfWeek)
上述例子的view是无类型的或者弱类型的。view不知道任何关于view model对象的事情,它以object的实例来处理这model。(此处译者测试下来,并不是object类型,而是dynamic类型,不知是为什么)要得到DayOfWeek属性,必须转换object类型到DateTime。这虽然可行,但是有点麻烦。我们可以通过强类型view使代码简洁点,我们告诉view,它的view model的类型是什么。如下代码:
@model DateTime
@{
ViewBag.Title = "Index";
}
<h3>Index</h3>
The day is: @Model.DayOfWeek
我们使用了Razor的model关键字指定了view model的类型,注意当我们指定model类型的时候,使用了一个小写的m,而读取值的时候用的是大写的M。这不仅是我们的的代码证件,也使得Visual Studio在强类型view中支持智能提示。如下:
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。