2010年12月3日
使用WCF 4.0 构建 REST Service

使用WCF 4.0 构建 REST Service 


用过一段时间的Ruby on Rails，感觉它内置的RESTful结构非常的完美，也对.NET WCF 3实现REST颇有微议，今天在.NET 4.0下试了新的WCF 4，发现其重写了对REST的支持，使用了类似MVC Routing来配置URL导向，非常迷人。

下面来看下如何一步一步来创建新的REST结构的WCF项目。

 

创建项目

 1 打开VS 2010，选择新建项目，我们选择已有的模板来方便创建新的项目，在左侧Online Templates中选择WCF REST Service Template 40(CS)。

clip_image002

接下来去安装这个模板到本地，第一次安装时需要同意该使用协议，点击“安装”：

clip_image003

这样我们就很简单的用这个模板生成了一个新的项目。


改变之处

该模板使用了一种新的结构来创建简单的REST Service，在细读代码前，先看下项目的文件结构：

clip_image005

相对于之前的版本

l 项目中不再有SVC文件，这样就不能每次都通过xx.svc/users/1 来访问，而是通过URL Routing来配置。

l 也不再有接口文件作契约。

 

Global.asax配置

可以看到在.NET 4中构建REST服务相当容易。项目通过在Global.asax中来配置类似于ASP.NET 中的Routing进行URL重定向。见如下代码。

 1 public class Global : HttpApplication
 2 {
 3     void Application_Start(object sender, EventArgs e)
 4     {
 5         RegisterRoutes();
 6     }
 7 
 8     private void RegisterRoutes()
 9     {
10         // Edit the base address of Service1 by replacing the "Service1" string below
11         RouteTable.Routes.Add(new ServiceRoute("Service1", new WebServiceHostFactory(), typeof(Service1)));
12     }
13 }

 

通过代码我们可以看到，通过ServiceRoute类来进行URL重定向的，这里我们配置了一个名为Service1的Resource，指定到Service1类上。 


Web.config

同时，在web.config中包含着部署所需要的一些配置。下面的代码是默认生成的。

 

 1 <?xml version="1.0"?>
 2 <configuration>
 3   <system.web>
 4     <compilation debug="true" targetFramework="4.0" />
 5   </system.web>
 6 
 7   <system.webServer>
 8     <modules runAllManagedModulesForAllRequests="true">
 9       <add name="UrlRoutingModule" type="System.Web.Routing.UrlRoutingModule, System.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
10     </modules>
11   </system.webServer>
12 
13   <system.serviceModel>
14     <serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
15     <standardEndpoints>
16       <webHttpEndpoint>
17         <!-- 
18             Configure the WCF REST service base address via the global.asax.cs file and the default endpoint 
19             via the attributes on the <standardEndpoint> element below
20         -->
21         <standardEndpoint name="" helpEnabled="true" automaticFormatSelectionEnabled="true"/>
22       </webHttpEndpoint>
23     </standardEndpoints>
24   </system.serviceModel>
25 </configuration>

 

Resource代码

默认生成的Resource：Service1代码，可以看到这是一个完整RESTful的结构，有着Get, Put, Post, Delete的完整支持。


 1 [ServiceContract]
 2 [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]
 3 [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)]
 4 public class Service1
 5 {
 6     // GET /Service1/
 7     [WebGet(UriTemplate = "")]
 8     public List<SampleItem> GetCollection()
 9     {
10         return new List<SampleItem>() { new SampleItem() { Id = 1, StringValue = "Hello" } };
11     }
12 
13     //  POST /Service1/
14     [WebInvoke(UriTemplate = "", Method = "POST")]
15     public SampleItem Create(SampleItem instance)
16     {
17         throw new NotImplementedException();
18     }
19 
20     // GET /Service1/100
21     [WebGet(UriTemplate = "{id}")]
22     public string Get(string id)
23     {
24         return "welcome";
25     }
26 
27     // PUT /Service1/100
28     [WebInvoke(UriTemplate = "{id}", Method = "PUT")]
29     public SampleItem Update(string id, SampleItem instance)
30     {
31         throw new NotImplementedException();
32     }
33 
34     // DELETE /Service1/100
35     [WebInvoke(UriTemplate = "{id}", Method = "DELETE")]
36     public void Delete(string id)
37     {
38         // TODO: Remove the instance of SampleItem with the given id from the collection
39         throw new NotImplementedException();
40     }
41 }

 

运行测试

为了测试，将Get(string id)进行修改。可以直接运行项目（F5）。

在地址栏中加上Service1，可以看到打开一个空白页面，此时内容已经生成，只是XML数默认不直接显示在页面上。

clip_image007

通过查看其Source,可以看到返回的数据集。

clip_image008

 

此时参数为空，也就是会调用下面一个返回集合的方法：

1 [WebGet(UriTemplate = "")] 
2 public List<SampleItem> GetCollection()

 

同时，也可以发起带参数的GET请求，如/Service1/1/，则会调用相对应的参数函数：

1 [WebGet(UriTemplate = "{id}")] 
2 public string Get(string id)

 

Help 页面

模板同时也为我们生成了一个帮助页面，帮助我们快速了解该Resource所对应的URI祥情。

clip_image010

 

clip_image012

 

布署到IIS 7

该项目的布署和普通ASP.NET项目相同，这里写下方法。

将项目发布到本地磁盘：

clip_image013

 

在IIS中新建一个Site，在右侧Action下有一个Add Web Site。也可以在Default Web Site下新建一个Application，方式相同：

