SharedPreferences的一种极简优雅且安全的用法
针对Android平台键值对的持久化存储，虽然Jetpack出了新的DataStore，但实际项目中SharedPreferences还是有大量使用，本文结合以前的使用经验给出一种极简且优雅且安全的实践。（示例项目见 https://gitee.com/spectre1225/neo-preference-demo）
1. SharedPreferences的使用与改进
SharedPreferences的基本读写代码如下：
preferences.edit().putInt("intKey", 1).apply();//写
preferences.getInt("intKey", 0);//读，0为默认值
代码中直接这么用的话，键会很不好管理，不清楚一个键值对到底有多少地方使用，当键发生改变需要修改的时候，也容易遗漏。于是就有了以下改进：
public interface XXXConfig{String KEY_PROPERTY_AA = "key_aa";String KEY_PROPERTY_BB = "key_bb";String KEY_PROPERTY_CC = "key_cc";//more key.......
}//使用的地方
preferences.edit().putInt(XXXConfig.KEY_PROPERTY_AA, 1).apply();//写
preferences.getInt(XXXConfig.KEY_PROPERTY_AA, 0);//读，0为默认值
但这样写仍然有问题，就是缺少值类型的约束：一个key对应的value，可能有很多种类型。这种情况下，需要额外的注释或文档来记录每一个key对应的value的类型信息。于是，有人想到可以像JavaBean一样，采用getter和setter方法的形式：
public class XXXConfig {private SharedPreferences preferences;private String KEY_PROPERTY_AA = "key_aa";private String KEY_PROPERTY_BB = "key_bb";//中间省略初始化......public int getPropertyAA() {return preferences.getInt(KEY_PROPERTY_AA, 0);}public void setPropertyAA(int value) {preferences.edit().putInt(KEY_PROPERTY_AA, value);}public int getPropertyBB() {return preferences.getInt(KEY_PROPERTY_BB, 0);}public void setPropertyBB(int value) {preferences.edit().putInt(KEY_PROPERTY_BB, value);}
}
这种写法改进了类型安全，但每次新增就需要写一个属性和两个方法，过程比较繁琐。理想情况，我还是希望像写文档一样只需要写下面这样的信息：
属性1：类型 int
属性2：类型 String
然后使用的地方可以直接取值。因此，就有了下面介绍的新的封装方法：暂且称为NeoPreference。
2. NeoPreference简单使用
首先，我们需要需要创建一个inferface来继承Config接口，这个新的接口对应一个SharedPreferences，默认接口名即为SharedPreferences的名称，例如：
public interface DemoConfig extends Config {}
这里的DemoConfig即为SharedPreferences的名称。有时候我们想要自己另外指定名称，则可以使用Config.Name注解：
@Config.Name("my_demo_config")
public interface DemoConfig extends Config {}
这个时候SharedPreferences名称就是my_demo_config。
然后我们就可以通过ConfigManager来获取DemoConfig的实例：
DemoConfig config = ConfigManager.getInstance().getConfig(DemoConfig.class);
到目前为止还没有什么新鲜的，接下来我们往里面添加新的配置项/属性：
@Config.Name("my_demo_config")
public interface DemoConfig extends Config {Property versionCode();
}
在上述基础上，只需要添加一行代码，就添加了新的键值对：key的值为versionCode，value的类型为Integer。然后我们的读写代码可以这么写：
DemoConfig config = ConfigManager.getInstance().getConfig(DemoConfig.class);
Integer versionCode = config.versionCode().get();//读
config.versionCode().set(versionCode + 1);//写
如果我们想要单独定key的名字，我们可以使用对应属性的注解：
@Config.Name("my_demo_config")
public interface DemoConfig extends Config {@IntItem(key = "my_version_code")Property versionCode();
}
我们还可以指定值的范围和默认值：
@Config.Name("my_demo_config")
public interface DemoConfig extends Config {@IntItem(key = "my_version_code"， start = 1, to = 10000, defaultValue = 1)Property versionCode();
}
这样，在值不符合规范的时候会抛出异常：
DemoConfig config = ConfigManager.getInstance().getConfig(DemoConfig.class);
config.versionCode().set(-1);//throw exeception
3. NeoPreference API说明
这个工具的API除了ConfigManager类以外主要分两部分：Property类以及类型对应的注解。
3.1 ConfigManager接口说明
ConfigManager是单例实现，维护一个SharedPreferences和Config的注册表，提供getConfig和addListener两个方法。
以下是getConfig方法签名：
public P getConfig(Class
pClass);
public
P getConfig(Class
pClass, int mode);
参数pClass是继承Config类的接口class，可选参数mode对应SharedPreferences的mode。
addListener的方法监听指定preferenceName中内容的变化，签名如下：
public void addListener(String preferenceName, WeakReference listenerRef);
public void addListener(LifecycleOwner lifecycleOwner, String preferenceName, Listener listener);
第一个方法接受一个Listener的弱引用，需要调用者自己持有监听器的引用，自己管理生命周期，否则可能被回收。第二个方法不采用弱引用参数，而是额外添加LifecycleOwner，这个监听器的声明周期采用LifecycleOwner对应的生命周期。
3.2 Property类接口说明
Property接口包括：
public final String getKey();//获取属性对应的key
public T get(T defValue); //获取属性值，defValue为默认值
public T get(); //获取属性值，采用缺省默认值
public void set(T value); //设置属性值
public Optional opt(); //以Optional的形式返回属性值
public final void addListener(WeakReference> listenerRef) //类似ConfigManager，不过只监听该属性的值变化
public final void addListener(LifecycleOwner owner, Listener listener)//类似ConfigManager，不过只监听该属性的值变化
泛型参数支持Long、Integer、Float、Boolean、String、Set等SharedPreferences支持的几种类型，以及额外的Serializable。
3.3 类型相关注解介绍
这些注解对应SharedPreferences支持的几种类型（其中description字段暂时不用）。
@interface StringItem {String key() default "";boolean supportEmpty() default true;String[] valueOf() default {};String defaultValue() default "";String description() default "";
}@interface BooleanItem {String key() default "";boolean defaultValue() default false;String description() default "";
}@interface IntItem {String key() default "";int defaultValue() default 0;int start() default Integer.MIN_VALUE;int to() default Integer.MAX_VALUE;int[] valueOf() default {};String description() default "";
}@interface LongItem {String key() default "";long defaultValue() default 0;long start() default Long.MIN_VALUE;long to() default Long.MAX_VALUE;long[] valueOf() default {};String description() default "";
}@interface FloatItem {String key() default "";float defaultValue() default 0;float start() default -Float.MIN_VALUE;float to() default Float.MAX_VALUE;float[] valueOf() default {};String description() default "";
}@interface StringSetItem {String key() default "";String[] valueOf() default {};String description() default "";
}@interface SerializableItem {String key() default "";Class type() default Object.class;String description() default "";
}
4. 完整实现
见：https://gitee.com/spectre1225/neo-preference-demo