ASP.NET MVC 音乐商店 2.控制器 - W3CAPI 在线教程

在典型的 Web 应用中，用户请求的 URL 地址通常映射到保存在网站中的文件上，例如，当用户请求 /Products.aspx 的时候，或者 /Products.php 的时候，很可能是在通过处理 Products.aspx 或者 Products.php 文件来完成任务。

ASP.NET MVC 的处理方式则不同，它没有映射到文件上，相反，将这些 URL 地址映射到类的方法上，这些类被称为“控制器”，控制器用来接受 HTTP 请求，处理用户的输入，获取或者保存数据，其中的处理方法称为 Action，然后将回应发送到客户端，可能是显示了一个 HTML 的网页，下载一个文件，重定向到另外一个地址等等。

默认的路由配置

在新创建的项目中，打开 Global.asax.cs 文件，可以看到如下的代码。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Web.Routing;

namespace MvcMusicStore
{
    // 注意: 有关启用 IIS6 或 IIS7 经典模式的说明，
    // 请访问 http://go.microsoft.com/?LinkId=9394801

    public class MvcApplication : System.Web.HttpApplication
    {
        public static void RegisterGlobalFilters(GlobalFilterCollection filters)
        {
            filters.Add(new HandleErrorAttribute());
        }

        public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            routes.MapRoute(
 "Default", // 路由名称
 "{controller}/{action}/{id}", // 带有参数的 URL
 new { controller = "Home", action = "Index", id = UrlParameter.Optional } // 参数默认值
 );

        }

        // 一般用来进行网站的初始化
        protected void Application_Start()
        {
            System.Data.Entity.Database.SetInitializer(new MvcMusicStore.Models.SampleData());

            AreaRegistration.RegisterAllAreas();

            RegisterGlobalFilters(GlobalFilters.Filters);
            RegisterRoutes(RouteTable.Routes);
        }
    }
}

其中 RegisterRoutes 方法注册了默认的路由配置，在方法中的 routes.MapRoute 语句中，请求地址将会被看成三个部分组成，{controller}/{action}/{id}，第一部分称为控制器，如果没有提供的话，默认为 Home, 第二部分称为 Action 方法，如果没有提供的话，默认为 Index, 第三部分称为 id, 通常用来提供数据的标识，没有默认值。这样，当请求 / 地址的时候，系统将会把请求映射到名为 Home 的控制器进行处理，调用其中名为 Index 的方法处理请求。

增加 HomeController

我们的应用商店从增加一个首页的控制器开始，使用默认的命名约定，控制器的名称应该以 Controller 作为后缀，我们将这个控制器命名为 HomeController。

在 Controller 文件夹上右击，然后选择“添加”，“控制器(T)…”

在弹出的对话框中，输入控制器的名字 HomeController，按下“添加”按钮。

这样，将会创建一个名为 HomeController.cs 的文件，其中的代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;

namespace MvcMusinStore.Controllers
{
    public class HomeController : Controller
    {
        //
        // GET: /Home/

        public ActionResult Index()
        {
            return View();
        }

    }
}

为了尽可能地简单，我们让 Index 方法简单地返回一个字符串，这个字符串将作为回应内容直接返回浏览器，我们做下面的两个简单修改。

将方法的返回类型修改为string
将返回语句修改为 return "Hello form Home";

这样，我们的方法将会变成如下的内容

public string Index()
{
    return "Hello form Home";
}

运行程序

现在，可以运行一下了，我们可以启动服务器，使用下面的任何一种方法都可以。

选择“调试”，“启动调试”菜单
点击工具栏上的绿色的箭头按钮
使用键盘快捷方式，F5

使用上面的任何一种方法都会导致编译项目，启动 Visual Studio 中内建的 ASP.NET 开发服务器.

在屏幕的右下角会弹出一个启动 ASP.NET 开发服务器的提示，

Visual Studio 将自动打开一个浏览器窗口，其中的地址指向我们的 Web 服务器，这使得我们可以快速使用我们的程序。

