DoKV 是一个小巧而强大的 Key-Value 管理框架（dokV在哪里玩）

DoKV 是一个小巧而强大的 Key-Value 管理框架（dokV在哪里玩）

DoKV

DoKV 是一个小巧而强大的 Key-Value 管理框架，其设计初衷是为了解决 Android 平台下各种繁琐且丑陋的配置类代码

（如果你是从我的博客：Android APT 实例讲解 跳转过来的，那需要切换到 master 分支，对应的是第二次的提交记录）

Download

dependencies { implementation 'leavesc.hello:dokv:0.1.8' annotationProcessor 'leavesc.hello:dokv-compiler:0.1.8'}

如果不想自定义序列化方案，则可以使用我的另一个开源实现

dependencies { implementation 'leavesc.hello:dokv-impl:0.1.8'}

更新日记：CHANGELOG

一、介绍

之所以说强大，是因为通过使用 DoKV 后，你基本是可以抛弃如下类型的代码了

SharedPreferences sharedPreferences = getSharedPreferences("SharedPreferencesName", Context.MODE_PRIVATE); SharedPreferences.Editor editor = sharedPreferences.edit(); editor.putString("IP", "192.168.0.1"); editor.commit(); String userName = sharedPreferences.getString("userName", ""); String ip = sharedPreferences.getString("IP", "");

通常，我们的应用都会有很多配置项需要进行缓存，比如用户信息、设置项开关、服务器IP地址等。如果采用原生的 SharedPreferences 来实现的话，则很容易就写出如上所示那样丑陋的代码，不仅需要维护多个数据项的 key 值，而且每次存入和取出数据时都会有一大片重复的代码，不易维护

那 DoKV 的表现如何呢？

很简单！！！

假设你的应用包含了一个 User 类用于缓存用户信息，首先，为该类加上一个注解：@DoKV

/** * 作者：leavesC * 时间：2019/03/17 0:12 * 描述： * GitHub：https://github.com/leavesC * Blog：https://jianshu.com/u/9df45b87cfdf */@DoKVpublic class User { private String name; private int age; private String sex; private Book book; private List stringList; ···}

build 下工程，DoKV 就会自动为你生成一个以 类名+DoKV结尾 的 Java 类（UserDoKV），之后你就可以通过以下这种形式来进行数据存取了，而你无需关心其内部是如何保存的（当然，其内部的缓存机制是可以由你来自定义的）

//缓存整个对象 User user = new User(); user.setAge(24); user.setName("leavesC"); UserDoKV.get().setUser(user); //获取缓存的对象 User user1 = UserDoKV.get().getUser(); //更新本地已缓存的数据的某个设置项 //如果之前没有缓存过，则会自动 new 一个对象并自动赋值 //因为 DoKV 要求注解类必须包含一个无参构造函数，并且包含的字段有对应的 Get 和 Set 方法 UserDoKV.get().setName("leavesCZY"); UserDoKV.get().setAge(28); //移除缓存数据 UserDoKV.get().remove(); //移除所有缓存数据 DoKV.clear();

上文说过，DoKV 是依赖于 APT 技术的，其实际原理就是开发者通过继承 AbstractProcessor 来定义目标代码的生成规则，由编译器根据此规则来生成目标代码，所以 DoKv 的执行效率就如同构造一般的 Java 类，不存在什么依靠反射使性能降低的情况

UserDoKV 类的定义如下所示：

public class UserDoKV extends User { private static final String KEY = "leavesc.hello.dokv.model.UserDoKV"; private UserDoKV() { } public static UserDoKV get() { return new UserDoKV(); } private IDoKVHolder getDoKVHolder() { return DoKV.getInstance().getDoKVHolder(); } private String serialize(String _KEY, User _User) { return getDoKVHolder().serialize(_KEY, _User); } private User deserialize(String _KEY) { return getDoKVHolder().deserialize(_KEY, User.class); } public User getUser() { return deserialize(KEY); } private User getUserNotNull() { User variable = deserialize(KEY); if (variable != null) { return variable; } return new User(); } public String setUser(User instance) { if (instance == null) { remove(); return ""; } return serialize(KEY, instance); } public void remove() { getDoKVHolder().remove(KEY); } @Override public String getName() { User variable = getUser(); if (variable != null) { return variable.getName(); } return super.getName(); } @Override public void setName(String _name) { User _user = getUserNotNull(); _user.setName(_name); serialize(KEY, _user); } //省略类似的 Get/Set 方法}

二、自定义缓存 Key

在 v0.1.7 版本之前， DoKV 默认以被注解类的类路径作为缓存 Key，以此来保证 Key 值的唯一性，但考虑到被注解类在后续开发中可能会被移动到其它包下从而导致丢失缓存数据，因为在 v0.1.7 版本中为注解 DoKV 新增了 Key 属性，如果开发者向该属性赋予了值，则以该值作为缓存 Key，而且该 Key 的唯一性需要由开发者自己来保证

@DoKV(key = "CustomKeyUser_Key")public class CustomKeyUser { ···}

public class CustomKeyUserDoKV extends CustomKeyUser { private static final String KEY = "CustomKeyUser_Key"; ```}

三、引入

为了获得更高的自由度， DoKV 默认将数据持久化的实现方案交由外部来实现，即由使用者来决定如何将对象序列化保存到本地，此时你就可以选择只依赖以下两个引用

dependencies { implementation 'leavesc.hello:dokv:xxx' annotationProcessor 'leavesc.hello:dokv-compiler:xxx'}

然后，外部将 IDoKVHolder 实例传给 DoKV 即可

DoKV.init(new IDoKVHolder() { //序列化 @Override public String serialize(String key, Object src) { return null; } //反序列化 @Override public T deserialize(String key, Class classOfT) { return null; } //移除指定对象 @Override public void remove(String key) { } //删除全局的缓存数据 @Override public void clear() { } });

如果你不想自己实现 IDoKVHolder ，DoKV 也提供了一个默认实现，此时你就只要多引用如下一个依赖即可，其内部是通过 Gson + MMKV 来实现序列化方案

dependencies { implementation 'leavesc.hello:dokv-impl:xxx'}

进行初始化，之后就可以自由地玩耍了

DoKV.init(new MMKVDoKVHolder(Context));

四、结尾

本开源库的 GitHub 主页在这里：DoKV

APK -体检：DoKV

我的博客主页：leavesC

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。