[ASP.NET MVC Mavericks Road] 09 - 컨트롤러와 액션(1)

[ASP.NET
MVC Mavericks Road] 09 - 컨트롤러 및 액션(1)

MVC에서는 각 요청이 처리를 위해 컨트롤러에 제출된다는 것을 알고 있습니다. 컨트롤러는 요청과 밀접하게 관련되어 있으며, 모델을 작동하고 사용자에게 표시할 뷰를 선택할 수 있습니다. 비즈니스 및 데이터, 인터페이스 및 보조 클래스 라이브러리에 대한 논리 코드는 일반적으로 배치되지 않습니다. 컨트롤러.

컨트롤러와 액션은 내용이 많아서 2개의 글로 나누었고, 3개의 글로 나눌 수도 있습니다. 이 기사에서는 컨트롤러의 구현, 컨트롤러의 상태 데이터 획득, ActionResult 및 Action의 데이터 전송에 대해 소개합니다. 나중에 컨트롤러 팩토리, 액션 호출자 및 아직 생각하지 못한 고급 기능을 소개합니다. 학습되고 있습니다.

이 기사의 내용

IController 인터페이스 상속

이 시리즈의 이전 기사에서 우리가 추가한 Controller는 다음에서 상속되었습니다. System.Web.Mvc.Controller 클래스의 추상 Common 클래스(참고: 컨트롤러(또는 Controller) 및 Controller 클래스는 이 문서에서 두 가지 다른 의미를 갖습니다. 이 문서를 읽을 때 맥락에 따라 이해하십시오). Controller 추상 클래스는 매우 실용적인 많은 기능을 캡슐화하므로 개발자는 반복적이고 번거로운 처리 코드를 직접 작성할 필요가 없습니다.

캡슐화된 Controller 추상 클래스를 사용하지 않는 경우 IController 인터페이스를 구현하여 자체 컨트롤러를 만들 수도 있습니다. IController 인터페이스에는 Exctute 메서드가 하나만 있습니다.

public interface IController { 
    void Execute(RequestContext requestContext); 
}

Controller 인터페이스는 System.Web.Mvc 네임스페이스에 속하며 매우 간단한 구조를 가진 인터페이스입니다.

IController 인터페이스를 구현하는 컨트롤러 클래스에 요청이 전송되면(라우팅 시스템은 요청된 URL을 통해 컨트롤러를 찾을 수 있음) Execute 메서드가 호출됩니다.

다음으로 빈 MVC 애플리케이션을 만들고 Controllers 폴더 아래에 IController를 구현하는 클래스를 추가한 후 다음과 같이 몇 가지 간단한 작업을 수행합니다.

using System.Web.Mvc;
using System.Web.Routing;

namespace MvcApplication1.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));
        }
    }
}

애플리케이션을 실행합니다. URL은 다음과 같습니다. /Basic/Index에 위치(Index를 다른 조각 이름으로 변경할 수 있음) 결과는 다음과 같습니다.

는 IController 클래스를 구현하고 MVC는 이를 인식합니다. 컨트롤러 클래스이며 해당 요청은 컨트롤러 이름에 따라 처리하기 위해 이 클래스로 전달됩니다.

그러나 약간 복잡한 애플리케이션의 경우 IController 인터페이스를 직접 구현하려면 많은 작업이 필요하며 우리는 거의 구현하지 않습니다. 이를 통해 컨트롤러의 동작을 더 잘 이해할 수 있습니다. 컨트롤러의 모든 요청 처리는 Execute 메서드에서 시작됩니다.

Controller 추상 클래스 상속

