Flutter依赖注入插件dach_locator的使用

Flutter依赖注入插件dach_locator的使用

插件介绍

dach_locator 是一个用于解析德国、奥地利和瑞士邮政编码对应区域的Flutter插件。它可以在没有网络连接的情况下工作，并且支持通过邮政编码获取对应的地区信息。

特性

• 输入一个邮政编码，可以得到该地区的名称和国家（无需网络连接）。
• 如果可能的话，可以添加国家代码（‘DE’, ‘CH’ 或 ‘AT’），否则系统会自动解析出国家。

使用方法

如果想要获取特定国家（奥地利、德国、瑞士）的区域，可以使用以下方法：

• getAustriaRegionCode
• getGermanRegionCode
• getSwitzerlandRegionCode

为了方便使用，还可以使用 getRegion 方法。这个方法返回一个 Region 实例或 null（如果没有匹配）。你可以选择性地传递一个国家代码（‘DE’, ‘CH’ 或 ‘AT’），那么 getRegion 方法的工作方式与上述三个方法相同。如果没有传递 countryCode，则方法会尝试自动解析邮政编码所属的国家。

Set<Region> _resolveRegion(String zipCode, {String? countryCode}) {
  if (int.tryParse(zipCode) != null && zipCode.length > 3 && zipCode.length < 6) {
    return getRegion(zipCode, countryCode: countryCode);
  }
  return {};
}

完整示例 Demo

以下是完整的示例代码，展示了如何在Flutter应用中使用 dach_locator 插件来解析邮政编码并显示结果。

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'DACH Locator Demo',
      theme: ThemeData(
        primarySwatch: Colors.green,
      ),
      home: const ZipCodeConverterPage(title: 'DACH Locator Demo'),
    );
  }
}

class ZipCodeConverterPage extends StatefulWidget {
  const ZipCodeConverterPage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<ZipCodeConverterPage> createState() => _ZipCodeConverterPageState();
}

class _ZipCodeConverterPageState extends State<ZipCodeConverterPage> {
  String _zipCode = '';

  Set<Region> _regions = {};

  late TextEditingController controller;

  [@override](/user/override)
  void initState() {
    super.initState();
    controller = TextEditingController();
    controller.addListener(() {
      _zipCode = controller.text;
      if (int.tryParse(_zipCode) != null &&
          _zipCode.length > 3 &&
          _zipCode.length < 6) {
        final regionMatches = _resolveRegion(_zipCode);
        setState(() {
          _regions = regionMatches;
        });
      } else {
        setState(() {
          _regions = {};
        });
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: <Widget>[
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 32),
            child: Row(
              children: [
                const Text(
                  'Enter ZIP Code:',
                ),
                const SizedBox(width: 16),
                Expanded(
                  child: TextField(
                    controller: controller,
                    keyboardType: TextInputType.number,
                    // 用户输入邮政编码的地方
                  ),
                ),
              ],
            ),
          ),
          const SizedBox(
            height: 32,
          ),
          for (final region in _regions) ...[
            if (region.regionName != null)
              Text(
                region.regionName!,
                style: Theme.of(context).textTheme.headlineMedium,
                // 显示解析出来的区域名称
              ),
            if (region.regionName != null && region.countryName != null)
              Text(
                region.countryName!,
                style: Theme.of(context).textTheme.headlineSmall,
                // 显示解析出来的国家名称
              ),
          ]
        ],
      ),
    );
  }

  Set<Region> _resolveRegion(String zipCode, {String? countryCode}) {
    if (int.tryParse(zipCode) != null &&
        zipCode.length > 3 &&
        zipCode.length < 6) {
      final regions = getRegion(zipCode, countryCode: countryCode);
      return regions;
    }
    return {};
  }
}