clip_image015

 

这一步一定要选Application pool为 ASP.NET v4.0，端口任意指定，这里使用8080

clip_image016

 

再强调一次，一定要选ASP.NET v4.0

clip_image017

 

在浏览器中打开可以看到结果。

clip_image019

posted @ 2010-12-03 16:56 Zhiming Jiang 阅读(3763) 评论(16) 编辑
2010年5月1日
Mock Framework 实战

今晚的世博开幕式很棒，欢迎大家到上海来看Expo！

上一篇中和大家分享了单元测试的理论、入门和一些实践（更多的实践会逐步更新进来），这篇中来介绍下更多的应用场景和使用Mock对象来进行快速的生成模拟对象来简化测试并解决一些问题。

场景分析：
   

我们假设一个应用场景，也是发生在项目中真实的案例。
  
  • 真实对象不存在或不完备：新产品开发时，Platform Team只定义了接口，并未完全实现该接口中的方法。但Feature Team仍要进行自己的开发，并需要底层数据支持，等Platform开发完成再去编写自己的代码显然是不可能的，如何去处理这种依赖？
  • 真实对象本身不确定：底层接品在设计之初也是不稳定的，通常在产品一个方法的返回值会跟据需求经常变动（这种情况在好的设计中出现的概率较小），如何在这种情况下保证上层代码的安全。
  • 数据源不稳定：有些依赖数据会经常变化，或者根本拿不到，但方法本身仅是对数据的加工，不涉及取数据。
  • 代码依赖：当要去初始化一个对象时，要初始化另外的依赖对象，还要解决依赖对象的依赖对象…，还不算完，一旦这个测试挂掉，恭喜，你又一次陷入穷尽的 Debug中，因为无从只到是哪一步出错。

解决方案

    

上一篇示例中已经提到这个问题，并通过一个简单的类来代替当前这个真实而复杂的类，返回我们期望的数据。这样做的好处，一个测试出错，总能立即找到它对应的方法，不用对外部类的行为负责任，因为单元测试是以方法为单位的，每一个类的方法都应被测试并保证返回结果的正确性，所以不必担心这样会产生测试不完整的问题。

  • 为该对象创建一个接口（如果已有，跳过前两步）
  • 让真实对象实现该接口
  • 在测试中，创建一个Mock的对象实现这个接口
  • 对要测试的方 法进行指定返回值
  • 用Mock对象代替真实对象完成方法执行

1 public interface IUserService
2 {
3     User GetUser(string id);
4 
5     IList<User> GetUsers();
6 }


实现类UserService 调用了IUserRepository接口中的GetUser方法，但不对任何具体的实现类产生依赖。这就是一直鼓励的面向接口编程

 1 public class UserService : IUserService
 2 {
 3     private IUserRepository userRepository { get; set; }
 4 
 5     public UserService(IUserRepository userRepository)
 6     {
 7         this.userRepository = userRepository;
 8     }
 9 
10     #region IUserService Members
11 
12     public User GetUser(string id)
13     {
14         return this.userRepository.GetUser(id);
15     }
16 
17     public IList<User> GetUsers()
18     {
19         return this.userRepository.GetUsers();
20     }
21 
22     #endregion
23 }


下面是IUserRepository接口的代码

1 public interface IUserRepository
2 {
3     List<User> GetUsers();
4     User GetUser(string Id);
5 
6     void Save(User user);
7 }

 

紧接着的是我们对IUserRepository接口所创建的Mock类，可以看一下我们很简单的处理了下GetUser方法，让TA返回一个指定值User对象。

 

 1 public class MockUserRepository : IUserRepository
 2 {
 3     public List<Core.Models.User> GetUsers()
 4     {
 5         throw new NotImplementedException();
 6     }
 7 
 8     public Core.Models.User GetUser(string Id)
 9     {
10         return new User() { Id = "3277", Name = "Lanvige" };
11     }
12 
13     public void Save(Core.Models.User user)
14     {
15         throw new NotImplementedException();
16     }
17 }


下面的代码是真正的测试用例代码

 1 [TestClass]
 2 public class UserServiceTest
 3 {
 4     private IUserRepository userRepository;
 5     private UserService userService;
 6 
 7     public UserServiceTest()
 8     {
 9         userRepository = new MockUserRepository();
10         userService = new UserService(userRepository);
11     }
12 
13     [TestMethod]
14     public void Get_User_By_Id_Test()
15     {
16         User user = this.userService.GetUser("3277");
17 
18         Assert.AreEqual("3277", user.Id);
19         Assert.AreEqual("Lanvige", user.Name);
20     }
21 }


这样，我们就解决了在单元测试中的一些难题，而Mock的理念也得到充分展示，模拟真实对象的方法，返回所需的值，让测试变得更简单。

但上面的解决方案的实现还是很复杂的，接口我们需要自已动手写另一个实现类，实现接口中所有的方法，虽然有些我们并不需要。如果我们需要更多的验证时，就要去写更多的代码来实现，如判断代码是否被调用和调用次数，传入参数的正确性和忽略实参……

有没有更简单的方法
    

有没有一种通用的方法对生成这些类，减少单元测试中的代码量和复杂度，有，那就是Mock Framework。

Mock Framework主要是用来模拟那些在应用中不容易构造或者比较复杂的对象从而使测试顺利进行的工具。够根据现有的接口或类动态生成Mock对象，不仅能避免额外的编码工作，同时也降低了引入错误的可能。

  • 可以用简单易行的方法定义模拟对象，无需破坏本来的代码结构表；
  • 可以定义对象之间的交互，从而增强测试的稳定性；
  • 可以集成到测试框架；
  • 易扩充； 

