这个模块的源码和diagnostics文件里源码关系非常密切,这个文件里源码有1000多行。
接下来会对每个类的进行解析,如有不足之处,可以在下面评论指出。
第一部分说的一些类在assertions文件里比较独立,第二部分的内容就和diagnostics非常密切。
第一部分:
- PartialStackFrame这个类相比StackFrame, 就简单很多,也就很容易理解为什么有Partial(部分的)这个前缀。这个类只有三个属性:package,className和method。还有一个matches方法,传入的参数是StackFrame类型的,主要是通过package,className和method属性的值与StackFrame类型的传入参数对应的属性值是否相等来判断是后匹配。
- StackFilter这个是一个抽象类,主要就是一个filter抽象方法,在栈帧(StackFrame)列表(list)中过滤出一些匹配栈帧片段(StackFrame), 这些片段也是list类型的。
- RepetitiveStackFrameFilter这个类继承了StackFilter,从它的名字再结合代码就可以知道它的主要任务是从一个大的StackFrame类型的list里匹配PartialStackFrame类型的小的list,其中具体是否匹配就是通过第一条PartialStackFrame中matches方法实现的。该类的filter和_matchesFrames方法还是很好理解的,就不再赘述了。
第二部分:
- _ErrorDiagnostic继承了DiagnosticsProperty, 内部实现还是很简单的,就难在DiagnosticsProperty的理解上,点开链接就能看到对DiagnosticsProperty的解读。
- ErrorDescription继承了_ErrorDiagnostic,只是定义了这个类的level的值是DiagnosticLevel.info。
- ErrorSummary继承了_ErrorDiagnostic,也只是定义了这个类的level的值是DiagnosticLevel.summary。
- ErrorHint继承了_ErrorDiagnostic,也只是定义了这个类的level的值是DiagnosticLevel.hint。
- ErrorSpacer继承自DiagnosticsProperty,其实就是创建了一个空的DiagnosticsNode的类,可以用来调整DiagnosticsNode对象间的距离的。
- FlutterErrorDetails这个类混合了(with)Diagnosticable,主要作用是FlutterExceptionHandler回调的参数类型,这个类的形参除了exception不能为null,其他的都可以是默认值。这个类有很多属性propertiesTransformers, exception, stack, library, context, stackFilter, informationCollector, silent。需要先明白diagnostics的内部实现,就能很清晰的知道内部逻辑。
- _FlutterErrorDetailsNode这个内部类是继承DiagnosticableNode的,只有一个builder的get方法。
- DiagnosticsStackTrace这个类是继承DiagnosticsBlock,这个类的内部实现是封建的,只有一些初始化的方式。
这是flutter框架源码分析的其中一篇,因能力有限,有诸多不足之处,还请斧正。