Flutter异常处理插件exception_widget的使用

Flutter 插件 exception_widget 允许你通过不同的异常类型来处理不同的小部件。你可以根据需要处理多种异常，并为每种异常返回特定的视图（例如在处理 Future 结果时）。

特性

ExceptionWidget

该小部件可以在需要处理多个异常并为每个异常返回特定视图的情况下使用（例如在处理 Future 结果时）。你只需传递需要处理的异常和一个映射表（Type: Widget），定义当错误类型为指定类型时返回哪个小部件。

如果当前错误未被映射，则会返回一个 Container 小部件。

ExceptionWidget(
  error: snapshot.error,
  errorMap: {
    FooException: Text('FooException handled'),
    BarException: Text('BarException handled'),
  },
)

这样你就无需手动检查异常类型以返回所需的视图。

完整示例

以下是一个完整的示例，演示了如何使用 exception_widget 来处理不同类型的异常。

示例代码

import 'package:exception_widget/exception_widget.dart';
import 'package:flutter/material.dart';

// 导入自定义的异常类
import 'exceptions.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter ExceptionWidget Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter ExceptionWidget Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, this.title}) : super(key: key);

  final String? title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Future? _future;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(widget.title!)),
      body: Center(
        child: Column(
          children: [
            Row(
              mainAxisSize: MainAxisSize.max,
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Padding(
                  padding: const EdgeInsets.all(8.0),
                  child: ElevatedButton(
                    onPressed: () {
                      setState(() {
                        _future = _foo();
                      });
                    },
                    child: Text('Foo'),
                  ),
                ),
                Padding(
                  padding: const EdgeInsets.all(8.0),
                  child: ElevatedButton(
                    onPressed: () {
                      setState(() {
                        _future = _bar();
                      });
                    },
                    child: Text('Bar'),
                  ),
                ),
              ],
            ),
            FutureBuilder(
              future: _future,
              builder: (context, snapshot) {
                if (snapshot.hasError) {
                  return ExceptionWidget(
                    error: snapshot.error as Exception,
                    errorMap: {
                      FooException: Text('FooException handled'),
                      BarException: Text('BarException handled'),
                    },
                  );
                }

                return Text('正常行为');
              },
            ),
          ],
        ),
      ),
    );
  }

  Future<void> _foo() async {
    return Future.error(FooException());
  }

  Future<void> _bar() async {
    return Future.error(BarException());
  }
}

自定义异常类

为了演示效果，你需要创建一些自定义异常类：

// exceptions.dart
class FooException implements Exception {}

class BarException implements Exception {}

运行示例

1. 创建一个新的 Flutter 项目。
2. 在 pubspec.yaml 文件中添加 exception_widget 依赖：

   dependencies:
     flutter:
       sdk: flutter
     exception_widget: ^1.0.0  # 请确保使用最新版本