README.md · NNN小德/MXKeyValue

# MXKeyValue
## 介绍
基于Sqlite的，支持加密、自定义加密方式的KV数据库
[![](https://jitpack.io/v/zhangmengxiong/MXKeyValue.svg)](https://jitpack.io/#zhangmengxiong/MXKeyValue)

库引用： 替换1.3.1 为最新版本
```gradle
    implementation 'com.gitee.zhangmengxiong:MXKeyValue:1.3.1'
```

## 使用方法

```kotlin
val KV = MXKeyValue.Builder("kvdb_kv_v1")
             .setCrypt(KVAESCrypt("27e2125d0a11a9aa65b9c9773673bc2a"))
             .setStore(KVSqliteStore())
             .build(MyApp.appContext)

// 清理所有KV
KV.cleanAll()

// 获取所有KV
KV.getAll()

// 清理失效的KeyValue
KV.cleanExpire()

// 设置KV
KV.set(key, value)

// 设置KV的有效期 1分钟 后失效
KV.set(key, value, 1.toDuration(DurationUnit.MINUTES))

// 获取Value
KV.get("test_expire_key")

// 获取Value ，如果不存在则返回默认值
KV.get("test_expire_key", default = "默认值")

// 删除key
KV.delete("test_expire_key")

// 从SharedPreferences拷贝所有数据
KV.cloneFromSharedPreferences("sp_name")
```

## 加密相关
MXKeyValue内置两种加密方式：
- KVNoCrypt()
- KVAESCrypt("加密字符")

### MXNoSecret
KVNoCrypt = 不加密，存储Value=设置的Value

### MXAESSecret
KVAESCrypt = AES对称加密
- 存储的value=encrypt(设置的Value)
- 读取的Value=decrypt(存储的Value)

注意：KVAESCrypt初始化的加密字符在app上线后不能修改，否则会导致数据读取错误！

### 自定义加密方式
- 需要实现IMXCrypt接口
- generalSalt() = 生成当条记录的混淆字段
- encrypt方法 = 源数据Value->存储Value
- decrypt方法 = 存储Value->源数据Value
```kotlin
class MyCrypt : IKVCrypt {
    private val divider = "$$$$$$$$$$$$"
    override fun generalSalt(): String {
        return UUID.randomUUID().toString().replace("-", "")
    }

override fun encrypt(key: String, value: String, salt: String): String? {
        return "$key$divider$value"
    }

override fun decrypt(key: String, secretValue: String, salt: String): String? {
        return secretValue.split(divider).lastOrNull()
    }
}
```
使用方法：
```kotlin
val KV = MXKeyValue.Builder(MyApp.appContext, "kvdb_kv_v1")
             .setCrypt(MyCrypt())
             .setStore(KVSqliteStore())
             .build()
```

NNN小德/MXKeyValue

简介

发行版 (4)

贡献者

语言

近期动态

NNN小德/MXKeyValue .gitee-modal { width: 500px !important; }

简介

发行版 (4)

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

语言

近期动态

搜索帮助

NNN小德/MXKeyValue