Nancy之ModelBinding(模型绑定)_html/css_WEB-ITnose

过年前的最后一篇博客，决定留给Nancy中的ModelBinding

还是同样的，我们与MVC结合起来，方便理解和对照

先来看看MVC中简单的ModelBinding吧

 1         // POST: Authors/Create 2         // To protect from overposting attacks, please enable the specific properties you want to bind to, for  3         // more details see http://go.microsoft.com/fwlink/?LinkId=317598. 4         [HttpPost] 5         [ValidateAntiForgeryToken] 6         public ActionResult Create([Bind(Include = "AuthorId,AuthorName,AuthorGender,AuthorEmail,AuthorAddress,AuthorPhone")] Author author) 7         { 8             if (ModelState.IsValid) 9             {10                 db.Authors.Add(author);11                 db.SaveChanges();12                 return RedirectToAction("Index");13             }14             return View(author);15         }  

上面的代码是我用下面类型的控制器生成的一个添加方法，里面就用到了ModelBinding

像这样比较简单的模型绑定，大家应该是很熟悉了吧！

或许已经烂熟于心了。

MVC中关于Model Binding的详细解读可以参见下面的，真的超详细，我就不再展开了

[ASP.NET MVC 小牛之路]15 - Model Binding

ModelBinder——ASP.NET MVC Model绑定的核心

下面就来看看Nancy中的model binding吧。

先来看个具体的例子，我们顺着这个例子来讲解这一块的内容

这个例子我们要用到的引用有Nancy，Nancy.Hosting.Aspnet

我们先来看看它默认的绑定

先建立一个模型Employee

 1     public class Employee 2     { 3         public Employee() 4         { 5             this.EmployeeNumber = "Num1"; 6             this.EmployeeName = "Catcher8"; 7             this.EmployeeAge = 18; 8         } 9         public string EmployeeNumber { get; set; }10         public string EmployeeName { get; set; }11         public int EmployeeAge { get; set; }12         public List EmployeeHobby { get; set; }13     }  

我们在这个模型中，给部分字段设置了默认值。

建立一个视图default.html，用于测试Nancy中默认的ModelBinding

 1  2  3  4      5      6  7  8     

9 员工编号10
11 员工姓名12
13 员工年龄14
15 16 篮球17 足球18 排球19 网球20
21 22

23 24

然后我们建立一个TestModule.cs，在里面演示了各种不同方式下的binding

