【FastDev4Android框架开发】AndroidAnnnotations注入框架使用之最佳实践SharedPreferences(十七)

转载请标明出处： 

http://blog.csdn.net/developer_jiangqq/article/details/49583487
本文出自:【江清清的博客】

(一).前言:   

      前面我们已经对于AndroidAnnotations使用Adapters和lists做了讲解，今天我们开始具体学习一下使用DI框架SharedPreferencesHelpers的使用，SharedPreferencesHelpers允许我们可以使用Android SharedPreferences.

      FastDev4Android框架项目地址:https://github.com/jiangqqlmj/FastDev4Android 

(二).定义preferences:   

       首先你需要使用创建一个@SharedPref注解的接口来进行定义SharedPreferences:

@SharedPrefpublic 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上面是这个情况。

@EActivitypublic classMyActivity extends Activity {     @Pref    MyPrefs_ myPrefs;     // ... }

你可以如下进行使用:

// Simple editmyPrefs.name().put("John"); // Batch editmyPrefs.edit()  .name()  .put("John")  .age()  .put(42)  .apply(); // Preferenceclearing:myPrefs.clear(); // Check if a valueexists:boolean nameExists =myPrefs.name().exists(); // Reading a valuelong lastUpdated =myPrefs.lastUpdated().get(); // Reading a valueand providing a fallback default valuelong now =System.currentTimeMillis();long lastUpdated =myPrefs.lastUpdated().getOr(now);

(三).默认资源值:   

      自AndroidAnnotations3.0起,现在我们可以使用@DefaultRes来从Android Resources中注入一个默认值:

@SharedPrefpublic 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.使用实例如下:

@SharedPrefpublic interfaceMyPrefs {    @DefaultString(value = "John",keyRes = R.string.myPrefKey)    String name();     @DefaultRes(keyRes =R.string.myOtherPrefKey)    String defaultPrefAge();}

(五).作用域:   

       你可以通过设置下面值来控制访问权限:

• ACTIVITY.使用MyActivity_MyPrefs命名共享preference
• ACTIVITY_DEFAULT，默认权限MyActivity进行命名，Activity级别权限(可以通过activity.getPreferences()进行获取)
• APPLICATION_DEFAULT,应用级别默认SharedPreference或者UNIQUE，使用MyPrefs命名。

因此如果需要定义一个应用级别的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 valuesthis.getPreferenceManager().setSharedPreferencesName(PREF_NAME); // Opening thelayoutaddPreferencesFromResource(R.xml.prefs);

 

     到此位置关于AndroidAnnotations最佳实践SharedPreferences已经讲解完，同时FastDev4Android项目已经添加配置了AndroidAnnotations框架，后期的框架项目中也会主要使用这个DI框架，.欢迎大家去Github站点进行clone或者下载浏览:https://github.com/jiangqqlmj/FastDev4Android 同时欢迎大家star和fork整个开源快速开发框架项目~