比较著名的Mock框架有Rhino Mocks, Moq等，其中Rhino的功能较为强大，而Moq新秀则使用Lambda表达式使得语义更加清晰而日渐受到欢迎。我们今天使用Moq来做一下简单的Mock的使用，当然，这里介绍的还是思想，这里的方法你用其它的Mock框架也是能使用的，只是方法名，变量可能会因不同框架而不同。

使用Moq
    

对上面代面的另一种写法。

 1 [TestClass]
 2 public class UserServiceTestWithMoq
 3 {
 4     private IUserRepository userRepository;
 5     private UserService userService;
 6 
 7     [TestMethod]
 8     public void Get_User_By_Id_Test()
 9     {
10         var mockUserRepository = new Mock<IUserRepository>();
11         mockUserRepository.Setup(x => x.GetUser(It.IsAny<string>()))
12             .Returns(new User() { Id = "3277", Name = "Lanvige" });
13         mockUserRepository.Verify(x => x.GetUser(It.IsAny<string>()), Times.AtLeastOnce());
14 
15         userRepository = mockUserRepository.Object;
16         userService = new UserService(userRepository);
17 
18         User user = this.userService.GetUser("3");
19 
20         Assert.AreEqual("3277", user.Id);
21         Assert.AreEqual("Lanvige", user.Name);
22     }
23 }


通过代码我们可以看到，在之前手工去Mock时的一个对象，在这里只用两句话就建立起相同的内容，Mock一个对象，并对其中的GetUser方法进行指定返回值，大大的提高了我们的工作效率。

并且我们使用了mockUserRepository.Verify来验证该代码是否被执行，比手工Mock对象代码量少并进行了更多的验证。

代码中哪些需要被Mock，以及Mock的更多作用
  

  • 方法：在上面的代码中我们已经Mock了一个对象并反回指定的对象。值得注意的是It.IsAny<string>()这句话，它的意思是不去匹配所传参数，当然也有具体匹配，范围匹配。
  • 属性：方法中的属性仅用于约束属性的作用范围，不具有真实的存值空间，所以Mock对象无法直接为属性赋值，要通过Mock来实现。
  • 事件：为对象中的事件进行绑定新的行为或删除已有行为。
  • 回调：在方法结束后去调用一个指定方法。
  • 验证：这里的验证和我们在Test Framework中的Assert不大一样，它验证的是Mock对象在执行过程中的一些行为和属性，例如方法是否被调用，调用次数、属性取值是否为期望值，Set方法是否将值赋给对象的属性。

不要过多依赖
   

体验完Mock之后，是不是觉得很Cool，有一种想把一切都Mock起来的冲动。很诱人，但也并非完全适用，

开发者对API的了解不够、被模拟对象的行为发生变化（重构、添加新功能等修改等都可能引起被被模拟对象的行为变化）都可能导致错误假设（与真实对象行为 不一致），错误假设会悄无声息的引入缺陷并留下非法测试。

 

下一篇中，我们会对Moq进行更多的深入，你会学到如何使用Moq进行Mock属性，方法，事件，回调及验证。

 

Zhiming
MSN GMD Shanghai

posted @ 2010-05-01 00:58 Zhiming Jiang 阅读(1677) 评论(16) 编辑
2010年4月28日
单元测试入门及实践

单元测试

   
单元测试是开发人员对其所实现功能的代码进行的另外编写的测试，用于检测其代码功能的完整性、正确性和其运行效率，从而提高代码质量，并且在写单元测试时发现功能代码间的依赖等设计问题，从而提高产品的可扩展性。

这会让开发人员费更多的时间关注于这个，在短时期来看确实是这样，但放到整个产品周期中来评估的话，其时间上来说是节约的，在后期不会陷入整个产品代码无尽的Bug状态，可以说越是在后期越能显现UT的威力，还可以更自信的交出产品。
 

目的

  
单元测试用来作用于：

  • 代码质量保证
    在开发人员修改代码后保证不会对之前、其它代码产生影响，通过简单的运行测试就可以知道当前修改会产生哪些影响（那些Failed掉的Case即是所受影响的代码）

     

  • 代码清晰、提高可维护性
    有点代码先过自己一关的味道，这样写出来的代码更优美，更具可维护性。

     

  • 使项目架构更合理
    在进行UT，可以发现代码设计中不合理的地方，提高代码的配置性，可扩展性。
 

Unit Test Framework

    
测试框架不仅提供了一整套的判断机制，还提供了运行测试用例的工具，很方便的去运行单元测试用例。

在.NET中有几个著名的测试框架，NUnit和MS Unit是其中比较火的，关于两者的对比大家可以网上找下，选择一款适合自己的，这里呢，我们使用MS Unit。

 
单元测试的方法

A sample case：

1 public int Add(int m, int n)
2 {
3     return m + n;
4 }

测试1：
在这种情况下，我们设定一个期待值，并传入两个参数进行运算，然后判断结果是不和期待值相同来进行单元测试。

1 [TestMethod]
2  public void Add_Normal_Test()
3 {
4     Calculator cal = new Calculator();
5     int expect = 3;
6 
7     int actual = cal.Add(1, 2);
8     Assert.AreEqual(expect, actual);
9 }

好的测试代码总是从多方面去进行测试，如考虑边界，错误情况下的处理...

