AsyncStorage 和 react-native-storage 简单封装

AsyncStorage是一个简单的、异步的、持久化的Key-Value存储系统，它对于App来说是全局性的，具体详细api可查看链接，点击查看详细内容，本文主要是基于AsyncStorage 和 github(react-native-storage),做了一层简单的封装，使用起来相对来说更加方便一些；

具体文件内容如下：

import Storage from 'react-native-storage'
import { AsyncStorage } from 'react-native'

var storage = new Storage({
    // 最大容量，默认值1000条数据循环存储
    size: 1000,

    // 存储引擎：对于RN使用AsyncStorage，对于web使用window.localStorage
    // 如果不指定则数据只会保存在内存中，重启后即丢失
    storageBackend: AsyncStorage,

    // 数据过期时间，默认一整天（1000 * 3600 * 24 毫秒），设为null则永不过期
    defaultExpires: 1000 * 3600 * 24,

    // 读写时在内存中缓存数据。默认启用。
    enableCache: true,

    // 如果storage中没有相应数据，或数据已过期，
    // 则会调用相应的sync方法，无缝返回最新数据。
    // sync方法的具体说明会在后文提到
    // 你可以在构造函数这里就写好sync的方法
    // 或是在任何时候，直接对storage.sync进行赋值修改
    // 或是写到另一个文件里，这里require引入
    /* sync: require('你可以另外写一个文件专门处理sync')*/

})


var local = {
    /**
     * 设置缓存
     * @params key  必传 唯一标识
     * @params data  数据  type：string || object
     * @params expires 过期时间  不传默认永久  单位：ms
     * @params id  非必传 标识
     *
     * */
   set(key,data,expires,id){
        let setValue = JSON.stringify(data)
        if(id){
            storage.save({
                key:key,
                id:id,
                data:setValue,
                expires:expires ? expires:null
            })
        }else{
            storage.save({
                key:key,
                data:setValue,
                expires:expires ? expires:null
            })
        }

    },
    /**
     * 根据key 或者 key-id的到数据
     * @params key 必传
     * @params id  可为空
     *
     * */
    get(key,id){
        if(id){
            return storage.load({
                key:key,
                id:id
            }).then(ret =>{
                return JSON.parse(ret);
            }).catch(err => {
                /**
                 * 抛出错误
                 * 注释部分为抛出详细错误
                 * */
                throw err;
               /* switch (err.name) {
                    case 'NotFoundError':
                        throw err.message;
                        break;
                    case 'ExpiredError':
                        throw err.message;
                        break;
                    default:throw '未知错误'
                        break;
                }*/
            } )
        }else{
            return storage.load({
                key:key
            }).then(ret =>{
                return  JSON.parse(ret);
            }).catch(err => {
                /**
                 * 抛出错误
                 * 注释部分为抛出详细错误
                 * */
                throw err;
                /* switch (err.name) {
                     case 'NotFoundError':
                         throw err.message;
                         break;
                     case 'ExpiredError':
                         throw err.message;
                         break;
                     default:throw '未知错误'
                         break;
                 }*/
            })
        }

    },
        /**
         * 删除单个数据
         * key 必传
         * @params key 删除kay所对应的数据，必传
         *
         * @params id  删除id对应的数据 若删除的数据中有id，则必传
         */

    remove(key,id){
        if(id){
            storage.remove({
                key:key,
                id:id
            })
        }else{
            storage.remove({
                key:key
            })
        }
    },
    /**
     * 清空所有map，移除所有key-id数据（但会保留只有key的数据）
     * 测试 刷新之后有效，所以应该是在退出app时执行的
     * */
    clearMaps(){
        storage.clearMap();
    },
    /**
     * 清空某个key下的所有数据（仅key-id数据）
     * @paramas key
     * */
    clearMapForKey(key){
         storage.clearMapForKey(key)
    },
    /**
     * 获取key下的 所有数据(仅key-id数据)
     * */
    getAllDataForKey(key){
        return storage.getAllDataForKey(key).then(ret => {
            return ret
        })
    },
    /**
     * 获取某个key下的所有ID（仅key-id数据）
     * */
    getIdsForKey(key){
        return storage.getIdsForKey(key).then(ids => {
            return ids;
        })
    }
}



module.exports = local

定义该文件名为storage.js，

举例说明使用方式：

在使用缓存的页面将storage.js引入

例：import local from 'storage所在文件目录/storage' ，具体引入方式说明不再陈述，不了解的可以查一些文档或者看阮一峰ES6，

下面通过 设置缓存 和 获取缓存 简单说一下使用方式

1、设置缓存 参数说明

/**
 * 设置缓存
 * @params key  必传 唯一标识
 * @params data  数据  type：string || object
 * @params expires 过期时间  不传默认永久  单位：ms
 * @params id  非必传 标识
 *
 * */

运用：   local.set(key,data,expires,id)；

2、读取缓存 参数说明

/**
 * 根据key 或者 key-id的到数据
 * @params key 必传
 * @params id  可为空
 *
 * */

运用：     local.get(key,id).then(ret => {

                   console.log(ret)  //获取缓存结果

               }).catch(err => {

                   console.log(err) //抛出的错误

               })

其他使用说明不在一一介绍，原理大概相通。