Flutter数据库管理插件quickpocketbase的使用

开始使用

在开始使用 quickpocketbase 插件之前，确保您已经完成了以下步骤：

在您的 Flutter 项目中添加 quickpocketbase 依赖。
确保您的设备或模拟器已安装并运行。
准备好一个可用的 PocketBase 后端服务。

在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  pocketbase: ^0.1.0

然后执行以下命令以更新依赖项：

flutter pub get

使用示例

以下是一个简单的示例，展示如何使用 quickpocketbase 插件连接到 PocketBase 数据库并执行基本操作。

示例代码

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

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

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

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() async {
    // 创建 PocketBase 客户端实例
    PocketBase pb = PocketBase("https://your-pocketbase-instance-url");

    try {
      // 获取所有记录
      var records = await pb.collection('your-collection-name').getFullList();

      // 打印记录数量
      print('Total Records: ${records.length}');
    } on PocketBaseException catch (e) {
      // 捕获异常并打印错误信息
      print('Error: ${e.message}');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
            ElevatedButton(
              onPressed: _incrementCounter,
              child: const Text('Fetch Records'),
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {},
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

代码说明

PocketBase 客户端初始化：
```
PocketBase pb = PocketBase("https://your-pocketbase-instance-url");
```
这里创建了一个 PocketBase 客户端实例，并传入了 PocketBase 后端的服务地址。
获取记录：
```
var records = await pb.collection('your-collection-name').getFullList();
```
使用 getFullList() 方法从指定集合中获取所有记录，并将其存储在 records 变量中。
处理异常：
```
on PocketBaseException catch (e) {
  print('Error: ${e.message}');
}
```
如果请求过程中发生错误，捕获异常并打印错误信息。

UI 部分：

ElevatedButton(
  onPressed: _incrementCounter,
  child: const Text('Fetch Records'),
)

yibo5220 1楼

更多关于Flutter数据库管理插件quickpocketbase的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

quickpocketbase 是一个用于在 Flutter 应用中与 PocketBase 后端进行交互的插件。PocketBase 是一个开源的、自托管的后端服务，提供了数据库、身份验证、文件存储等功能。quickpocketbase 插件简化了与 PocketBase 的交互，使得在 Flutter 应用中集成 PocketBase 变得更加容易。

安装 `quickpocketbase`

首先，你需要在 pubspec.yaml 文件中添加 quickpocketbase 依赖：

dependencies:
  flutter:
    sdk: flutter
  quickpocketbase: ^0.0.1  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

初始化 `quickpocketbase`

在使用 quickpocketbase 之前，你需要初始化它。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 PocketBase
  await QuickPocketBase.init(
    baseUrl: 'https://your-pocketbase-instance.com', // 你的 PocketBase 实例地址
  );

  runApp(MyApp());
}

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

使用 `quickpocketbase` 进行 CRUD 操作

1. 查询数据

你可以使用 QuickPocketBase 来查询 PocketBase 中的数据。例如，查询某个集合中的所有记录：

import 'package:quickpocketbase/quickpocketbase.dart';

Future<void> fetchRecords() async {
  try {
    final response = await QuickPocketBase.instance.collection('your_collection_name').get();
    print(response.items); // 打印查询到的记录
  } catch (e) {
    print('Error fetching records: $e');
  }
}

2. 插入数据

你可以使用 create 方法来插入新记录：

Future<void> insertRecord() async {
  try {
    final record = await QuickPocketBase.instance.collection('your_collection_name').create(
      body: {
        'field1': 'value1',
        'field2': 'value2',
      },
    );
    print('Record inserted: $record');
  } catch (e) {
    print('Error inserting record: $e');
  }
}

3. 更新数据

你可以使用 update 方法来更新现有记录：

Future<void> updateRecord(String recordId) async {
  try {
    final record = await QuickPocketBase.instance.collection('your_collection_name').update(
      id: recordId,
      body: {
        'field1': 'new_value1',
        'field2': 'new_value2',
      },
    );
    print('Record updated: $record');
  } catch (e) {
    print('Error updating record: $e');
  }
}

4. 删除数据

你可以使用 delete 方法来删除记录：

Future<void> deleteRecord(String recordId) async {
  try {
    await QuickPocketBase.instance.collection('your_collection_name').delete(id: recordId);
    print('Record deleted');
  } catch (e) {
    print('Error deleting record: $e');
  }
}

身份验证

quickpocketbase 还支持身份验证功能。你可以使用它来进行用户注册、登录等操作。

1. 用户注册

Future<void> registerUser() async {
  try {
    final user = await QuickPocketBase.instance.auth.register(
      email: 'user@example.com',
      password: 'password123',
    );
    print('User registered: $user');
  } catch (e) {
    print('Error registering user: $e');
  }
}

2. 用户登录

Future<void> loginUser() async {
  try {
    final user = await QuickPocketBase.instance.auth.login(
      email: 'user@example.com',
      password: 'password123',
    );
    print('User logged in: $user');
  } catch (e) {
    print('Error logging in: $e');
  }
}

3. 获取当前用户

Future<void> getCurrentUser() async {
  try {
    final user = await QuickPocketBase.instance.auth.currentUser();
    print('Current user: $user');
  } catch (e) {
    print('Error getting current user: $e');
  }
}