1 [TestMethod]
2  public void Add_Error_Test()
3 {
4     Calculator cal = new Calculator();
5     int expect = 3;
6 
7     int actual = cal.Add(-3000, 2);
8     Assert.AreNotEqual(expect, actual);
9 }

 

再看下边界性况下的测试

 1 [TestMethod]
 2  public void Add_Limit_Test()
 3 {
 4     Calculator cal = new Calculator();
 5     Int64 expect = 4394967294;
 6 
 7     //// int.MaxValue = 2147483647
 8      int actual = cal.Add(int.MaxValue, int.MaxValue);
 9     Assert.AreEqual(expect, actual);
10 }

 

优化

在上面的例子中，我们在每一个Case中都去声明了Calculator对象的实例，并且都没有对该类的属性做出任何修改。那可以将其提出作为公用。并在测试类初始化时去生成Calculator的实例。

在MS Test中有两种办法在所有用例运行之前生成该依赖对象的实例：

1. 构造函数
 1 
 2 [TestClass]
 3  public class CalculatorTest
 4 {
 5     private Calculator cal;
 6 
 7     public CalculatorTest()
 8     {
 9         cal = new Calculator();
10     }
11 
12     ~CalculatorTest()
13     {
14         cal = null;
15     }
16 
17     [TestMethod]
18     public void Add_Normal_Test()
19     {
20         int expect = 3;
21 
22         int actual = cal.Add(1, 2);
23         Assert.AreEqual(expect, actual);
24     }
25 }

 


每一个类中构造函数总是第一个被执行，所以可以将对象实例化放在这里进行，同时在析构函数中对其进行删除。

 

2. ClassInitialize特性方法

[ClassInitialize()]
public static void MyClassInitialize(TestContext testContext){}

此处的用法和构造函数相似，只是这里为静态函数，要求外面所定义的变量也必须为静态。（这一点不大符合OO的习惯，更多时间我偏向用构造函数的方式）其对应的也有一个方法，在所有的用例执行完才去执行 [ClassCleanup()]

每个方法前执行的函数
  
如果方法中改变了对象的属性，那就不适合该场景，但确又每个Case都用到该对象怎么办，有一种能在每个方法前去执行的函数吗？Of Course：

[TestInitialize()]
public void MyTestInitialize(){}
该特性方法会在每个单元测试用例运行之行启动，用作于初始化一些对象，它对应的[TestCleanup()]特性方法则是用于在每个Case结束后进行的操作，有点像AOP的理念。

  
解除依赖

    
在刚才的代码中我们讲了怎么去基于一个函数去写UT，怎么写出更好的UT，为了让学习起来更简单，我们的示例代码也足够简洁。但事实上你直正写测试时不会碰到这样的代码。
你更多时会遇到这样的代码：

 1 public class UserService
 2 {
 3     public string GetUserNameById(string id)
 4     {
 5         IUserRepository userRepository = new UserRepository();
 6         User user = userRepository.GetUser(id);
 7 
 8         return user.Name;
 9     }
10 }

在方法中调用另外一个对象的方法去取得数据，那怎么去测试？

 

Q: 直接写一个对应的单元测试用例，传入一个id看返回值是否为我们想要。
A: 这种方法不可取，试想，如果用例失败，无法判断是哪一个函数出错，UserService.GetUserNameById() 本身还是UserRepository.GetUser()。同时，如果连接测试数据库，还要保证测试数据的有效性，所以这样的测试不好。

Q: 怎么写出好的测试用例？
A: 使用Mock，我们将对IUserRepository 接口进行另一个实现，在该实现中返回指定的值，从而使GetUserNameById方法的测试不依赖于UserRepository对象。

在进行Mock时我们发现，IUserRepository 放在方法中，无法在对象以外进行配置，可扩展性不强，于是我们将其提取为字段，并通过构造函数来进行赋值。

 1 public class UserService
 2 {
 3     public IUserRepository userRepository;
 4 
 5     public UserService(IUserRepository userRepository)
 6     {
 7         this.userRepository = userRepository;
 8     }
 9 
10     public string GetUserNameById(string id)
11     {
12         
13         User user = userRepository.GetUser(id);
14 
15         return user.Name;
16     }
17 }

这个是我们的Mock对象，实现了接口，对其中的方法进行指定值的返回。
1 public class MockUserRepository : IUserRepository
2 {
3     public User GetUser(string id)
4     {
5         return new User(){Id = "3577", Name = "Lanvige"};
6     }
7 }

在测试用例中，我们可以用该Mock的对象作为Service的操作对象。这样，我们总能保证测试的最小性和准确性。
   
 1 [TestClass]
 2  public class UserSericeTest
 3 {
 4     public void Get_UserName_By_Id_Test()
 5     {
 6         IUserRepository userRepository = new MockUserRepository();
 7 
 8         UserService userSerivce = new UserService(userRepository);
 9         User user = userSerivce.GetUserNameById("3277");
10 
11         Assert("3277", user.Id);
12         Assert("Lanvige", user.Name);
13     }
14 }

上面的依赖是通对接口来进行解耦的，那对抽像类呢？
答案也是可以的，我们通过父类的overwite来重写方法的返回值。达到Mock的功能。

通过上面的代码，我们即写好了一个测试，又发现了代码中的架构设计问题，那么接下来的就是不停的去Run这个测试，当你有改动代码时就去运行这些Unit test，一旦发现Failed，立即停下手头工作，找到原因，Fix it。
    
