【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:

@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 会构建一个Shared Preferences Helper 并且会得到一个相同名字外加一个下划线的类。然后你可以通过 @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();
}

( 四 ).preference key :   

    自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();
}

( 五 ). 作用域 :   

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

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

因此如果需要定义一个应用级别的preference,这样我们可以在应用中都共享这个preferences，那么我们需要进行如下定义：

@SharedPref(value=SharedPref.Scope.UNIQUE)
public interfaceMyPrefs {
...

( 六 ). 使用 PreferencesActi vity :  

    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整个开源快速开发框架项目~