kvwebsql
一个基于websql的kv数据库，支持增删查改，多数据库，多表，自定义序列化器，反序列化器等
Github地址：github.com/XiaoHuaShiF…
快速开始
Step 1 引入文件
拷贝kvwebsql.js到目录下，并导入
import KVWebSQL from './kvwebsql'
Step 2 创建表
第一个参数是数据库名，第二个参数是表名
const userTable = await KVWebSQL.buildDefaultKVWebSQL('testDb', 'user')
Step 3 增删查改
put：添加或修改数据
注：value默认使用JSON序列化器
await userTable.put('小红', {gender: '女', age: 18})
get：获取数据，若不存在返回null
await userTable.get('小红')
remove：删除数据
await userTable.remove('小红')
API
API都在KVWebSQL类上，一个KVWebSQL代表一个数据库的一个表
| api | 参数1类型 | 参数2类型 | 返回值类型 | 说明 |
|---|---|---|---|---|
| static async buildDefaultKVWebSQL(dbName, tableName) | String | String | KVWebSQL | 创建一个KVWebSQL，会自动初始化 |
| async put(key, value) | Object | Object | 设置值，不存在插入，存在则更新 | |
| async get(key) | Object | Object | 获取值，不存在返回null | |
| async remove(key) | Object | 移除值 | ||
| async containsKey(key) | Object | Boolean | 表是否包含key | |
| async clear() | 清空表 | |||
| async size() | Number | 获取表的记录数 | ||
| async keys() | Array | 获取全部key，返回Array集合 | ||
| async keySet() | Set | 获取全部key，返回Set集合 | ||
| async values() | Array | 获取全部value，返回Array集合 | ||
| async entries() | Array | 获取全部key-value，返回Array集合 | ||
| async map() | Map<Object, Object> | 获取全部key-value，返回Map集合 | ||
| async isEmpty() | Boolean | 表是否为空 | ||
| setKeySerializer(serializer) | Object => Object | 设置key序列化器 | ||
| setKeyDeserializer(deserializer) | Object => Object | 设置key反序列化器 | ||
| setValueSerializer(serializer) | Object => Object | 设置value序列化器 | ||
| setValueDeserializer(deserializer) | Object => Object | 设置value反序列化器 | ||
| getDbName() | String | 获取数据库名 | ||
| getTableName() | String | 表名 |
其他API，同样在KVWebSQL上，用于实现上面的API，有风险，若使用请谨慎
| api | 参数1类型 | 参数2类型 | 参数3类型 | 返回值类型 | 说明 |
|---|---|---|---|---|---|
| constructor(dbName, tableName) | String | String | KVWebSQL | 构造器，构造一个KVWebSQL，需要自行初始化 | |
| async init() | 初始化（通过new KVWebSQL()创建实例时需要调用） | ||||
| openDb() | 打开数据库，打开后可以对数据库进行操作 | ||||
| closeDb() | 关闭数据库，关闭后会释放资源，对数据库的操作将失败 | ||||
| isOpenDb() | Boolean | 数据库是否打开 | |||
| async createTable() | 创建表 | ||||
| async removeTable() | 删除表 | ||||
| checkDb() | 检查数据库是否正常 | ||||
| async transaction(sql, params, needRes) | String | Array | Boolean | SQLResultSetRowList | 执行事务的封装 |
