summaryrefslogtreecommitdiffstats
path: root/mobile/android/thirdparty/com/keepsafe/switchboard/Switch.java
blob: 5307750bbc9917b0ff20ddd194bad06b3f4564d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
/*
   Copyright 2012 KeepSafe Software Inc.

   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.keepsafe.switchboard;

import org.json.JSONObject;

import android.content.Context;

/**
 * Single instance of an existing experiment for easier and cleaner code.
 * 
 * @author Philipp Berner
 *
 */
public class Switch {

    private Context context;
    private String experimentName;

    /**
     * Creates an instance of a single experiment to give more convenient access to its values.
     * When the given experiment does not exist, it will give back default valued that can be found
     * in <code>Switchboard</code>. Developer has to know that experiment exists when using it.
     * @param c Application context
     * @param experimentName Name of the experiment as defined on the server
     */
    public Switch(Context c, String experimentName) {
        this.context = c;
        this.experimentName = experimentName;
    }

    /**
     * Returns true if the experiment is active for this particular user.
     * @return Status of the experiment and false when experiment does not exist.
     */
    public boolean isActive() {
        return SwitchBoard.isInExperiment(context, experimentName);
    }

    /**
     * Returns true if the experiment has additional values.
     * @return true when values exist
     */
    public boolean hasValues() {
        return SwitchBoard.hasExperimentValues(context, experimentName);
    }

    /**
     * Gives back all the experiment values in a JSONObject. This function checks if
     * values exists. If no values exist, it returns null.
     * @return Values in JSONObject or null if non
     */
    public JSONObject getValues() {
        if(hasValues())
            return SwitchBoard.getExperimentValuesFromJson(context, experimentName);
        else
            return null;
    }
}