TodoList开发笔记 – Part Ⅱ

上一节给出了应用的两个主要UML类图，应用采用的技术也给出了，这一节开始实际设计编码

 

一.应用公开的方法

其实就几个的方法而已

1.代办事项的CRUD

2.代办事项归类目录的CRUD

3.代表事项“已完成”的更改。

二.MVC如何应用到系统中

引入MVC框架是为了更好的抽象应用程序各个模块，强制将应用程序分为三个大部分（Model-View-Controller），那么我们的应用在MVC框架下各个模块是怎么存放的呢？

Model：	TodoCatalog、TodoEvent
View:	其实我们在一个页面（视图）就可以完成所有操作，这个页面应该展示事项列表， 并将我们的页面操作提交到Controller，接受结果再显示。
Controller:	控制器应该公开许多方法，再由页面请求调用并返回结果。

要说简单吧，其实也就3个类，一个HTML文件就可以搞定这事了。

 

三.初步了解ASP.Net MVC

3.1 路由系统

　　ASP.Net MVC的路由系统相当强大，它使用一种约定成俗的命名规则来确定由哪个模块/方法提供服务,非常灵活。

其实MVC的路由系统使用IHttpHandler也可以做到类似的效果，但它做的事情不止这些，它还能帮助我们把HTTP请求的数据包装为实体对象，比如客户端使用表单提交了一个Json数据，只要Json的属性名跟我们定义的实体类对得上（不区分大小写），那么在请求处理方法的参数里我们可以直接这么写

/// <summary>
/// 保存代表事项
/// </summary>
public JsonResult SaveEvent(TodoEvent todoEvent)

注意跟IHttpHandler一样，MVC的路由处理配置也是可以配置的。

当你新建一个MVC项目时，默认的Global.asax文件（继承HttpApplication），在ApplicationStar的时候就调用了路由的配置代码RouteConfig.RegisterRoutes。

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

        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "TodoList", action = "Index", id = UrlParameter.Optional }
        );
    }
}

如上，我让Default路由指向了Url为 “域名/TodoList/Index”，那么默认访问的第一个页面就是由TodoListController的Index方法给出的。

 

3.2 视图引擎Razor

MVC采用全新的杂交水稻方式开发视图界面，基于Razor的@语法，我们可以直接在编写HTML时直接访问C#的代码，非常灵活的解决了Model与View数据传输与展示的问题。

比如我们的TodlList列出所有代办事项时可以这么写，妈妈再也不用担心我加班了！

@
{
    foreach (var catalog in catalogs)
    {
    <div class="div_catalog">
        <!--归类名称-->
        <div class="div_catalogName">@catalog.CatalogName</div>
        <!--归类下所有代办事项-->
        @foreach (TodoEvent todo in catalog.Events.Values)
        {
            <div class="div_todoevent">
                @todo.Summary
            </div>
        }
    </div>
    }
}

其实简单说Razor就是把原先蹩脚的<% %> 用 @ 取代了，关于它的细节可以参考

Razor 语法

3.3 数据验证

有了Razor跟路由系统足够我们很快写出这个应用的后台了，为了方便编码，MVC还提供了其他的一些特性，比如数据验证。

在表单数据提交的时候，不管桌面软件还是Web应用，默认客户端都是不可信的，对于客户端提交的数据都会进行严格的验证。

然而数据验证的代码其实大部分千篇一律，为了消除这些重复劳动，MVC提供了几个Attribute给我们实体的属性作为验证，比如限制一个属性必须填写、一个属性必须在某个范围内，可以使用如下Attribute

[Required]     //必填字段
public string ProductName{ get; set;}

[Range(0,1000)]    //整型
或者
[Range(typeof(decimal),"0.00","49.99")]    //decimal类型
public decimal Price{ get; set;}

详细的Attribute可以参考

MVC 数据验证

四.项目结构

了解了基本的MVC知识后我做出了如下的项目结构，非常简单

服务端主要就是一个Controller包含所有操作方法，一个Index的视图作为主界面，DataBase、DataContext和Entity是属于数据访问层的，因为项目比较小就没分出来了。

其实服务端工作量挺少的，就不贴代码了，下一节直接编写客户端。