概述
表单验证的最终效果大家都懂,这里不阐述了,主要从宏观角度说说blazor中表单验证框架涉及到的类,以及它们是如何协作的,看完这个,再看官方文档也许能更轻松点。
blazor中的验证框架分为两部分:基础验证框架 和 基于数据注释Atrrbute的验证器,当然也提供了很多扩展点。注意我们通常使用数据注释Atrrbute的验证器,但它仅仅是在基础验证框架上扩展而来的,并不是核心,我们下面先分析基础验证框架,后续再说基于数据注释的验证。
表单验证是围绕表单,往往一个表单绑定到一个对象,我这里称为编辑模型,表单中的输入框与这个对象属性绑定。
我们先把基础验证框架看作一个整体,从几个角度分析:
- 产生验证消息,这个不属于验证框架的核心部分,验证框架只需要提供一个方法,当框架外部产生验证时,调用此方法,让验证框架去记录即可
- 存储验证消息是验证框架的核心工作之一,我们可以想象使用一个Dictionary<字段,List<验证消息>>来存储,key对应编辑模型的一个字段,value是验证消息集合,一个字段可能有多个验证消息。
- 我们可以定义两个组件用于展示验证消息,一个用于汇总展示,一个用户展示指定指定的验证消息,它们从验证框架获取验证信息进行显示。
- 清空验证消息,验证框架内部从存储中清空即可,可以向外暴露个事件,还可以留个方法允许外部主动调用清空验证消息,最好再允许外部清空指定字段的验证消息。
- 下面说明下blazor中表单验证的关键类,以及它们之间的关系。
基础验证框架先是定义几个零散的类,各自负责处理自己的部分,然后通过引用、方法调用把几个类串联起来。
字段标识FieldIdentifier
前面说存储验证消息时,类似这么个类型:Dictionary<字段,List<验证消息>>,简单的情况“字段”可以用个string类型,但我们是在内存中,可以用更直接的方式。
FieldIdentifier = 编辑模型的引用 + 字段名,它就代表编辑模型的某个字段。后续我们要操作某个字段,往往都是用这个参数。
验证消息存储器ValidationMessageStore
ValidationMessageStore是用这样一个字段Dictionary<FieldIdentifier, List<string>> _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的引用
额外的,它还提供字段变化时、请求验证时的相关事件。
小结
- 保持EditContext轻量,它不引用具体的验证存储器,而是只包含 字段状态 + 编辑模型实例,通过EditContext遍历里面的字段状态FieldState,获取验证消息,字段状态内部是遍历存储器列表获取验证消息。
- 将验证状态存储器抽离出来,哪里想向编辑上下文添加字段验证,就new ValidationMessageStore(editContext);然后Add验证消息即可。
- 便于扩展,比如后面的基于数据注解的验证器,它就是自己new ValidationMessageStore(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到存储器中。