hive_local_storage 1.0.5

A cache helper which uses hive and flutter_secure_storage to make ease to store session and encrypted data

hive_local_storage

---

A utility package to storage user session and cache values in hive box

• uses hive for caching
• uses flutter_secure_storage to storage encryption key of secured hive box for session storage

Get Started

dependencies:
  hive_local_storage: latest

if you want to use custom class for hive you need to add hive_generator in your dev_dependencies

dev_dependencies:
  build_runner: latest
  hive_generator: latest

Usage

  import 'package:hive_local_storage/hive_local_storage.dart';

Registering Custom Adapters

NOTE: avoid using typeId=0 for data classes because typeId=0 is already used by session class.

  final localStorage = await LocalStorage.getInstance(registerAdapters:(){
    Hive..registerAdapter(adapter1)..registerAdapter(adapter2);
  });

Opening Custom Boxes

This is useful when you want to store hive objects directly to use this method you need to register adapter for hive objects in initialization

    /// typeId must between 1-223
    @HiveType(typeId:1,adapterName:'TestAdapter')
    class TestModel extends HiveObject{
  
        @HiveField(0)
        late String firstName;
        
        /// rest of fields
    }

    final localStorage = await LocalStorage.getInstance([TestAdapter()]);
    await localStorage.openCustomBox<TestModel>(boxName:'__TEST_BOX__',typeId:1)

Read From Custom Box

   final localStorage = await LocalStorage.getInstance();
   List<TestModel> data = localStorage.getCustomList<TestModel>(boxName:'__TEST_BOX__');

Write data to Custom Box

   final localStorage = await LocalStorage.getInstance();
    void storeData() async {
      /// store single data
      final testModel = TestModel();
      await localStorage.add<TestModel>(boxName: '__TEST_BOX__',value:testModel);
      
      /// store multipleData
      final listData = <TestModel>[TestModel(),TestModel()];
      await localStorage.addAll<TestModel>(boxName: '__TEST_BOX__',values:listData);
    }

delete data from Custom Box : [ Experimental ]

   final localStorage = await LocalStorage.getInstance();
    void deleteData(TestModel test) async {
      await localStorage.delete<TestModel>(boxName: '__TEST_BOX__',value:testModel);
    }

update data to Custom Box : [ Experimental ]

   final localStorage = await LocalStorage.getInstance();
    void updateData(TestModel test) async {
      await localStorage.update<TestModel>(boxName: '__TEST_BOX__',value:testModel);
    }

To use with Riverpod

/// create provider
final localStorageProvider = Provider<LocalStorage>((ref)=>throw UnImplementedError());

/// in main function

void main() {
  runZonedGuarded(
    () async {
      final localStorage = await LocalStorage.getInstance();
      runApp(
        ProviderScope(
          overrides: [
            localStorageProvider.overrideWithValue(localStorage),
          ],
          child: App(),
        ),
      );
    },
    (e, _) => throw e,
  );
}

Write data

   /// initialize local_storage
final localStorage = await LocalStorage.getInstance();

// to store value in cache box
await localStorage.put<int>(key:'count',value:0);


// write multiple values in cache box
await localStorage.putAll(Map<String, dynamic> entries);

// put list of data in cache box
await localStorage.putList<Model>(key:'KeyName',value:<Model>[]);


// to store use session
final session = Session()
  ..accessToken = 'accessToken'
  ..refreshToken = 'refreshToken';
  
await localStorage.saveSession(session);

Read data

   /// initialize local_storage
final localStorage = await LocalStorage.getInstance();

// to get value from cache box
final count =  localStorage.get<int>(key:'count');


// watch value changed on key
localStorage.watchKey(key:'key').listen((value){
  //TODO: do your work
});

// read list data from cache box
final listData = localStorage.getList<Model>(key:'Your KeyName');

// to get session
final Session? session = localStorage.getSession();

// to listen on session changes
localStorage.onSessionChange.listen((session){
  // do your work
});

//to check whether session has present or not
final hasSession = localStorage.hasSession;

//to check whether accessToken is expired or not
final isTokenExpired = locaStorage.isTokenExpired;

Delete data

   /// initialize local_storage
final localStorage = await LocalStorage.getInstance();

// remove value from cache box
await localStorage.remove(key:'count');

// remove all from cache box
await localStorage.clear();

// remove session
await localStorage.clearSession();