随笔 - 80  文章 - 2 评论 - 1197 trackbacks - 37

我的小工具
.NET正则表达式库
中国游戏开发者网络
中国游戏开发者网络 | 论坛

广告


北京狼烟网络科技有限公司
北京市朝阳区曙光西里甲6号 时间国际A座1505&msg=2007101111175778000" frameBorder=0 scrolling=no>

与我联系

搜索

 

常用链接

留言簿(8)

我参与的团队

我的标签

随笔分类

随笔档案

文章档案

相册

友情链接

积分与排名

  • 积分 - 214939
  • 排名 - 156

最新评论

阅读排行榜

评论排行榜

原文地址:http://weblogs.asp.net/stephenwalther/archive/2008/06/27/asp-net-mvc-tip-11-use-standard-controller-action-names.aspx

 

摘要:在这个Tip中,Stephen Walther建议你为控制器操作使用标准的名字,这样可以使你的代码对其他开发者更明晰。

 

采用命名约定可以使其他开发者——以及你自己将来——更容易阅读你的代码。命名约定还可以为你节省时间,可以避免费力去讨论“正确的”命名方式。在这个Tip中,我建议为ASP.NET MVC控制器操作使用标准的名字。

 

下面这个表格列出了控制器操作的标准名字:

 

操作 示例URL 说明
Details /Product/Details/5 显示一个单独的资源如一条数据库记录。例如,显示Id为5的一个单独的Product。
Index /Product/Index 显示一组资源。例如,显示数据库里产品表中的所有产品。
Create /Product/Create 显示用于创建一个新资源的表单。例如,显示一个用于创建新产品的表单。
Insert /Product/Insert 将一个新资源插入数据库。通常,在完成一次插入后你应该重定向到其它操作。
Edit /Product/Edit/5 显示用于编辑一个现有资源的表单。例如,显示一个用于编辑Id为5的产品的表单。
Update /Product/Update/5 更新数据库中的现有资源。通常,在完成一次更新后你应该重定向到其它操作。
Destroy /Product/Destroy/5 显示一个页面,确认是否真的希望从数据库中删除一个资源。
Delete /Product/Delete/5 从数据库中删除一个资源。通常,在完成一次删除后你应该重定向到其它操作。
Login /Home/Login 显示一个登录表单。
Logout /Home/Logout 注销一个用户。通常,在完成一次注销后你应该重定向到其它操作。
Authenticate /Home/Authenticate 验证一对用户名和密码。通常,在完成一次验证后你应该重定向到其它操作。


我的这些操作名字(非常粗略)是基于Adam Tybor在其MvcContrib项目的Simply Restful Route Handler中使用的命名约定的。该项目位于:

 

http://www.codeplex.com/MVCContrib/Wiki/View.aspx?title=SimplyRestfulRouting&referringTitle=Documentation

 

然而,Adam Tybor的约定和我这里建议的有着显著的不同。下面我来介绍一下二者的区别。

 

首先,Adam Tybor利用不同的HTTP谓词来指出要执行那个控制器操作(他有“REST癖”,he is being a REST purist)。例如,Adam Tybor建议同一个URL既用于删除也用于更新一个资源:

 

/Product/34

 

当使用HTTP PUT请求该URL时,将更新一条现有记录。当使用HTTP DELETE请求相同的URL时,将删除一条现有记录。Adam Tybor提出的原因是有意义的。他的建议和这些HTTP谓词的目的是统一的。然而,Adam Tybor得难以不能和默认的ASP.NET MVC路由一起工作。因此,我建议你在进行删除和更新时使用明确的URL:

 

/Product/Update/34

/Product/Delete/34

 

如果你使用这些命名约定,你将可以使用默认的ASP.NET MVC路由表。

 

我这里建议的控制器操作命名约定和我所见过的其他命名约定之间的另外一个重要区别在于,为创建一个新的资源这样一个操作所取的名字。我见过在创建新的资源时有人用过下面这样的操作名字:

 

/Product/New

/Product/Create

 

通常,New操作用于显示用于创建新资源的表单,而Create操作实际执行数据库插入操作。

 

问题在于使用New作为操作名字可能会和C#以及Visual Basic .NET关键字冲突。当在Visual Basic .NET应用程序中创建一个名为New的控制器操作时,您必须总要记得将其名字转义为[New]。持续地转义一个名字很快就会变得枯燥,而且对于那些不理解这个方括号的含义的人来说,这样会引起混淆。因此,我建议使用Create和Insert对来代替New和Create对。

 

你可能已经注意到了,我在试图让操作和(实际)执行的数据库操作中的SQL语句名字对应起来。因此,下面的URL应该是用于显示表单的:

 

/Product/Create

/Product/Edit/1

/Product/Destroy/1

 

而下面的URL应该是用于执行数据库操作的:

 

/Product/Insert

/Product/Update/1

/Product/Delete/1

 

对命名约定提出建议总是有风险的,因为开发者对于如何正确地取名总是具有强烈的个人意见。然而,我希望这篇Tip能够作为你开发一款命名约定的起点。

 

------

 

本文没有代码。广告还是.NET正则表达式库,http://regex-lib.net

Tag标签: asp.net mvc
posted on 2008-07-21 10:26 Anders Liu 阅读(1177) 评论(6)  编辑 收藏 所属分类: ASP.NET MVC

FeedBack:
这也发~~
  回复  引用    
#2楼  2008-07-24 15:21 Eeyore      
翻得好慢哦,能快点吗?...
  回复  引用  查看    
#3楼 [楼主] 2008-07-24 16:02 Anders Liu      
@Eeyore
抱歉啊,最近工作比较忙。

不过,你可以到http://www.cnblogs.com/mike108mvp/看后面的Tip,我只翻译到Tip14,后面的都由这位朋友翻译了。
  回复  引用  查看    
#4楼 [楼主] 2008-07-24 16:03 Anders Liu      
Tip12-14会很快翻译出来。
  回复  引用  查看    
#5楼  2008-07-24 22:20 Eeyore      
我就是想看你的12-14,hoho~
  回复  引用  查看    
#6楼 [楼主] 2008-07-25 07:52 Anders Liu      
@Eeyore
Tip12代码又多又碎,其实已经翻译出来了,就是没时间排版整理……
  回复  引用  查看    

标题  
姓名  
主页
Email (博主才能看到) 
验证码 *  看不清,换一张 [登录][注册]
内容(请不要发表任何与政治相关的内容)  
  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      
"五向定位"职业成长路线公开课(上海、南京、大连)
Google站内搜索


相关链接: