概述

表单验证的最终效果大家都懂,这里不阐述了,主要从宏观角度说说blazor中表单验证框架涉及到的类,以及它们是如何协作的,看完这个,再看官方文档也许能更轻松点。

blazor中的验证框架分为两部分:基础验证框架 和 基于数据注释Atrrbute的验证器,当然也提供了很多扩展点。注意我们通常使用数据注释Atrrbute的验证器,但它仅仅是在基础验证框架上扩展而来的,并不是核心,我们下面先分析基础验证框架,后续再说基于数据注释的验证。

表单验证是围绕表单,往往一个表单绑定到一个对象,我这里称为编辑模型,表单中的输入框与这个对象属性绑定。

我们先把基础验证框架看作一个整体,从几个角度分析:

  1. 产生验证消息,这个不属于验证框架的核心部分,验证框架只需要提供一个方法,当框架外部产生验证时,调用此方法,让验证框架去记录即可
  2. 存储验证消息是验证框架的核心工作之一,我们可以想象使用一个Dictionary<字段,List>来存储,key对应编辑模型的一个字段,value是验证消息集合,一个字段可能有多个验证消息。
  3. 我们可以定义两个组件用于展示验证消息,一个用于汇总展示,一个用户展示指定指定的验证消息,它们从验证框架获取验证信息进行显示。
  4. 清空验证消息,验证框架内部从存储中清空即可,可以向外暴露个事件,还可以留个方法允许外部主动调用清空验证消息,最好再允许外部清空指定字段的验证消息。
  5. 下面说明下blazor中表单验证的关键类,以及它们之间的关系。

基础验证框架先是定义几个零散的类,各自负责处理自己的部分,然后通过引用、方法调用把几个类串联起来。

字段标识FieldIdentifier

前面说存储验证消息时,类似这么个类型:Dictionary<字段,List>,简单的情况“字段”可以用个string类型,但我们是在内存中,可以用更直接的方式。

FieldIdentifier = 编辑模型的引用 + 字段名,它就代表编辑模型的某个字段。后续我们要操作某个字段,往往都是用这个参数。

验证消息存储器ValidationMessageStore

ValidationMessageStore是用这样一个字段Dictionary<FieldIdentifier, List> _messages来存储验证消息的。key是字段,value是此字段的多个验证消息。也提供了插入、删除等验证消息等方法。

它一般是有我们自己的代码new出来的,或者有扩展的验证器,如 基于数据注释的验证器new出来的。new它的时候会把editContext对象传进来,后面会用。

当调用这个对象添加验证消息时,它会存储此字段的验证消息,并且调用editContext获取字段状态FieldState,将自身的引用传递给它,以便FieldState将来反向通过存储器来查询验证状态。

字段状态FieldState

FieldState表示字段的状态,所谓的状态就是 这个字段是否修改过、以及获取它关联的验证消息(本质上是从ValidationMessageStore获取,后面会说)。

为啥不跟字段标识FieldIdentifier合并为一个类呢?
字段标识只是代表某个字段,在很多方法参数时都会用到,它比较轻量;而字段状态是存储了字段是否修改和验证消息列表的,相对来说比较重,那些方法可能仅仅是想通过字段标识做查找,并不关心内部的状态

它包含一个ValidationMessageStore的列表,获取此字段的验证消息时,就是遍历这个列表获取的。但FieldState不负责向存储器添加验证消息。这个列表如何来的,验证消息存储器ValidationMessageStore已经说明了。

表单编辑上下文EditContext

可以把EditContext理解为 :字段状态FieldState列表+ 编辑模型实例,注意它不引用ValidationMessageStore,之所以这样设计是想保持EditContext轻量。

那主要关心的就是FieldState列表的crud操作
创建FieldState,则是外部想通过EditContext获取字段状态时,若有就返回,否则创建并记录下来。
读取就直接遍历FieldState咯。
删除:好像木有,也没有必要
改:找到字段状态,直接改咯。

另外:一个EditForm与一个EditContext关联,EditForm内部的组件会通过级联方式获得editContext的引用

额外的,它还提供字段变化时、请求验证时的相关事件。

小结

  1. 保持EditContext轻量,它不引用具体的验证存储器,而是只包含 字段状态 + 编辑模型实例,通过EditContext遍历里面的字段状态FieldState,获取验证消息,字段状态内部是遍历存储器列表获取验证消息。
  2. 将验证状态存储器抽离出来,哪里想向编辑上下文添加字段验证,就newValidationMessageStore(editContext);然后Add验证消息即可。
  3. 便于扩展,比如后面的基于数据注解的验证器,它就是自己newValidationMessageStore(editContext),然后使用注解验证方式向其添加验证。

验证消息的展示

展示就比较简单了,EditForm与EditContext关联的,它会级联传递到表单的子组件,子组件通过EditContext遍历字段就能拿到验证消息。

ValidationSummary

它是汇总显示所有验证消息,它通过级联参数获取EditContext引用,遍历然后显示验证消息。

ValidationMessage

原理类似,它显示指定字段的验证消息。

基于数据注释验证器扩展

所谓的验证器,无非是定义一个类,让它持有EditContext的引用,然后它内部new ValidationMessageStore(editContext),然后通过自己的方式验证后,Add验证消息到ValidationMessageStore即可。

DataAnnotationsValidator

组件是个空壳,它通过级联参数拿到EditContext对象,然后调用EditContextDataAnnotationsExtensions中定义的扩展方法,创建了一个实现IDispose的对象,组件释放时会释放这个对象

这个核心对象内部new ValidationMessageStore(editContext),用来存储验证消息。

它在初始化时会注册:

_editContext.OnFieldChanged += OnFieldChanged;
_editContext.OnValidationRequested += OnValidationRequested;

字段变化时,验证,或者外部向editContext请求验证时,触发验证。然后将验证消息Add到存储器中。