(一).前言:
前面我们已经对于AndroidAnnotations使用Adapters和lists做了讲解,今天我们开始具体学习一下使用DI框架SharedPreferencesHelpers的使用,SharedPreferencesHelpers允许我们可以使用Android SharedPreferences.
FastDev4Android框架项目地址:https://github.com/jiangqqlmj/FastDev4Android
(二).定义preferences:
首先你需要使用创建一个@SharedPref注解的接口来进行定义SharedPreferences:
@SharedPref public interfaceMyPrefs { // The field name will have defaultvalue "John" @DefaultString("John") String name(); // The field age will have defaultvalue 42 @DefaultInt(42) int age(); // The field lastUpdated will havedefault value 0 long lastUpdated(); }
基于这个规范,AndroidAnnotations会构建一个SharedPreferencesHelper并且会得到一个相同名字外加一个下划线的类。然后你可以通过@Pref注解生成一个实例。
【注】字段的类型必须是编译生成的类,还不是源类。这仅仅是AndroidAnnotations上面是这个情况。
@EActivity public classMyActivity extends Activity { @Pref MyPrefs_ myPrefs; // ... }
你可以如下进行使用:
// Simple edit myPrefs.name().put("John"); // Batch edit myPrefs.edit() .name() .put("John") .age() .put(42) .apply(); // Preferenceclearing: myPrefs.clear(); // Check if a valueexists: boolean nameExists =myPrefs.name().exists(); // Reading a value long lastUpdated =myPrefs.lastUpdated().get(); // Reading a valueand providing a fallback default value long now =System.currentTimeMillis(); long lastUpdated =myPrefs.lastUpdated().getOr(now);
(三).默认资源值:
自AndroidAnnotations3.0起,现在我们可以使用@DefaultRes来从Android Resources中注入一个默认值:
@SharedPref public interfaceMyPrefs { @DefaultRes(R.string.defaultPrefName) String resourceName(); @DefaultRes // uses'R.string.defaultPrefAge' to set default value String defaultPrefAge(); }
(四).preferencekey:
自AndroidAnnotations3.1起,现在可以通过StringResource的id来作为preferencekey而不是方法的名称。这样但preferences是一个xml文件的时候,就可以使用stringresourcekeys.使用实例如下:
@SharedPref public interfaceMyPrefs { @DefaultString(value = "John",keyRes = R.string.myPrefKey) String name(); @DefaultRes(keyRes =R.string.myOtherPrefKey) String defaultPrefAge(); }
(五).作用域:
你可以通过设置下面值来控制访问权限:
因此如果需要定义一个应用级别的preference,这样我们可以在应用中都共享这个preferences,那么我们需要进行如下定义:
@SharedPref(value=SharedPref.Scope.UNIQUE) public interfaceMyPrefs { ...
(六).使用PreferencesActivity:
Android PreferenceActvitiy和PreferenceFragment可以进行编辑我们上面注解生成的preferences。
@SharedPref(SharedPref.Scope.UNIQUE) public interfaceMyPrefs { ... } public static StringPREF_NAME = "MyPrefs"; // in onCreate // Using yourMyPrefs values this.getPreferenceManager().setSharedPreferencesName(PREF_NAME); // Opening thelayout addPreferencesFromResource(R.xml.prefs);
到此位置关于AndroidAnnotations最佳实践SharedPreferences已经讲解完,同时FastDev4Android项目已经添加配置了AndroidAnnotations框架,后期的框架项目中也会主要使用这个DI框架,.欢迎大家去Github站点进行clone或者下载浏览:https://github.com/jiangqqlmj/FastDev4Android 同时欢迎大家star和fork整个开源快速开发框架项目~