原则
   
  • 所有的测试都必须通过
    这一点很重要，不能因为懒惰而产生Failed掉的Case。

     

  • 可重复性
    每一个测试用例在不同时间运行都应得到相同的结果。

     

  • 无依赖性
    测试不应依赖于某一环境、测试数据。在不同的机器上应该都能得到相同的运行结果。

     

  • 最小测
    一个测试用例仅只用来测试一个功能函数，这样的好外是，当这个用例失败时，能很清楚的知道出错位置。

   
实践

   
Q1：如何放置测试数据
   
在我们一个项目中便出现这么一种问题，测试代码要对从TFS中取得的数据进行测试，来验证功能的正确性，在最初的版本中先行者将从TFS中取得的代码放在了C盘，在测试结束后并不进行删除，于是每个开发人员的C盘中就莫名的多了很多的文件，并在不同的机器上运行时出现很多的错误。

解决方案：
每次运行完都记得删除所有的影响。每次运行Test Case，VS都会为我们创建一个测试目录，并随着运行而进行删除，我们可以将数据放在该目录下，从而保证每次运行时的测试数据都是干净的。所有的写操作都是基于该目录进行，不会产生污染。

 

---------

用Chrome在线写该文档时，出现1次Church，两次死掉，换了Firefox后才安心写全，不过掉了很多东西。算作初版。

项目要求Unit Test，是个挑战，在使用过程中总结了一点UT的基本知识和实践中的问题，下一篇中会和大家分享下如何使用Mock Framework和一些经验。

 


Zhiming Jiang

MSN GMD Shanghai

 

 

posted @ 2010-04-28 22:41 Zhiming Jiang 阅读(2545) 评论(10) 编辑
2010年4月24日
ASP.NET Routing 101

介绍

 

以前的做法

先前的ASP.NET Web Form开发时期，一个请求总是对应一个特定的物理文件，在文件的路径后用?key=value;的方式来传递参数，http://www.msn.com/books/products.aspx?name=twilight，这种方式不便于用户去记忆，也对SEO不够友好。相对于http://www.msn.com/books/twilight来说后者更具有可读，可记忆性。

还可以使用 URL 模式通过编程方式来创建对应于路由的 URL。这使您能够集中逻辑用于创建 ASP.NET 应用程序中的超链接。

 

对比 URL Rewriter

早期开源的URL Rewriter开始利用正则表达式匹配，将一个匹配规则请求进行转换并跳转另一个对应物理文件的URL上，从而实现上面所提到例子的功能。ASP.NET Routing则是直接将请求发送到对应的文件或者对应类和其方法的，从这一点来说效率是优于URL Rewriter的。

 

在MVC中的应用

由于MVC中使用Routing作为默认的路由工具，致使大多数人都认为其是MVC的一部分，这里澄清一下，MVC只是依赖Routing去做URL路由，将一个请求导向到一个Controller里的Action并生成其余的参数，而Routing本身还可以将请求导向到具体的文件，用作于Web Form开发。

接下来我们以MVC为例来讲解怎么进行Routing的配置，使用和测试。

 

MVC中的Routing

 

打开VS，新建一个项目之后，在Global.asax.cs中我们能看到有默认的Routing规则：

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

namespace BlueMvc
{
    // Note: For instructions on enabling IIS6 or IIS7 classic mode, 
    // visit http://go.microsoft.com/?LinkId=9394801

    public class MvcApplication : System.Web.HttpApplication
    {
        public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            routes.MapRoute(
                "Default", // Route name
                "{controller}/{action}/{id}", // URL with parameters
                new { controller = "Home", action = "Index", id = UrlParameter.Optional } 
            );

        }

        protected void Application_Start()
        {
            AreaRegistration.RegisterAllAreas();

            RegisterRoutes(RouteTable.Routes);
        }
    }
}

分析上面代码可以看到，在应用启动时的Application_Start方法中去注册Router，所有的规则都是存放在RouteCollection这个集合的实例下面，可以通过该对象的Add方法进行追加新的Routing规则。

MVC中RouteCollectionExtensions类对ASP.NET Routing进行的扩展，新增了MapRoute方法用于对Controller和Action进行的映射，上面代码就是使用了MapRoute来进行添加路由规则的。我们再来看下MapRoute这个方法的定义。

static Route MapRoute(this RouteCollection routes, string name, string url, object defaults, object constraints);

参数具体的祥解

string routeName, 该路由规则的名称

string url, 约定要进行匹配URL的规则，如上面代码中的"{controller}/{action}/{id}", 只能匹配“product/search/101”这样三段式的URL

object defaults, 该参数指名要传递的Controller和Action

object constraints, 该参数用来对url中的规则进行约束，例如，指定id只能为数值型，Action名字等等。

 

定义URl Route

 

路由定义 匹配 URL 示例

{controller}/{action}/{id}

/Products/show/beverages

blog/{action}/{entry}

/blog/show/123

/report/{type}/{year}/{month}/{day}

/report/sales/2008/1/5

{language}-{country}/{action}

/zh-cn/show

{controller}/{action}/{*id}

/Products/show/1/0/1

 

占位符

在路由中，您可以通过用大括号{ 和 }来定义占位符（称为“URL 参数”）。在分析 URL 时将 / 字符解释为分隔符。将路由定义中将不是分隔符和不在大括号中的信息视为一个常量值。（URL中只有三种值，占位符，/分隔符）、常量）

您可以在分隔符之间定义多个占位符，但必须用一个常量值分隔开。例如，{language}-{country}/{action} 是有效的路由模式。但是，由于占位符之间没有常量或分隔符，所以 {language}{country}/{action} 不是有效的模式。

 

