PowerPreference

Additional

Language
Java
Version
2.0.0 (Aug 25, 2019)
Created
Dec 6, 2018
Updated
Aug 28, 2019
Owner
Ali Asadi (AliAsadi)
Contributor
Ali Asadi (AliAsadi)
1
Activity
Badge
Generate
Download
Source code
APK file

Advertisement

Power Preference

A Powerful library to control and simplify the usage of shared preference in Android.

Download

implementation 'com.aliassadi:power-preference-lib:2.0.0'

Getting started

Initialize the library in your Application.onCreate() method:

PowerPreference.init(this);

To accsess preference file there is two option:

  1. Default file.
Preference preference = PowerPreference.getDefaultFile();
  1. Specefic file.
Preference preference = PowerPreference.getFileByName("preferenceName");

Save Data - Asynchronous(PUT)

To write data to preference file asynchronous.

  1. Insert single value
PowerPreference.getDefaultFile().putString("key",value);
  1. Insert multiple values
PowerPreference.getDefaultFile()
        .putString("key", value)
        .putObject("key", value)
              .
              .
        .putMap("key", value);

Put will asynchronously save the preferences without holding the current thread.

The library support the default implementation of shared preference such as putBoolean() and putString().

Note:

You can write any type of data Integer, Long, Float, Double, String, ArrayList, Map, Object

Save Data - Synchronous(SET)

To write data to preference file synchronous.

Set will synchronously save the preference while holding the current thread until done and returning a success flag.

boolean result = PowerPreference.getDefaultFile().setString("key",value);

You can also call set with the type such as setBoolean() and setObject().

Read Data

To retrieve values from a preference file, call methods such as getInt() and getString(),

  1. String
String value = PowerPreference.getDefaultFile().getString("key", defValue);
  1. Object
Object value = PowerPreference.getDefaultFile().getObject("key", Object.class, defValue);
  1. Array
ArrayList<Object> value = PowerPreference.getDefaultFile().getObject("key", Object[].class, defValue);
  1. Map
MapStructure structure = MapStructure.create(HashMap.class, String.class, Object.class);
HashMap<String, Object> value = PowerPreference.getDefaultFile().getMap("key", structure);

Note:

You can getting a value with out pass a defaultValue the library well return a default from the list if the key not exist.

String value = PowerPreference.getDefaultFile().getString("key");

If the key dosn't exist the library will return an empty string.

Type Default
Integer, Long, Float, Double 0
String ""
Object null

You also can choose a default value for each key in you preference file by seDefaults() method see the defaults section for more.

Clear Data

1. Clear data from specefic file

  • Synchronous
PowerPreference.getDefaultFile().clear();
  • Asynchronous
PowerPreference.getDefaultFile().clearAsync();

2. Clear data from all files

  • Synchronous
PowerPreference.clearAllData();
  • Asynchronous
PowerPreference.clearAllDataAsync();

Remove Data

  • Synchronous
PowerPreference.getDefaultFile().remove("key");
  • Asynchronous
PowerPreference.getDefaultFile().removeAsync("key");

Get Data

  1. Get all data for a specefic file
Map<String, ?> data = PowerPreference.getDefaultFile().getData();
  1. Get all data for all files in the app.
List<PreferenceFile> data = PowerPreference.getAllData()

Default Values

Set Default value to be used when reading from shared preference, You can use a different defaults value for every preference file.

There is two option using:

  1. XML
<?xml version="1.0" encoding="utf-8"?>
<defaultMap>
    <entry>
        <key>key</key>
        <value>true</value>
    </entry>

    <entry>
        <key>key</key>
        <value>Hello World!</value>
    </entry>
    
    <entry>
        <key>key</key>
        <value>5</value>
    </entry>
    
    //...etc
    
</defaultMap>
PowerPreference.getDefaultFile().setDefaults(R.xml.preferences_defaults)
  1. HashMap
Map<String, Object> defaults = new HashMap<>();
defaults.put("key", true);
defaults.put("key", "Hello World!");
defaults.put("key", 123);
defaults.put("key", 111L);
defaults.put("key", 1.1f);
defaults.put("key", 1.111d);
defaults.put("key", new Object());
PowerPreference.getDefaultFile().setDefaults(hashMap);

Preference Debbuger

By preference debugger you can show all the preference in all the file in your app simply by calling.

PowerPreference.showDebugScreen();

License

Copyright 2018 Ali Asadi.

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.