转载自思胜.net培训高级讲师郝冠军博客
在典型的 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( , , { controller = , action = , 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 方法。