*可变数量段

有时您需要处理包含可变数量的 URL 段的 URL 请求。定义路由时，通过将参数标记星号 (*) 可以指定最后一个参数应与 URL 的其余部分匹配。因而该参数称为“全部捕捉”参数。

{controller}/{action}/{*id}

 

默认值

如果 URL 没有包括该参数的值，则会使用默认值。通过将字典分配给 Route 类的 Defaults 属性，可以设置路由的默认值，上面代码中也有使用默认值，如下代码：

new { controller = "Home", action = "Index", id = UrlParameter.Optional }

 

约束

约束是通过使用正则表达式或使用实现 IRouteConstraint 接口的对象来定义的。将路由定义添加到 Routes 集合时，同时也通过创建一个包含验证测试的 RouteValueDictionary 对象添加了约束。然后将此对象分配给 Constraints 属性。字典中的关键字标识约束适用的参数。字典中的值可以是表示正则表达式的字符串，也可以是实现 IRouteConstraint 接口的对象。

提供字符串后，路由将视字符串为正则表达式，并通过调用 Regex 类的 IsMatch 方法检查参数值是否有效。总是将正则表达式视为不区分大小写。

new { controller = @"^\w+", action = @"^\w+", id = @"^\d+"， httpMethod = “POST” });

 

顺序

Request进来之后按照Route的顺序来进行匹配，一量URL满足最先能匹配的规则时，则URL Routing会对该URL进行处理，提取URL信息，生成一个RouteData，使用实现IRouteHandler接口的Hanlder来执行具体映射，并且不会再去匹配处理后面的规则，所以在设置Routes顺序时有以下两条准则。

  • 将子集放到前面，父集放在后面。
  • 将父集加上更祥细的约束

RoutingExistFiles，该属性指定是否要在指不到对应的规则情况下去寻找该URL对应位置的物理文件。

 

重要的命名空间、类和接口

 

  • System.Web.Routing - 此命名空间提供用于URL路由的类 
  • IRouteHandler - 路由处理程序的接口，自定义的路由处理程序都要实现这个接口 
  • RequestContext - 封装所请求的路由的相关信息和当前的http上下文 
  • RouteData - 所请求路由相关信息，如Controller和Action的值 
  • RouteCollection - 路由集合 
  • RouteValueDictionary - 字典表，用来包含各样信息，不区分大小写 
  • Route - 继承RouteBase，内含路由相关信息

 

最佳实践

 

很多人担心如果前期URL设置不好或有新的Features加入如何修改Routing配置的问题，就目前应用结果来说这点担心有点多余，URL请求规则是在产品发布时定义好的，在产品修改时才会作出修改，换句话说配置改变的几率很小。

当然，我们仍可以将URL Routing放在外部配置文件中。具体作法这里先不谈。

 

单元测试

 

在测试中使用Moq Mock框架，模拟一次URL请求，通过判断route执行结果返回的Controller和Action值来确认Routing的正确性。

using System;
using System.Text;
using System.Collections.Generic;
using System.Linq;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Moq;
using System.Web;
using System.Web.Routing;
using Core;

namespace Tests
{
    [TestClass]
    public class RoutingTest
    {
        [TestMethod]
        public void TestRouting()
        {
            const string url = "~/";

            var mockRequest = new Mock<HttpRequestBase>();
            mockRequest.Setup(p => p.AppRelativeCurrentExecutionFilePath).Returns(url);
            mockRequest.Setup(p => p.PathInfo).Returns(string.Empty);
            HttpRequestBase request = mockRequest.Object;

            var mockContext = new Mock<HttpContextBase>();
            mockContext.Setup(p => p.Request).Returns(request);
            HttpContextBase context = mockContext.Object;

            RouteTable.Routes.Clear();

            BuleLiteApplication.RegisterRoutes(RouteTable.Routes);
            var routeData = RouteTable.Routes.GetRouteData(context);

            Assert.AreEqual("Home", routeData.Values["controller"]);
            Assert.AreEqual("Index", routeData.Values["action"]);
        }
    }
}
posted @ 2010-04-24 22:54 Zhiming Jiang 阅读(217) 评论(0) 编辑
2009年7月8日
SQL操作全集 [转]
SQL操作全集

下列语句部分是Mssql语句，不可以在access中使用。

SQL分类：
DDL—数据定义语言(CREATE，ALTER，DROP，DECLARE)
DML—数据操纵语言(SELECT，DELETE，UPDATE，INSERT)
DCL—数据控制语言(GRANT，REVOKE，COMMIT，ROLLBACK)

