Android Open Source - MorseFlash Preference Utils

• Back to App/code  ↑

From Project

Back to project page MorseFlash.

License

The source code is released under:

Apache License

Java Source Code

/*
 * Copyright 2014 Jason J./*from  ww w. j  av a2s. co m*/
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.ovrhere.android.morseflash.prefs;

import com.ovrhere.android.morseflash.R;

import android.content.Context;
import android.content.SharedPreferences;
import android.content.res.Resources;

/**
 * Preference Utility for handling the preferences and the preference container.
 * Has ability to set defaults.
 * @author Jason J.
 * @version 0.2.0-20140606
 */
public class PreferenceUtils {
  /* The class name. */
  //final static private String CLASS_NAME = PreferenceUtils.class.getSimpleName();  
  /** The key for the first run/preferences set pref. */
  final static protected String KEY_PREFERENCES_SET = "com.ovrhere.morseflash.KEY_FIRST_RUN";
  /** The pref value for the first run/preferences set . 
   * @see {@link #KEY_PREFERENCES_SET} */
  final static protected boolean VALUE_PREFERENCES_SET   = true;
  
  /** Used to determine if the preferences have been set to default or if this
   * the first run.
   * @param context The current context.
   * @return <code>true</code> if the first run, <code>false</code> otherwise.
   */
  static public boolean isFirstRun(Context context){
    SharedPreferences prefs = getPreferences(context);
    //if the default value not set, then true.
    return (prefs.getBoolean(KEY_PREFERENCES_SET, !VALUE_PREFERENCES_SET) 
        == !VALUE_PREFERENCES_SET);
  }
  
  /** Returns the {@link SharedPreferences} file  using private mode. 
   * @param context The current context to be used. */
  static public SharedPreferences getPreferences(Context context){
    /* This is safe as SharedPreferences is a shared instance for the application
     * and thus will not leak.     */
    context = context.getApplicationContext();
    return context.getSharedPreferences(
        context.getResources().getString(R.string.com_ovrhere_morseflash_PREFERENCE_FILE_KEY), 
        Context.MODE_PRIVATE); 
  }
  
  /** Sets the application's preferences using the default values. 
   * @param context The current context to be used. 
   * @see res/values/preferences_info.xml */
  static public void setToDefault(Context context){
    SharedPreferences.Editor prefs = getPreferences(context).edit();
    Resources r = context.getResources();    
    _setDefaults(r, prefs);    
    prefs.commit();
  }
  
  /////////////////////////////////////////////////////////////////////////////////////////////////
  /// Utility functions
  ////////////////////////////////////////////////////////////////////////////////////////////////
  /** Sets defaults. Does not commit.
   * @param r The {@link Resources} manager to use getting strings from 
   * res/values/preferences_info.xml
   * @param prefEdit The {@link SharedPreferences} editor to use to commit. */
  static private void _setDefaults(Resources r, SharedPreferences.Editor prefEdit){
    //Thought: Consider using parallel arrays in res to respect open-close?
    
    prefEdit.putBoolean(
        r.getString(R.string.com_ovrhere_morseflash_pref_KEY_LOOP_MESSAGE),
        r.getBoolean(R.bool.com_ovrhere_morseflash_pref_VALUE_LOOP_MESSAGE)
        );
    prefEdit.putBoolean(
        r.getString(R.string.com_ovrhere_morseflash_pref_KEY_USE_CAMERA_FLASH),
        r.getBoolean(R.bool.com_ovrhere_morseflash_pref_VALUE_USE_CAMERA_FLASH)
        );
    //first run has completed.
    prefEdit.putBoolean(KEY_PREFERENCES_SET, VALUE_PREFERENCES_SET);
  }    
}

Java Source Code List

• Back to App/code  ↑