Flutter의 Hive 사용법

Hive는 Flutter 애플리케이션에서 사용할 수 있는 경량의 키-값 데이터베이스입니다. Hive는 빠르고 사용하기 쉬우며, NoSQL 데이터베이스로 스키마 없이 데이터를 저장할 수 있습니다. 이번 글에서는 Flutter에서 Hive를 사용하는 방법과 이를 구현하는 예제를 자세히 살펴보겠습니다.

1. Hive 패키지 설치

Flutter 애플리케이션에서 Hive를 사용하기 위해 hive와 hive_flutter 패키지를 설치합니다. pubspec.yaml 파일에 다음 의존성을 추가합니다.

dependencies:
  flutter:
    sdk: flutter
  hive: ^2.0.4
  hive_flutter: ^1.1.0
  path_provider: ^2.0.6

 

그리고 pub get 명령어를 실행하여 패키지를 설치합니다.

2. Hive 초기화

Hive를 사용하려면 애플리케이션을 초기화하고, 필요한 어댑터를 등록해야 합니다. main.dart 파일을 다음과 같이 수정합니다.

 

import 'package:flutter/material.dart';
import 'package:hive/hive.dart';
import 'package:hive_flutter/hive_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Hive.initFlutter();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HiveExample(),
    );
  }
}

 

위 코드는 Hive를 초기화하고, Flutter와 함께 사용할 수 있도록 설정합니다.

3. Box 열기

Hive에서 데이터를 저장하려면 Box를 열어야 합니다. Box는 Hive에서 데이터를 저장하는 컨테이너입니다. 다음은 Box를 여는 예제입니다.

class HiveExample extends StatefulWidget {
  @override
  _HiveExampleState createState() => _HiveExampleState();
}

class _HiveExampleState extends State<HiveExample> {
  late Box box;

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

  Future<void> _openBox() async {
    box = await Hive.openBox('myBox');
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    if (!box.isOpen) {
      return Scaffold(
        appBar: AppBar(
          title: Text('Hive Example'),
        ),
        body: Center(
          child: CircularProgressIndicator(),
        ),
      );
    }

    return Scaffold(
      appBar: AppBar(
        title: Text('Hive Example'),
      ),
      body: Column(
        children: <Widget>[
          TextField(
            onSubmitted: (value) {
              _addItem(value);
            },
            decoration: InputDecoration(labelText: 'Enter item'),
          ),
          Expanded(
            child: ValueListenableBuilder(
              valueListenable: box.listenable(),
              builder: (context, Box box, _) {
                final items = box.values.toList();
                return ListView.builder(
                  itemCount: items.length,
                  itemBuilder: (context, index) {
                    return ListTile(
                      title: Text(items[index]),
                      trailing: IconButton(
                        icon: Icon(Icons.delete),
                        onPressed: () {
                          _deleteItem(index);
                        },
                      ),
                    );
                  },
                );
              },
            ),
          ),
        ],
      ),
    );
  }

  void _addItem(String item) {
    box.add(item);
    setState(() {});
  }

  void _deleteItem(int index) {
    box.deleteAt(index);
    setState(() {});
  }
}

 

위 코드는 Box를 열고 데이터를 추가, 삭제하는 예제입니다. ValueListenableBuilder를 사용하여 Box의 상태 변화를 감지하고, 리스트를 업데이트합니다.

 

 

반응형

 

 

4. 데이터 삽입

Box에 데이터를 삽입하려면 add 메서드를 사용합니다. 위 예제에서는 _addItem 메서드를 통해 데이터를 삽입합니다.

void _addItem(String item) {
  box.add(item);
  setState(() {});
}

 

add 메서드는 Box에 데이터를 추가합니다. 데이터를 추가한 후 setState를 호출하여 UI를 업데이트합니다.

5. 데이터 조회

Box의 데이터를 조회하려면 values 속성을 사용합니다. ValueListenableBuilder를 사용하여 Box의 상태 변화를 실시간으로 감지하고 UI를 업데이트할 수 있습니다.

 

Expanded(
  child: ValueListenableBuilder(
    valueListenable: box.listenable(),
    builder: (context, Box box, _) {
      final items = box.values.toList();
      return ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(items[index]),
            trailing: IconButton(
              icon: Icon(Icons.delete),
              onPressed: () {
                _deleteItem(index);
              },
            ),
          );
        },
      );
    },
  ),
),

 

ValueListenableBuilder는 Box의 상태가 변경될 때마다 리스트를 다시 빌드합니다.

6. 데이터 삭제

Box에서 데이터를 삭제하려면 deleteAt 메서드를 사용합니다. 위 예제에서는 _deleteItem 메서드를 통해 데이터를 삭제합니다.

void _deleteItem(int index) {
  box.deleteAt(index);
  setState(() {});
}

deleteAt 메서드는 지정된 인덱스의 데이터를 삭제합니다. 데이터를 삭제한 후 setState를 호출하여 UI를 업데이트합니다.

결론

Flutter 애플리케이션에서 Hive를 사용하면 데이터를 영구적으로 저장하고 관리할 수 있습니다. Hive는 경량의 키-값 데이터베이스로, 빠르고 사용하기 쉬우며, NoSQL 데이터베이스로 스키마 없이 데이터를 저장할 수 있습니다. 이번 글에서 소개한 방법들을 활용하여 Flutter 애플리케이션에서 Hive를 효율적으로 사용해보세요. Hive를 통해 애플리케이션의 기능을 확장하고, 사용자 경험을 향상시킬 수 있습니다.