MVC를 사용하면 이를 자유롭게 사용자 정의하고 확장할 수 있습니다. 예를 들어 위에서 언급한 대로 IController 인터페이스를 구현하여 다양한 요청을 처리하고 결과를 생성합니다. Action 메소드가 마음에 들지 않거나 View에 관심이 없다면 요청을 처리하기 위해 더 좋고, 빠르고, 우아한 컨트롤러를 직접 작성할 수 있습니다. 그러나 앞서 언급했듯이 IController 인터페이스를 직접 구현하려면 많은 작업이 필요합니다. 가장 중요한 것은 장기간의 실제 테스트 없이는 코드의 견고성을 보장할 수 없다는 것입니다. MVC 프레임워크의 System.Web.Mvc.Controller 클래스는 요청 처리 및 결과 반환을 용이하게 하는 데 충분한 실용적인 기능을 제공합니다.

우리는 Controller 클래스를 상속받은 컨트롤러를 여러 번 사용해 왔으며 그에 대해 어느 정도 이해하고 있습니다.

액션 메서드: 동작이 구분되는 컨트롤러입니다. 일반적으로 하나의 메소드가 하나의 요청에 해당하며, 요청에 의해 전달된 데이터는 메소드 매개변수를 통해 얻을 수 있습니다.
ActionResult: Action 메소드의 실행 결과를 기술하는 객체를 반환할 수 있는데, 결과를 반환하고 싶다면 해당 반환 객체만 지정하면 되니 걱정하지 않아도 된다는 장점이 있습니다. 이를 실행하고 결과를 생성하는 방법에 대해 설명합니다.
필터: C# 기능을 통해 특정 동작(예: 승인 및 확인) 처리가 캡슐화되어 여러 컨트롤러 및 작업 메서드 간의 재사용이 용이해집니다.

따라서 특별한 요구 사항이 없거나 너무 바쁜 경우 요구 사항을 충족하는 Controller를 만드는 가장 좋은 방법은 Controller 추상 클래스를 상속하는 것입니다. 이전에 여러 번 사용했기 때문에 여기에서는 자세한 데모를 제공하지 않지만 코드 구조를 살펴보겠습니다.

Controllers 폴더 아래에 Controller를 추가합니다. VS는 이미 클래스 구조를 생성했습니다. 깔끔함을 좋아한다면 코드는 다음과 같습니다.

using System.Web.Mvc;

namespace MvcApplication1.Controllers {
    
    public class DerivedController : Controller {
        
        public ActionResult Index() {
            ViewBag.Message = "Hello from the DerivedController Index method";
            return View("MyView");
        }
    }
}

我们可以查看 Controller 抽象类的定义，发现它是继承 ControllerBase 类的，在 ControllerBase 类中实现了 IController 接口的 Execute 方法，这个方法是MVC对请求进行处理的各个组件的入口，其中包括通过路由系统找到 Action 方法并调用。

Controller 类内部使用 Razor 视图系统来呈现 View，这里通过 View 方法，指定 View 的名称参数来告诉 MVC 选择 MyView 视图来返回给用户结果。

在 Controller 中获取状态数据

我们经常需要访问客户端提交过来的数据，比如 QueryString 值、表单值和通过路由系统来自 URL 的参数值，这些值都可称为状态数据。下面是 Controller 中获取状态数据的三个主要来源：

一系列的上下文对象。
传递给 Action 方法的参数。
显式的调用框架的模型绑定(Model Binding)特性。

从上下文对象中获取状态数据

获取状态数据最直接的方法就是从上下文对象中提取。当你创建了一个继承自 Controller 类的 Controller 时，可以通过一系列的属性可以方便的访问到和请求相关的数据，这些属性包括 Request、Response、RouteData、HttpContext 和 Server，每一个都提供了请求相关的不同类型的信息。下面列出了最常的上下文对象：

在 Action 方法中可以使用任意上下文对象来获取请求相关的信息，如下面在 Action 方法中所演示的：

...
public ActionResult RenameProduct() {
    //访问不同的上下文对象
    string userName = User.Identity.Name;
    string serverName = Server.MachineName;
    string clientIP = Request.UserHostAddress;
    DateTime dateStamp = HttpContext.Timestamp;
    AuditRequest(userName, serverName, clientIP, dateStamp, "Renaming product");
            
    //从POST请求提交的表单中获取数据
    string oldProductName = Request.Form["OldName"];
    string newProductName = Request.Form["NewName"];
    bool result = AttemptProductRename(oldProductName, newProductName);

    ViewData["RenameResult"] = result;
    return View("ProductRenamed");
}
...

