altoslib: Switch preserved state format to JSON
[fw/altos] / altoslib / AltosPreferencesBackend.java
1 /*
2  * Copyright © 2010 Mike Beattie <mike@ethernal.org>
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; version 2 of the License.
7  *
8  * This program is distributed in the hope that it will be useful, but
9  * WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11  * General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License along
14  * with this program; if not, write to the Free Software Foundation, Inc.,
15  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
16  */
17
18 package org.altusmetrum.altoslib_11;
19
20 import java.io.*;
21 import java.util.*;
22 import java.text.*;
23
24 public abstract class AltosPreferencesBackend {
25
26         public abstract String  getString(String key, String def);
27         public abstract void    putString(String key, String value);
28
29         public abstract int     getInt(String key, int def);
30         public abstract void    putInt(String key, int value);
31
32         public abstract double  getDouble(String key, double def);
33         public abstract void    putDouble(String key, double value);
34
35         public abstract boolean getBoolean(String key, boolean def);
36         public abstract void    putBoolean(String key, boolean value);
37
38         public abstract byte[]  getBytes(String key, byte[] def);
39         public abstract void    putBytes(String key, byte[] value);
40
41         public AltosHashSet     getHashSet(String key) {
42                 String  value = getString(key, null);
43
44                 if (value == null)
45                         return null;
46                 return AltosHashSet.fromString(value);
47         }
48
49         public void             putHashSet(String key, AltosHashSet h) {
50                 putString(key, h.toString());
51         }
52
53         public AltosJson        getJson(String key) {
54                 String  value = getString(key, null);
55
56                 if (value == null)
57                         return null;
58                 try {
59                         return AltosJson.fromString(value);
60                 } catch (IllegalArgumentException ie) {
61                         return null;
62                 }
63         }
64
65         public void             putJson(String key, AltosJson j) {
66                 putString(key, j.toString());
67         }
68
69         public abstract boolean nodeExists(String key);
70         public abstract AltosPreferencesBackend node(String key);
71
72         public abstract String[] keys();
73         public abstract void    remove(String key);
74
75         public abstract void    flush();
76
77         public abstract File homeDirectory();
78
79         public abstract void debug(String format, Object ... arguments);
80 }