为了减少描述，我在代码加了很多注释

 1     public class TestModule : NancyModule 2     { 3         public TestModule() 4         { 5             Get["/default"] = _ => 6             {                7                 return View["default"]; 8             }; 9             Post["/default"] = _ =>10             {11                 Employee employee_Empty = new Employee();12                 //这种写法有问题，应该是 Employee xxx = this.Bind(); 才对！13                 //因为这里的this.Bind() 是 dynamic 类型，没有直接指明类型14                 //所以它会提示我们  “找不到此对象的进一步信息”15                 var employee_Using_Bind = this.Bind();16                 17                 //这里在bind的时候指明了类型。这个会正常绑定数据。(推荐这种写法)18                 var employee_Using_BindWithTModel = this.Bind();19                 //这里是将数据绑定到我们实例化的那个employee_Empty对象20                 //运行到这里之后，会发现employee_Empty的默认值被替换了！！21                 var employee_Using_BindTo = this.BindTo(employee_Empty);22                 //与上面的写法等价！23                 var employee_Using_BindToWithTModel = this.BindTo(employee_Empty);24                 //这个主要是演示“黑名单”的用法，就是绑定数据的时候忽略某几个东西25                 //这里忽略了EmployeeName和EmployeeAge，所以得到的最终还是我们设置的默认值26                 var employee_Using_BindAndBlacklistStyle1 = this.Bind(e=>e.EmployeeName,e=>e.EmployeeAge);27                 //与上面的写法等价，演示不同的写法而已！          28                 var employee_Using_BindAndBlacklistStyle2 = this.Bind("EmployeeName", "EmployeeAge");29                 return Response.AsRedirect("/default");30             };                  31         }32     }  

下面来看看运行的结果

我们在表单填下了这些内容，现在我们监视上面的各个值的变化

可以看到employee_Using_Bind的绑定是一种错误的写法，会出错，这个的正确写法，我在注释给出了。

employee_Empty、employee_Using_BindWithTModel、employee_Using_BindingTo、employee_Using_BindingToWithTModel

这几个最终都是一样的效果！！这里说最终，是因为我们的employee_Empty刚实例化时，应该是我们设置的默认值。

employee_Using_BindAndBlacklistStyle1和employee_Using_BindAndBlacklistStyle2是在Bind后面带了参数的，

这些参数就是所谓的黑名单，就是绑定的时候忽略掉。然后结果就是我们设置的默认值Catcher8和18。

至于它为什么这样就能绑定上，我们看了自定义的绑定之后可能会清晰不少。

接下来就是使用自定义的绑定方法：

模型我们还是用刚才的Employee.cs

此处新添加一个视图custom.html，基本和前面的default.html一致，换了个action

 1  2  3  4      5      6  7  8     

9 员工编号10
11 员工姓名12
13 员工年龄14
15 篮球16 足球17 排球18 网球19
20 21

22 23

至关重要的一步！！！编写我们的ModelBinder，这个ModelBinder要实现IModelBinder这个接口！

 1     public class MyModelBinder : IModelBinder 2     { 3         public bool CanBind(Type modelType) 4         { 5             return modelType == typeof(Employee); 6         } 7         public object Bind(NancyContext context, Type modelType, object instance, BindingConfig configuration, params string[] blackList) 8         { 9             var employee = (instance as Employee) ?? new Employee();10             employee.EmployeeName = context.Request.Form["EmployeeName"] ?? employee.EmployeeName;11             employee.EmployeeNumber = context.Request.Form["EmployeeNumber"] ?? employee.EmployeeNumber;12             employee.EmployeeAge = 24;//我们把年龄写死，方便看见差异 13             employee.EmployeeHobby = ConvertStringToList(context.Request.Form["EmployeeHobby"]) ?? employee.EmployeeHobby;14             return employee;15         }16         17         private List ConvertStringToList(string input)18         {19             if (string.IsNullOrEmpty(input))20             {21                 return null;22             }23             var items = input.Split(',');24             return items.AsEnumerable().ToList();25         }26     }  

然后在我们的TestModule.cs中添加如下代码

 1             Get["/custom"] = _ => 2             { 3                 return View["custom"]; 4             }; 5             Post["/custom"] = x => 6             { 7                 //此时就会调用我们自己定义的Binder了 8                 var employee1 = this.Bind(); 9                 Employee employee2 = this.Bind();              10                 return Response.AsRedirect("/custom");11             };    

下面看看运行效果

我们还是在表单输入这些内容，同时对employee1和employee2添加监视

清楚的看到，我们自定义的binder生效了，年龄就是我们设定的24！

Nancy中，还有比较方便的是json和xml也同样能绑定。由于这两个很相似，所以这里就只介绍json。

同样的，例子说话！

添加一个json.html视图

 1  2  3  4      5      6      7      8     22 23    24 25 

在这里，偷懒了(节省点时间)，我是直接写死了两个值，然后打印出这个employee的相关属性。

还有一点要注意的是。引用的js文件，不想写convention配置就把js放到content文件夹，具体的可参见我前面的bolgNancy之静态文件处理。

不然会发现这个错误"$ is not defined"

然后在TestModule.cs中添加如下代码

 1             Get["/json"] = _ => 2             { 3                 return View["json"]; 4             }; 5             Post["/json"] = _ => 6             { 7                 var employee = this.Bind(); 8                 var sb = new StringBuilder(); 9                 sb.AppendLine("绑定的employee的值:");10                 sb.Append("编号: ");11                 sb.AppendLine(employee.EmployeeNumber);12                 sb.Append("姓名: ");13                 sb.AppendLine(employee.EmployeeName);14                 sb.Append("年龄: ");15                 sb.AppendLine(employee.EmployeeAge.ToString());                16                 return sb.ToString();17             };      

运行看看效果

再来看看我们监视的情况！！

很nice，正是我们想要的结果，编号没有赋值，自动取了默认值！

跟往常一样，简单分析一下这一块的源码。

ModelBinding在Nancy这个项目下面，里面的内容如下：

很明显，我们应该先看看DefaultBinder.cs，因为所有的默认实现，Nancy都会带Default的字样

DefaultBinder实现了IBinder这个接口，这个接口里面就一个东西Bind

 1     /// 
 2     /// Binds incoming request data to a model type 3     /// 
 4     public interface IBinder 5     { 6         /// 
 7         /// Bind to the given model type 8         /// 
 9         /// Current context10         /// Model type to bind to11         /// The  that should be applied during binding.12         /// Blacklisted property names13         /// Existing instance of the object14         /// Bound model15         object Bind(NancyContext context, Type modelType, object instance, BindingConfig configuration, params string[] blackList);16     }  

这就是我们ModelBinding的关键所在！

DefaultBinder里面的实现就是

先判断绑定的类型是不是数组集合，是的话，一种处理策略，不是的话，另一种处理策略，

在里面的判断中还有一个重要的概念是Binding Configuration。因为这个Configuration可以修改我们绑定的行为

这里我直接截了官网文档的图来展示

BodyOnly设置为true的时候，一旦主体被绑定，binder就会立刻停止。

IgnoreErrors为false时，就不会在继续进行绑定，为true时就会继续绑定，默认值是false。

Overwrite为ture时，允许binder去覆盖我们设置的那些默认值，为false时，就是不允许，默认值是true！

DefaultBinder里面有个GetDataFields的私有方法

 1         private IDictionary GetDataFields(NancyContext context) 2         { 3             var dictionaries = new IDictionary[] 4                 { 5                     ConvertDynamicDictionary(context.Request.Form), 6                     ConvertDynamicDictionary(context.Request.Query), 7                     ConvertDynamicDictionary(context.Parameters) 8                 }; 9             return dictionaries.Merge();10         }  

从中我们可以看出，它处理绑定的时候用到了字典，包含了表单的数据、url的参数，这点与mvc里面的基本一致！

所以我们在写页面的时候，我们只要把表单元素的name属性设置为对应的字段名就可以，同样的，这个在mvc中也一致

我们在mvc视图中用的 @Html.EditorFor之类的强类型绑定，生成的页面都是把name设置为字段名称！

下面看看ITypeConverter这个接口

1      public interface ITypeConverter2     {       3         bool CanConvertTo(Type destinationType, BindingContext context);4      5         object Convert(string input, Type destinationType, BindingContext context);6     }  

这个接口提供了一种转换类型的方法

CanConvertTo 是判断是否能转化为目的类型，

Convert才是真正的转化！

Nancy默认的Converters包含了Collection、DateTime、Fallback和Numeric

当然，有了这个接口，我们可以实现更多的拓展，怎么用着方便怎么来！

当然不能忘了我们自定义模型绑定用到的接口 IModelBinder

1     public interface IModelBinder : IBinder2     {3         bool CanBind(Type modelType);4     }  

IModerBinder这个接口除了自己定义的CanBind方法外，还继承了IBinder这个接口，所以我们自定义ModelBinder的时候只需要

实现这个接口就可以了。作用就是绑定数据到相应的模型中。

我们前面自定义就是用的这个，把数据绑定到了Employee中。

最后就讲讲“黑名单”的内容！

“黑名单”的实现，还用到了DynamicModelBinderAdapter这个东西，但最为主要的是

DefaultBinder里面的CreateBindingContext这个私有方法！

 1         private BindingContext CreateBindingContext(NancyContext context, Type modelType, object instance, BindingConfig configuration, IEnumerable blackList, Type genericType) 2         { 3             return new BindingContext 4             { 5                 Configuration = configuration, 6                 Context = context, 7                 DestinationType = modelType, 8                 Model = CreateModel(modelType, genericType, instance), 9                 ValidModelBindingMembers = GetBindingMembers(modelType, genericType, blackList).ToList(),10                 RequestData = this.GetDataFields(context),11                 GenericType = genericType,12                 TypeConverters = this.typeConverters.Concat(this.defaults.DefaultTypeConverters),13             };14         }

从中我们可以看到GetBindingMembers用到了blackList，再看看这个方法

1         private static IEnumerable GetBindingMembers(Type modelType, Type genericType, IEnumerable blackList)2         {3             var blackListHash = new HashSet(blackList, StringComparer.Ordinal);4 5             return BindingMemberInfo.Collect(genericType ?? modelType)6                 .Where(member => !blackListHash.Contains(member.Name));7         }

看到这个，行了，基本就懂了！

member => !blackListHash.Contains(member.Name)

这个表达式就是起到了真正的过滤作用啦！！！

ModelBinding就讲到这里了。

最后献上本次的代码示例：

https://github.com/hwqdt/Demos/tree/master/src/NancyDemoForModelBinding