Ok, 非常的简单，我们已经创建了一个 Web 站点，写了一个三行的函数，在浏览器中得到了这行文字，不是很震撼，但这仅仅只是开始。

增加 StoreController

我们已经为站点增加一个简单的 HomeController 作为首页，现在，增加另外一个控制器，可以用来浏览我们的音乐商店，我们的商店控制器将要支持三个场景：

列出商店中的唱片的分类
浏览商店中某个分类中的唱片列表
显示特定唱片的详细信息

我们从增加一个新的 StoreController 开始，先停止刚才的程序，可以直接关闭浏览器，或者也可以在调试菜单中，选择停止调试。

现在，增加一个新的 StoreController，像在 HomeController 中做的一样，我们在 Controllers 文件夹上右健，选择“添加”，“控制器”.

新的 StoreController 控制器中已经包含了 Index 方法，我们使用这个方法来实现列出所有分类的列表，我们还会再增加两个额外的方法来实现其他的场景：浏览和明细。

这些包含在控制器中的方法，我们称为控制器中的 Action，像你在前面看到的，HomeController 中的 Index 方法就是一个 Action，这些 Action 的作用就是处理请求，然后返回对请求的处理结果。

对于我们的 StoreController ，首先让 Index 这个 Action 返回一个“Hello” 串，然后，增加两个方法：Browse() 和 Detials()

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;

namespace MvcMusinStore.Controllers
{
    public class StoreController : Controller
    {
        //
        // GET: /Store/

        public string Index()
        {
            return "Hello from Store.Index()";
        }

        public string Browse()
        {
            return "Hello from Store.Browse()";
        }

        public string Details()
        {
            return "Hello from Store.Details()";
        }

    }
}

重新运行程序，现在已经可以访问这些地址了。

/Store
/Store/Browse
/Store/Details

太棒了，但是现在仅仅能够返回一些常量的字符串，让我们将它们变成动态的，我们从 URL 中获取一些信息，然后把他们显示在返回的页面中。

首先，修改我们的 Browse 这个 Action，使得它可以从 URL 地址中获取查询信息，为方法增加一个名为“genre” 的字符串类型参数，当我们这样做的时候，ASP.NET MVC 就会自动把任何名为 genre 的请求参数的值赋予这个参数。

//
// GET: /Store/Browse?genre=?Disco
public string Browse(string genre)
{
    string message = HttpUtility.HtmlEncode("Store.Browse, Genre = " + genre);
    return message;
}

注意：

我们使用了HttpUtility.HtmlEncode 方法来处理用户的输入，这样可以防止用户的脚本注入攻击。例如：/Store/Browse?Genre=<script>window.location=’http://hackersite.com’</script>.

现在，我们在浏览器中访问一下：/Store/Browse?Genre=Disco

下一步，我们处理 Details 这个 Action，使它能够处理名为 ID 的整数类型参数。这次，我们不再在请求参数中传递这个整数，而是嵌在请求的 URL 地址中。例如：/Store/Details/5。

在 ASP.NET MVC 中，我们可以轻易地完成这个任务而不需要配置任何东西，ASP.NET MVC 默认的路由约定会将跟在 Action 方法之后的部分看作名为 ID 的参数的值，如果你的 Action 方法有一个名为 ID 的参数，那么，ASP.NeT MVC 就会自动将这部分作为参数传送给 Action 方法，需要注意的是，MVC 可以帮助你完成数据类型之间的转换，所以，地址的第三部分一定要可以转换为整数。

//
// GET: /Store/Details/5
public string Details(int id)
{
    string message = "Store.Details, ID = " + id;
    return message;
}

再次运行程序访问/Store/Details/5

总结一下我们完成的任务：

创建了一个 ASP.NET MVC 项目
讨论了基本的项目文件夹
学习了如何运行开发服务器
创建了两个控制器 HomeController 和 StoreController
为控制器增加了 Action 方法。