针对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