v0.9.0 (Dec 18, 2016)
Sep 23, 2016
Dec 26, 2016 (Retired)
Tatsuya Maki (t28hub)
Tatsuya Maki (t28hub)
Source code
APK file



Shade is a library makes SharedPreferences operation easy.

Table of Contents


There might be a lot of boilerplate codes related to SharedPreferences operation in your Android application such as below. Writing boilerplate codes is boring stuff and a waste of time. In addition, it is necessary to review and test the bored codes. Shade can solve the problem. Shade generates codes related to SharedPreferences operation automatically once you only defines an interface or an abstract class. Generated codes run safe and fast because Shade does not use the Reflection.


As you can see below, shade reduces a lot of boilerplate codes. In this example, user name and user age are stored into the SharedPreferences.


Here is an example implementation before using Shade.

public class UserUtils {
    private static final String PREF_NAME = "io.t28.example.user";
    private static final String PREF_USER_NAME = "user_name";
    private static final String PREF_USER_NAME = "user_age";
    private static final String DEFAULT_USER_NAME = "guest";
    private static final int DEFAULT_USER_AGE = 20;

    public static boolean hasName(Context context) {
        return getSharedPreferences(context).contains(PREF_USER_NAME);

    public static String getName(Context context) {
        return getSharedPreferences(context).getString(PREF_USER_NAME, DEFAULT_USER_NAME);

    public static void putName(Context context, String value) {
       getSharedPreferences(context).edit().putString(PREF_USER_NAME, value).apply();

    public static void removeName(Context context) {
        return getSharedPreferences(context).edit().remove(USER_NAME).apply();

    public static boolean hasAge(Context context) {
        return getSharedPreferences(context).contains(PREF_USER_AGE);

    public static int getAge(Context context) {
        return getSharedPreferences(context).getInt(PREF_USER_AGE, DEFAULT_USER_AGE);

    public static void putAge(Context context, int value) {
        return getSharedPreferences(context).edit().putInt(PREF_USER_AGE, value).apply();

    public static void removeAge(Context context) {
        return getSharedPreferences(context).edit().remove(PREF_USER_AGE).apply();

    public static SharedPreferences getSharedPreferences(Context context) {
        return context.getSharedPreferences(PREF_NAME, Cotnext.MODE_PRIVATE);


Here is an example implementation after using Shade.

public interface class User {
    @Property(key = "user_name", defValue = "guest")
    String name();

    @Property(key = "user_age", defValue = "20")
    int age();

Shade generates 3 classes.

  1. UserPreferences
  2. UserPreferences.Editor
  3. UserPreferences.UserImpl

You can use the generated classes as below.

// Instantiate the UserPreferences
UserPreferences preferences = new UserPreferences(context);

// Get preferences as a model
User user = preference.get(); // UserImpl{name=guest, age=20}

// Check whether a specific preference is contained
preferences.containsName(); // false
preferences.containsAge();  // false

// Get a specific preference
String name = preferences.getName(); // guest
int age = preferences.getAge(); // 20

// Put a specific preference
        .putName("My name")

// Put a model
User newUser = new UserPreferences.UserImpl("My name", 30);

// Remove a specific preference

// Clear all preferences


dependencies {
    compile 'io.t28:shade:0.9.0'
    annotationProcessor 'io.t28:shade-processor:0.9.0'


Shade provides only 2 annotations. One is @Preferences and the other is @Property.


@Preferences can be used to declare SharedPreferences model, and it can be annotated for an abstract class or an interface.

| Parameter | Type | Default Value | Description | |:---|:---|:---|:---|:---| | value | String | "" | Alias for name which allows to ignore name= part | | name | String | "" | The name of SharedPreferences | | mode | int | Context.MODE_PRIVATE | The operating mode of SharedPreferences |

Here is the example which uses io.t28.shade.example as a name and Context.MODE_PRIVATE as a mode.

@Preferences(name = "io.t28.shade.example", mode = Context.MODE_PRIVATE)
public abstract class Example {


@Property can be used to declare SharedPreferences key, and it can be annotated for an abstract method.

| Parameter | Type | Default Value | Description | |:---|:---|:---|:---|:---| | value | String | "" | Alias for name which allows to ignore key= part | | key | String | "" | The key of the preference value | | defValue | String | "" | The default value for the key | | converter | Class<? extends Converter> | Converter.class | The converter that converts any value to supported value |

  • Either value or key must be specified.
  • defValue will be parsed as a type of return type.
  • For example, defValue will be parsed as boolean if a method annotated with @Property returns boolean value.
  • Converter is useful for you if you need to store unsupported type to the SharedPreferences.
  • The details of the Converter is mentioned in the below section.

Here is the example which used count as a key and 1 as a default value.

public abstract class Example {
    @Property(key = "count", defValue = "1")
    public abstract int count();

The following default values are used if defValue is not specified.

Type Default value
boolean false
float 0.0f
int 0
long 0L
String ""
Set<String> Collections.emptySet()


SharedPreferences allows to store only 6 types as below.

  1. boolean
  2. float
  3. int
  4. long
  5. String
  6. Set<String>

Converter allows you to store unsupported types to SharedPreferences. You need to implement a converter which converts java.lang.Double to java.lang.Long, if you would like to use java.lang.Double. Here is an example implementation.

public class DoubleConverter implements Converter<Double, Long> {
    private static final double DEFAULT_VALUE = 0.0d;

    public Double toConverted(@Nullable Long supported) {
        if (supported == null) {
            return DEFAULT_VALUE;
        return Double.longBitsToDouble(supported);

    public Long toSupported(@Nullable Double converted) {
        if (converted == null) {
            return Double.doubleToLongBits(DEFAULT_VALUE);
        return Double.doubleToLongBits(converted);

Converter class should provide a default constructor.
toConverted should convert supported value to converted value and toSupported should convert converted value to supported value. You need to specify the DoubleConverter to the @Property such as below.

public abstract class Example {
    @Property(key = "updated", converter = DoubleConverter.class)
    public abstract Date updated();


Feel free to ask me if there is any troubles.


Copyright (c) 2016 Tatsuya Maki

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.