这些上下对象不用特意去记，用的时候，你可以通过VS的智能提示来了解这些上下文对象。

使用 Action 方法参数获取状态数据

在本系列的前面的文章中，我们已经知识如何通过 Action 参数来接收数据，这种方法和上面的从上下文对象中获取相比，它更为简洁明了。比如，我们有下面这样一个使用上下文对象的 Action 方法：

public ActionResult ShowWeatherForecast() {
    string city = (string)RouteData.Values["city"];
    DateTime forDate = DateTime.Parse(Request.Form["forDate"]);
    // do something ... 
    return View();
}

我们可以像下面这样使用 Action 方法参数来重写它：

public ActionResult ShowWeatherForecast(string city, DateTime forDate) { 
    // do something ... 
    return View(); 
}

它不仅易读性强，也方便进行单元测试。

Action 方法的参数不允许使用 ref 和 out 参数，这是没有意义的。

MVC 框架通过检查上下文对象来为 Action 方法的参数提供值，它的名称是不区分大小写的，比如 Action 方法的 city 参数的值可以是通过 Request.Form["City"] 来获取的。

理解 Action 方法的参数是如何被赋值的

Controller 类通过 MVC 框架的 value provider 和 model binder 组件来为 Action 方法获取参数的值。

value provider 提供了一系列Controller中可以访问到的值，在内部它通过从 Request.Form、Request.QueryString、Request.Files 和 RouteData.Values 等上下文对象中提取数据(键值集合)，然后把数据传递给 model binder，model binder 试图将这些数据与Action方法的参数进行匹配。默认的 model binder 可以创建和赋值给任何.NET类型对象参数（即 Action 方法的参数），包括集合和自定义的类型。

在这不对 model binder 进行介绍，我将在本系列的后续博文中对其进行专门的介绍。

理解 ActionResult

ActionResult 是描述 Action 方法执行结果的对象，它的好处是想返回什么结果就指定对应的返回对象就行，不用关心如何使用Response对象来组织和生成结果。ActionResult 是一个命令模式的例子，这种模式通过存储和传递对象来描述操作。

当 MVC 框架从 Action 方法中接收到一个 ActionResult 对象，它调用这个对象的 ExecuteResult 方法，其内部是通过 Response 对象来返回我们想要的输出结果。

为了更好的理解，我们通过继承 ActionResult 类来自定义一个 ActionResult。在MVC工程中添加一个Infrastructure文件夹，在里面创建一个名为 CustomRedirectResult 的类文件，代码如下：

using System.Web.Mvc;

namespace MvcApplication1.Infrastructure {
    
    public class CustomRedirectResult : ActionResult {
        
        public string Url { get; set; }

        public override void ExecuteResult(ControllerContext context) {
            string fullUrl = UrlHelper.GenerateContentUrl(Url, context.HttpContext);
            context.HttpContext.Response.Redirect(fullUrl);
        }
    }
}

当我们创建一个 CustomRedirectResult 类的实例时，我们可以传递想要跳转的 URL。当 Action 方法执行结束时，MVC 框架调用 ExecuteResult 方法，ExecuteResult 方法通过 ControllerContext 对象获得 Response 对象，然后调用 Redirect 方法。

下面我们在 Controller 中使用自定义的 CustomRedirectResult：