首先,简要介绍基础语句：
1、说明：创建数据库
CREATE DATABASE database-name
2、说明：删除数据库
drop database dbname
3、说明：备份sql server
--- 创建 备份数据的 device
USE master
EXEC sp_addumpdevice 'disk', 'testBack', 'c:\mssql7backup\MyNwind_1.dat'
--- 开始 备份
BACKUP DATABASE pubs TO testBack
4、说明：创建新表
create table tabname(col1 type1 [not null] [primary key],col2 type2 [not null],..)
根据已有的表创建新表：
A：create table tab_new like tab_old (使用旧表创建新表)
B：create table tab_new as select col1,col2… from tab_old definition only
5、说明：删除新表drop table tabname
6、说明：增加一个列
Alter table tabname add column col type
注：列增加后将不能删除。DB2中列加上后数据类型也不能改变，唯一能改变的是增加varchar类型的长度。
7、说明：添加主键： Alter table tabname add primary key(col)
说明：删除主键： Alter table tabname drop primary key(col)
8、说明：创建索引：create [unique] index idxname on tabname(col….)
删除索引：drop index idxname
注：索引是不可更改的，想更改必须删除重新建。
9、说明：创建视图：create view viewname as select statement
删除视图：drop view viewname
10、说明：几个简单的基本的sql语句
选择：select * from table1 where 范围
插入：insert into table1(field1,field2) values(value1,value2)
删除：delete from table1 where 范围
更新：update table1 set field1=value1 where 范围
查找：select * from table1 where field1 like ’%value1%’ ---like的语法很精妙，查资料!
排序：select * from table1 order by field1,field2 [desc]
总数：select count * as totalcount from table1
求和：select sum(field1) as sumvalue from table1
平均：select avg(field1) as avgvalue from table1
最大：select max(field1) as maxvalue from table1
最小：select min(field1) as minvalue from table1
11、说明：几个高级查询运算词
A： UNION 运算符
UNION 运算符通过组合其他两个结果表（例如 TABLE1 和 TABLE2）并消去表中任何重复行而派生出一个结果表。当 ALL 随 UNION 一起使用时（即 UNION ALL），不消除重复行。两种情况下，派生表的每一行不是来自 TABLE1 就是来自 TABLE2。
B： EXCEPT 运算符
EXCEPT 运算符通过包括所有在 TABLE1 中但不在 TABLE2 中的行并消除所有重复行而派生出一个结果表。当 ALL 随 EXCEPT 一起使用时 (EXCEPT ALL)，不消除重复行。
C： INTERSECT 运算符
INTERSECT 运算符通过只包括 TABLE1 和 TABLE2 中都有的行并消除所有重复行而派生出一个结果表。当 ALL 随 INTERSECT 一起使用时 (INTERSECT ALL)，不消除重复行。
注：使用运算词的几个查询结果行必须是一致的。
12、说明：使用外连接
A、left outer join：
左外连接（左连接）：结果集几包括连接表的匹配行，也包括左连接表的所有行。
SQL: select a.a, a.b, a.c, b.c, b.d, b.f from a LEFT OUT JOIN b ON a.a = b.c
B：right outer join:
右外连接(右连接)：结果集既包括连接表的匹配连接行，也包括右连接表的所有行。
C：full outer join：
全外连接：不仅包括符号连接表的匹配行，还包括两个连接表中的所有记录。

其次，大家来看一些不错的sql语句
1、说明：复制表(只复制结构,源表名：a 新表名：b) (Access可用)
法一：select * into b from a where 1 <>1
法二：select top 0 * into b from a

2、说明：拷贝表(拷贝数据,源表名：a 目标表名：b) (Access可用)
insert into b(a, b, c) select d,e,f from b;

3、说明：跨数据库之间表的拷贝(具体数据使用绝对路径) (Access可用)
insert into b(a, b, c) select d,e,f from b in ‘具体数据库’ where 条件
例子：..from b in '"&Server.MapPath(".")&"\data.mdb" &"' where..

4、说明：子查询(表名1：a 表名2：b)
select a,b,c from a where a IN (select d from b ) 或者: select a,b,c from a where a IN (1,2,3)

5、说明：显示文章、提交人和最后回复时间
select a.title,a.username,b.adddate from table a,(select max(adddate) adddate from table where table.title=a.title) b

6、说明：外连接查询(表名1：a 表名2：b)
select a.a, a.b, a.c, b.c, b.d, b.f from a LEFT OUT JOIN b ON a.a = b.c

7、说明：在线视图查询(表名1：a )
select * from (SELECT a,b,c FROM a) T where t.a > 1;

8、说明：between的用法,between限制查询数据范围时包括了边界值,not between不包括
select * from table1 where time between time1 and time2
select a,b,c, from table1 where a not between 数值1 and 数值2

9、说明：in 的使用方法
select * from table1 where a [not] in (‘值1’,’值2’,’值4’,’值6’)

10、说明：两张关联表，删除主表中已经在副表中没有的信息
delete from table1 where not exists ( select * from table2 where table1.field1=table2.field1 )

11、说明：四表联查问题：
select * from a left inner join b on a.a=b.b right inner join c on a.a=c.c inner join d on a.a=d.d where .....

12、说明：日程安排提前五分钟提醒
SQL: select * from 日程安排 where datediff('minute',f开始时间,getdate())>5

13、说明：一条sql 语句搞定数据库分页
select top 10 b.* from (select top 20 主键字段,排序字段 from 表名 order by 排序字段 desc) a,表名 b where b.主键字段 = a.主键字段 order by a.排序字段

14、说明：前10条记录
select top 10 * form table1 where 范围

15、说明：选择在每一组b值相同的数据中对应的a最大的记录的所有信息(类似这样的用法可以用于论坛每月排行榜,每月热销产品分析,按科目成绩排名,等等.)
select a,b,c from tablename ta where a=(select max(a) from tablename tb where tb.b=ta.b)

16、说明：包括所有在 TableA 中但不在 TableB和TableC 中的行并消除所有重复行而派生出一个结果表
(select a from tableA ) except (select a from tableB) except (select a from tableC)

17、说明：随机取出10条数据
select top 10 * from tablename order by newid()

18、说明：随机选择记录
select newid()

19、说明：删除重复记录
Delete from tablename where id not in (select max(id) from tablename group by col1,col2,...)

20、说明：列出数据库里所有的表名
select name from sysobjects where type='U'

21、说明：列出表里的所有的
select name from syscolumns where id=object_id('TableName')

