Flutter轻量级数据库管理插件hive_simple的使用

Flutter轻量级数据库管理插件hive_simple的使用

简介

hive_simple 是一个基于Hive的Flutter插件，旨在简化数据存储和管理。它提供了一组自定义函数来添加、更新和删除数据，使得与Hive数据库的交互变得更加简单。该插件消除了为每个表添加单独适配器的需求，提供了一种更灵活和高效的方式来管理Flutter项目中的数据。

特性

• 轻松存储数据：通过调用 await DbMain.instance.hiveAddItem(tableName, data) 来存储数据。
• 轻松获取数据：通过调用 await DbMain.instance.hiveGetItemList(tableName) 来获取数据。
• 支持FlutterFlow：FlutterFlow用户可以直接从FlutterFlow常量中创建表。
• 平台支持：
  • Android: SDK 21+
  • iOS: 10.0+

快速开始

要使用 hive_simple 插件，只需在 pubspec.yaml 文件中添加以下依赖项并运行 dart pub get：

dependencies:
  hive_simple: ^1.0.1

使用示例

下面是一个完整的示例代码，展示了如何在Flutter项目中使用 hive_simple 插件来初始化数据库、创建表、添加和获取数据。

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

void main() async {
  // 确保Flutter绑定已初始化
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化Hive数据库
  await DbMain.instance.dbInit();

  // 创建表（必须在使用之前创建）
  await DbMain.instance.createNewTable(["users", "products"]);

  // 运行应用
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Hive Simple Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Hive Simple Demo'),
    );
  }
}

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

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 用于存储输入的文本
  String textStringValue = "";

  // 用于存储从数据库中获取的数据
  List<dynamic> searchedData = [];

  // 标记是否正在搜索
  bool isSearching = false;

  // 添加数据到数据库
  Future<void> addItemToDatabase() async {
    if (textStringValue.isNotEmpty) {
      // 将数据添加到 "users" 表中
      await DbMain.instance.hiveAddItem(
        "users",
        {"name": textStringValue},
      );

      // 清空输入框
      setState(() {
        textStringValue = "";
      });

      // 重新获取数据
      await fetchItemsFromDatabase();
    }
  }

  // 从数据库中获取数据
  Future<void> fetchItemsFromDatabase() async {
    // 从 "users" 表中获取所有数据
    List<dynamic> data = await DbMain.instance.hiveGetItemList("users");

    // 更新状态
    setState(() {
      searchedData = data;
    });
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    // 在页面加载时获取数据
    fetchItemsFromDatabase();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.white,
        iconTheme: const IconThemeData(color: Colors.black),
        title: Text(widget.title, style: const TextStyle(color: Colors.black)),
        centerTitle: true,
        elevation: 2.5,
        actions: [
          InkWell(
            onTap: () {
              // 模拟点击事件
              print("List icon tapped");
            },
            child: Container(
              margin: const EdgeInsets.only(right: 10),
              child: const Icon(Icons.list_alt),
            ),
          ),
        ],
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            // 输入框
            TextField(
              onChanged: (value) {
                setState(() {
                  textStringValue = value;
                });
              },
              decoration: const InputDecoration(
                labelText: "Enter user name",
                border: OutlineInputBorder(),
              ),
            ),
            const SizedBox(height: 20),

            // 添加按钮
            ElevatedButton(
              onPressed: addItemToDatabase,
              child: const Text("Add User"),
            ),
            const SizedBox(height: 20),

            // 显示从数据库中获取的数据
            Expanded(
              child: ListView.builder(
                itemCount: searchedData.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text(searchedData[index]["name"]),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}