public class DerivedController : Controller {
    ...
    public ActionResult ProduceOutput() {
        if (Server.MachineName == "WL-PC") {
            return new CustomRedirectResult { Url = "/Basic/Index" };
        }
        else {
            Response.Write("Controller: Derived, Action: ProduceOutput");
            return null;
        }
    }

运行后我们看到如下结果：

当运行在本机(WL-PC)时直接重定向到了指定的/Basic/Index。

上面我们通过自定义 CustomRedirectResult 来实现重定向，我们可以用 MVC 框架提供的方法，如下：

... 
public ActionResult ProduceOutput() { 
    return new RedirectResult("/Basic/Index"); 
}

为了使用方便，Controller 类中为大部分类型的 ActionResult 提供简便的方法，如上面的可像下面这样简写：

... 
public ActionResult ProduceOutput() { 
    return Redirect("/Basic/Index"); 
}

MVC框架包含了许多 ActionResult 类型，这些类型都继承自 ActionResult 类，大部分在 Controller 类中都有简便的方法，下面列举了一些：

除了该表列出来的，还有ContentResult、FileResult、JsonResult 和 JavaScriptResult。具体每种ActionResult类型的用法这里就不讲了，大家可以看看蒋老师的了解ASP.NET
MVC几种ActionResult的本质系列的文章。

几种从 Action 传递数据到 View 的方式

我们经常需要在 Action 方法中传递数据到一个 View 中，MVC 框架为此提供了一些很方便的操作。下面简单简介几种常用的方式。

View Model 对象

通过 View Model 对象传递数据给View，这是最常用的一种，在 Acton 方法执行结束时通过 View 方法传递 View Model 对象给 View，如下代码所示：

... 
public ViewResult Index() { 
    DateTime date = DateTime.Now; 
    return View(date); 
}

在 View 中我们通过 Model 属性来使用传递过来的 View Model 对象，如下：

@model DateTime 

@{ 
    ViewBag.Title = "Index"; 
}

<h2>Index</h2> 
The day is: @Model.DayOfWeek

在 Razor 视图引擎中，@model 的作用是声明 odel 属性的类型，省去了类型转换的麻烦，而 @Model 是V iew Model 对象的引用。

ViewBag、ViewData 和 TempData 属性

ViewBag、ViewData 和 TempData 都是 Controller 和 View 中能访问到的属性，都是用来存储小量的数据，他们的区别如下：

ViewBag，是一个动态(dynamic)的弱类型，在程序运行的时候解析，是 MVC3 中新增的特性，只在当前View有效。
ViewData，是一个字典集合，也是只在当前View有效，性能比 ViewBag 高，但是使用的时候需要类型转换。
TempData，也是字典集合，一般用于两个请求之间临时缓存内容或页面间传递消息，保存在 Session 中，使用完以后则从 Session 中被清除。

下面是三者使用的例子，先在 Controller 中分别用三者存储小数据：

public class DerivedController : Controller {

    public ActionResult Index() {
        ViewBag.DayOfWeek = DateTime.Now.DayOfWeek;
        ViewData["DayOfMonth"] = DateTime.Now.Day;
        return View();
    }

    public ActionResult ProduceOutput() {
        TempData["Message"] = "Warning message from Derived Controller.";
        return Redirect("/Home/Index");
    }
}

在 Views/Derived 目录下的 Index.cshtml 中，取出 ViewBag 和 ViewData 中的存储的数据：

...
Day of week from ViewBag: @ViewBag.DayOfWeek
<p /> 
Day of month from ViewData: @ViewData["DayOfMonth"]

在 Views/Home 目录下的 Index.cshtml 中，取 TempData 中的数据如下：

...
@TempData["Message"]

当请求 /Derived/ProduceOutput 时，ProduceOutput 方法将一条消息存到 TempData 中，并跳转到 /Home/Index。

下面是分别是将URL定位到 /Derived/Index 和 /Derived/ProduceOutput 时的结果：

一般在当前 View 中使用 ViewBag 或 ViewData，在两个请求之间传递临时数据用 TempData。由于 TempData 被使用后即被释放，所以如果要二次使用 TempData 中的数据就需要将其存到其他变量中。

 以上就是[ASP.NET MVC 小牛之路]09 - Controller 和 Action (1)的内容，更多相关内容请关注PHP中文网（m.sbmmt.com）！