Flutter WebAssembly数据库交互插件surrealdb_wasm的使用

SurrealDB 是一个分布式数据库，而 surrealdb_wasm 是一个基于 WebAssembly (Wasm) 的插件，允许你在 Flutter Web 应用中与 SurrealDB 进行交互。以下是如何在 Flutter Web 项目中使用 surrealdb_wasm 插件的基本步骤。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  surrealdb_wasm: ^0.1.0  # 请确保使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化 SurrealDB

在你的 Flutter 代码中，首先需要初始化 SurrealDB 实例。通常，你可以在应用的 main 函数中或某个初始化方法中进行。

import 'package:surrealdb_wasm/surrealdb_wasm.dart';

Future<void> main() async {
  // 初始化 SurrealDB
  final db = SurrealDB();

  // 连接到数据库
  await db.connect('ws://localhost:8000/rpc');  // 替换为你的 SurrealDB 地址

  // 设置命名空间和数据库
  await db.use('namespace', 'database');

  runApp(MyApp(db: db));
}

class MyApp extends StatelessWidget {
  final SurrealDB db;

  const MyApp({Key? key, required this.db}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SurrealDB Flutter Demo',
      home: MyHomePage(db: db),
    );
  }
}

3. 与数据库交互

在 MyHomePage 中，你可以使用 SurrealDB 实例来执行查询、插入、更新和删除操作。

class MyHomePage extends StatefulWidget {
  final SurrealDB db;

  const MyHomePage({Key? key, required this.db}) : super(key: key);

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

class _MyHomePageState extends State<MyHomePage> {
  List<dynamic> records = [];

  @override
  void initState() {
    super.initState();
    fetchData();
  }

  Future<void> fetchData() async {
    // 查询数据
    final result = await widget.db.query('SELECT * FROM table_name');
    setState(() {
      records = result;
    });
  }

  Future<void> insertData() async {
    // 插入数据
    await widget.db.create('table_name', {
      'name': 'John Doe',
      'age': 30,
    });
    fetchData();  // 刷新数据
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SurrealDB Flutter Demo'),
      ),
      body: ListView.builder(
        itemCount: records.length,
        itemBuilder: (context, index) {
          final record = records[index];
          return ListTile(
            title: Text(record['name']),
            subtitle: Text('Age: ${record['age']}'),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: insertData,
        child: Icon(Icons.add),
      ),
    );
  }
}

4. 运行应用

确保你已经启动了 SurrealDB 服务器，并且可以通过 WebSocket 连接到它。然后运行你的 Flutter Web 应用：

flutter run -d chrome

5. 注意事项

• WebAssembly 支持: surrealdb_wasm 依赖于 WebAssembly，因此只能在 Flutter Web 项目中使用。
• CORS 问题: 如果你在开发环境中遇到 CORS 问题，确保 SurrealDB 服务器配置了正确的 CORS 头。
• 安全性: 在生产环境中，确保数据库连接是安全的（例如使用 wss:// 而不是 ws://）。

6. 其他操作

除了查询和插入，你还可以使用 surrealdb_wasm 执行其他操作，如更新和删除：

// 更新数据
await widget.db.update('table_name:id', {
  'age': 31,
});

// 删除数据
await widget.db.delete('table_name:id');