22、说明：列示type、vender、pcs字段，以type字段排列，case可以方便地实现多重选择，类似select 中的case。
select type,sum(case vender when 'A' then pcs else 0 end),sum(case vender when 'C' then pcs else 0 end),sum(case vender when 'B' then pcs else 0 end) FROM tablename group by type
显示结果：
type vender pcs
电脑 A 1
电脑 A 1
光盘 B 2
光盘 A 2
手机 B 3
手机 C 3

23、说明：初始化表table1
TRUNCATE TABLE table1

24、说明：选择从10到15的记录
select top 5 * from (select top 15 * from table order by id asc) table_别名 order by id desc
　　
随机选择数据库记录的方法（使用Randomize函数，通过SQL语句实现）
　　对存储在数据库中的数据来说，随机数特性能给出上面的效果，但它们可能太慢了些。你不能要求ASP“找个随机数”然后打印出来。实际上常见的解决方案是建立如下所示的循环：
Randomize
RNumber = Int(Rnd*499) +1
　
While Not objRec.EOF
If objRec("ID") = RNumber THEN
... 这里是执行脚本 ...
end if
objRec.MoveNext
Wend
　
　　这很容易理解。首先，你取出1到500范围之内的一个随机数（假设500就是数据库内记录的总数）。然后，你遍历每一记录来测试ID 的值、检查其是否匹配RNumber。满足条件的话就执行由THEN 关键字开始的那一块代码。假如你的RNumber 等于495，那么要循环一遍数据库花的时间可就长了。虽然500这个数字看起来大了些，但相比更为稳固的企业解决方案这还是个小型数据库了，后者通常在一个数据库内就包含了成千上万条记录。这时候不就死定了？
　　采用SQL，你就可以很快地找出准确的记录并且打开一个只包含该记录的recordset，如下所示：
Randomize
RNumber = Int(Rnd*499) + 1
　
SQL = "SELECT * FROM Customers WHERE ID = " & RNumber
　
set objRec = ObjConn.Execute(SQL)
Response.WriteRNumber & " = " & objRec("ID") & " " & objRec("c_email")
　
　　不必写出RNumber 和ID，你只需要检查匹配情况即可。只要你对以上代码的工作满意，你自可按需操作“随机”记录。Recordset没有包含其他内容，因此你很快就能找到你需要的记录这样就大大降低了处理时间。
再谈随机数
　　现在你下定决心要榨干Random 函数的最后一滴油，那么你可能会一次取出多条随机记录或者想采用一定随机范围内的记录。把上面的标准Random 示例扩展一下就可以用SQL应对上面两种情况了。
　　为了取出几条随机选择的记录并存放在同一recordset内，你可以存储三个随机数，然后查询数据库获得匹配这些数字的记录：
SQL = "SELECT * FROM Customers WHERE ID = " & RNumber & " OR ID = " & RNumber2 & " OR ID = " & RNumber3
　
　　假如你想选出10条记录（也许是每次页面装载时的10条链接的列表），你可以用BETWEEN 或者数学等式选出第一条记录和适当数量的递增记录。这一操作可以通过好几种方式来完成，但是 SELECT 语句只显示一种可能（这里的ID 是自动生成的号码）：
SQL = "SELECT * FROM Customers WHERE ID BETWEEN " & RNumber & " AND " & RNumber & "+ 9"

　　注意：以上代码的执行目的不是检查数据库内是否有9条并发记录。

　
随机读取若干条记录，测试过
Access语法：SELECT top 10 * From 表名 ORDER BY Rnd(id)
Sql server:select top n * from 表名 order by newid()
mysqlelect * From 表名 Order By rand() Limit n
Access左连接语法(最近开发要用左连接,Access帮助什么都没有,网上没有Access的SQL说明,只有自己测试, 现在记下以备后查)
语法elect table1.fd1,table1,fd2,table2.fd2 From table1 left join table2 on table1.fd1,table2.fd1 where ...
使用SQL语句 用...代替过长的字符串显示
语法：
SQL数据库：select case when len(field)>10 then left(field,10)+'...' else field end as news_name,news_id from tablename
Access数据库：SELECT iif(len(field)>2,left(field,2)+'...',field) FROM tablename;
　
Conn.Execute说明
Execute方法
　　该方法用于执行SQL语句。根据SQL语句执行后是否返回记录集，该方法的使用格式分为以下两种：
　　　　1．执行SQL查询语句时，将返回查询得到的记录集。用法为：
　　　　Set 对象变量名=连接对象.Execute("SQL 查询语言")
　　　Execute方法调用后，会自动创建记录集对象，并将查询结果存储在该记录对象中，通过Set方法，将记录集赋给指定的对象保存，以后对象变量就代表了该记录集对象。

　　　　2．执行SQL的操作性语言时，没有记录集的返回。此时用法为：
　　　　连接对象.Execute "SQL 操作性语句" [, RecordAffected][, Option]
　　　　　　·RecordAffected 为可选项，此出可放置一个变量，SQL语句执行后，所生效的记录数会自动保存到该变量中。通过访问该变量，就可知道SQL语句队多少条记录进行了操作。
　　　　　　·Option 可选项，该参数的取值通常为adCMDText，它用于告诉ADO，应该将Execute方法之后的第一个字符解释为命令文本。通过指定该参数，可使执行更高效。

·BeginTrans、RollbackTrans、CommitTrans方法
posted @ 2009-07-08 12:19 Zhiming Jiang 阅读(70) 评论(0) 编辑
仅列出标题