android & benitlux: use NitObject in clients
[nit.git] / lib / android / shared_preferences / shared_preferences_api10.nit
index 8635f86..f012ed2 100644 (file)
 # Services to save/load data using `android.content.SharedPreferences` for the android platform
 module shared_preferences_api10
 
-import native_app_glue
+import dalvik
 import serialization
-private import json_serialization
+private import json
 
 in "Java" `{
        import android.content.SharedPreferences;
-       import android.content.Context; 
+       import android.content.Context;
        import android.app.Activity;
        import java.util.Map;
        import java.util.Iterator;
@@ -33,39 +33,38 @@ in "Java" `{
 
 extern class NativeSharedPreferences in "Java" `{ android.content.SharedPreferences `}
        super JavaObject
-       redef type SELF: NativeSharedPreferences
-       
-       fun contains(key: JavaString): Bool in "Java" `{ return recv.contains(key); `}
+
+       fun contains(key: JavaString): Bool in "Java" `{ return self.contains(key); `}
        fun get_all: HashMap[JavaString, JavaObject] import HashMap[JavaString, JavaObject],
-               HashMap[JavaString, JavaObject].[]= in "Java" `{ 
+               HashMap[JavaString, JavaObject].[]= in "Java" `{
                Map<String, ?> java_map = null;
-               int nit_hashmap = new_HashMap_of_JavaString_JavaObject();
+               nit.app.NitObject nit_hashmap = new_HashMap_of_JavaString_JavaObject();
                try {
-                       java_map = recv.getAll();
+                       java_map = self.getAll();
                } catch (NullPointerException e) {
                        return nit_hashmap;
                }
 
                for (Map.Entry<String, ?> entry: java_map.entrySet())
-                       HashMap_of_JavaString_JavaObject__index_assign(nit_hashmap, 
+                       HashMap_of_JavaString_JavaObject__index_assign(nit_hashmap,
                                entry.getKey(), entry.getValue());
 
                return nit_hashmap;
        `}
-       fun get_boolean(key: JavaString, def_value: Bool): Bool in "Java" `{ 
+       fun get_boolean(key: JavaString, def_value: Bool): Bool in "Java" `{
                boolean return_value;
                try {
-                       return_value = recv.getBoolean(key, def_value); 
+                       return_value = self.getBoolean(key, def_value);
                } catch (ClassCastException e) {
                        return def_value;
                }
 
                return return_value;
        `}
-       fun get_float(key: JavaString, def_value: Float): Float in "Java" `{ 
+       fun get_float(key: JavaString, def_value: Float): Float in "Java" `{
                float return_value;
                try {
-                       return_value = recv.getFloat(key, (float) def_value); 
+                       return_value = self.getFloat(key, (float) def_value);
                } catch (ClassCastException e) {
                        return def_value;
                }
@@ -75,7 +74,7 @@ extern class NativeSharedPreferences in "Java" `{ android.content.SharedPreferen
        fun get_int(key: JavaString, def_value: Int): Int in "Java" `{
                int return_value;
                try {
-                       return_value = recv.getInt(key, (int)def_value); 
+                       return_value = self.getInt(key, (int)def_value);
                } catch (ClassCastException e) {
                        return def_value;
                }
@@ -85,7 +84,7 @@ extern class NativeSharedPreferences in "Java" `{ android.content.SharedPreferen
        fun get_long(key: JavaString, def_value: Int): Int in "Java" `{
                long return_value;
                try {
-                       return_value = recv.getLong(key, def_value); 
+                       return_value = self.getLong(key, def_value);
                } catch (ClassCastException e) {
                        return def_value;
                }
@@ -95,7 +94,7 @@ extern class NativeSharedPreferences in "Java" `{ android.content.SharedPreferen
        fun get_string(key: JavaString, def_value: JavaString): JavaString in "Java" `{
                String return_value = null;
                try {
-                       return_value = recv.getString(key, def_value); 
+                       return_value = self.getString(key, def_value);
                } catch (ClassCastException e) {
                        return def_value;
                }
@@ -105,64 +104,61 @@ extern class NativeSharedPreferences in "Java" `{ android.content.SharedPreferen
 
        # HACK for bug #845
        redef fun new_global_ref import sys, Sys.jni_env `{
-               Sys sys = NativeSharedPreferences_sys(recv);
+               Sys sys = NativeSharedPreferences_sys(self);
                JNIEnv *env = Sys_jni_env(sys);
-               return (*env)->NewGlobalRef(env, recv);
+               return (*env)->NewGlobalRef(env, self);
        `}
 end
 
 extern class NativeSharedPreferencesEditor in "Java" `{ android.content.SharedPreferences$Editor `}
        super JavaObject
-       redef type SELF: NativeSharedPreferencesEditor
 
-       fun clear: NativeSharedPreferencesEditor in "Java" `{ return recv.clear(); `}
-       fun commit: Bool in "Java" `{ return recv.commit(); `}
-       fun put_boolean(key: JavaString, value: Bool ): NativeSharedPreferencesEditor in "Java" `{ 
-               return recv.putBoolean (key, value); 
+       fun clear: NativeSharedPreferencesEditor in "Java" `{ return self.clear(); `}
+       fun commit: Bool in "Java" `{ return self.commit(); `}
+       fun put_boolean(key: JavaString, value: Bool): NativeSharedPreferencesEditor in "Java" `{
+               return self.putBoolean (key, value);
        `}
        fun put_float(key: JavaString, value: Float): NativeSharedPreferencesEditor in "Java" `{
-               return recv.putFloat(key, (float) value); 
+               return self.putFloat(key, (float) value);
        `}
        fun put_int(key: JavaString, value: Int): NativeSharedPreferencesEditor in "Java" `{
-               return recv.putInt(key, (int)value); 
+               return self.putInt(key, (int)value);
        `}
        fun put_long(key: JavaString, value: Int): NativeSharedPreferencesEditor in "Java" `{
-               return recv.putLong(key, value); 
+               return self.putLong(key, value);
        `}
        fun put_string(key: JavaString, value: JavaString): NativeSharedPreferencesEditor in "Java" `{
-               return recv.putString(key, value); 
+               return self.putString(key, value);
        `}
-       fun remove(key: JavaString): NativeSharedPreferencesEditor in "Java" `{ 
-               return recv.remove(key); 
+       fun remove(key: JavaString): NativeSharedPreferencesEditor in "Java" `{
+               return self.remove(key);
        `}
 
        # HACK for bug #845
        redef fun new_global_ref import sys, Sys.jni_env `{
-               Sys sys = NativeSharedPreferencesEditor_sys(recv);
+               Sys sys = NativeSharedPreferencesEditor_sys(self);
                JNIEnv *env = Sys_jni_env(sys);
-               return (*env)->NewGlobalRef(env, recv);
+               return (*env)->NewGlobalRef(env, self);
        `}
 end
 
 # Provides services to save and load data for the android platform
 class SharedPreferences
-       protected var context: NativeActivity
        protected var shared_preferences: NativeSharedPreferences
        protected var editor: NativeSharedPreferencesEditor
 
        # Automatically commits every saving/removing instructions (`true` by default)
        var auto_commit = true
-       
-       protected init(app: App, file_name: String, mode: Int) 
+
+       protected init(app: App, file_name: String, mode: Int)
        do
-               self.context = app.native_activity
                sys.jni_env.push_local_frame(1)
-               setup(file_name.to_java_string, mode)
+               setup(file_name.to_java_string, mode, app.native_context)
                sys.jni_env.pop_local_frame
        end
 
        # Restricts file access to the current application
-       init privately(app: App, file_name: String) 
+       init privately(app: App, file_name: String)
        do
                self.init(app, file_name, private_mode)
        end
@@ -176,29 +172,29 @@ class SharedPreferences
                self.editor = editor.new_global_ref
        end
 
-       private fun setup(file_name: JavaString, mode: Int) import context, set_vars in "Java" `{
-               Activity context = (Activity) SharedPreferences_context(recv);
+       private fun setup(file_name: JavaString, mode: Int, context: NativeContext) import set_vars in "Java" `{
                SharedPreferences sp;
 
                // Uses default SharedPreferences if file_name is an empty String
                if (file_name.equals("")) {
-                       sp = context.getPreferences((int)mode);
-               } else { 
+                       Activity activity = (Activity)context;
+                       sp = activity.getPreferences((int)mode);
+               } else {
                        sp = context.getSharedPreferences(file_name, (int)mode);
                }
 
                SharedPreferences.Editor editor = sp.edit();
-               
-               SharedPreferences_set_vars(recv, sp, editor);
+
+               SharedPreferences_set_vars(self, sp, editor);
        `}
 
        private fun commit_if_auto do if auto_commit then self.commit
 
        # Returns true if there's an entry corresponding the given key
-       fun has(key: String): Bool 
+       fun has(key: String): Bool
        do
                sys.jni_env.push_local_frame(2)
-               var return_value = shared_preferences.contains(key.to_java_string) 
+               var return_value = shared_preferences.contains(key.to_java_string)
                sys.jni_env.pop_local_frame
                return return_value
        end
@@ -207,18 +203,17 @@ class SharedPreferences
        #
        # User has to manage local stack deallocation himself
        #
-       # Example :
-       # ~~~
+       # ~~~nitish
        # var foo = new HashMap[JavaString, JavaObject]
        # # ...
        # for key, value in foo do
-       #      key.delete_local_ref
-       #      value.delete_local_ref
+       #         key.delete_local_ref
+       #         value.delete_local_ref
        # end
-       # ~~~
-       # *You should use Nit getters instead and get each value one by one* 
+       # ~~~
+       # *You should use Nit getters instead and get each value one by one*
        fun all: nullable HashMap[JavaString, JavaObject]
-       do 
+       do
                var hashmap = shared_preferences.get_all
                if hashmap.is_empty then return null
                return hashmap
@@ -226,8 +221,8 @@ class SharedPreferences
 
        # Returns the `Bool` value corresponding the given key or `def_value` if none
        # or if the value isn't of correct type
-       fun bool(key: String, def_value: Bool): Bool 
-       do 
+       fun bool(key: String, def_value: Bool): Bool
+       do
                sys.jni_env.push_local_frame(2)
                var return_value = shared_preferences.get_boolean(key.to_java_string, def_value)
                sys.jni_env.pop_local_frame
@@ -236,8 +231,8 @@ class SharedPreferences
 
        # Returns the `Float` value corresponding the given key or `def_value` if none
        # or if the value isn't of correct type
-       fun float(key: String, def_value: Float): Float 
-       do 
+       fun float(key: String, def_value: Float): Float
+       do
                sys.jni_env.push_local_frame(2)
                var return_value = shared_preferences.get_float(key.to_java_string, def_value)
                sys.jni_env.pop_local_frame
@@ -246,10 +241,10 @@ class SharedPreferences
 
        # Returns the `Int` value corresponding the given key or `def_value` if none
        # or if the value isn't of correct type
-       # Be aware of possible `def_value` integer overflow as the Nit `Int` corresponds 
+       # Be aware of possible `def_value` integer overflow as the Nit `Int` corresponds
        # to Java `long`
-       fun int(key: String, def_value: Int): Int 
-       do 
+       fun int(key: String, def_value: Int): Int
+       do
                sys.jni_env.push_local_frame(2)
                var return_value = shared_preferences.get_int(key.to_java_string, def_value)
                sys.jni_env.pop_local_frame
@@ -260,8 +255,8 @@ class SharedPreferences
        # or if the value isn't of correct type
        # Calls `getLong(key, value)` java method
        # Nit `Int` is equivalent to Java `long` so that no integer overflow will occur
-       fun long(key: String, def_value: Int): Int 
-       do 
+       fun long(key: String, def_value: Int): Int
+       do
                sys.jni_env.push_local_frame(2)
                var return_value = shared_preferences.get_long(key.to_java_string, def_value)
                sys.jni_env.pop_local_frame
@@ -270,29 +265,29 @@ class SharedPreferences
 
        # Returns the `String` value corresponding the given key or `def_value` if none
        # or if the value isn't of correct type
-       fun string(key: String, def_value: String): String 
-       do 
+       fun string(key: String, def_value: String): String
+       do
                sys.jni_env.push_local_frame(3)
-               var java_return_value = shared_preferences.get_string(key.to_java_string, 
+               var java_return_value = shared_preferences.get_string(key.to_java_string,
                        def_value.to_java_string)
                var nit_return_value = java_return_value.to_s
                sys.jni_env.pop_local_frame
                return nit_return_value
        end
 
-       # Clears all the dictionnary entries in the specified file or the default file 
+       # Clears all the dictionnary entries in the specified file or the default file
        # if none specified at instanciation
        # Returns `self` allowing fluent programming
-       fun clear: SharedPreferences 
-       do 
+       fun clear: SharedPreferences
+       do
                editor.clear
                commit_if_auto
                return self
        end
-       
+
        # If auto_commit is `false`, has to be called to save the data to persistant memory
-       fun commit: Bool 
-       do 
+       fun commit: Bool
+       do
                sys.jni_env.push_local_frame(1)
                var return_value = editor.commit
                sys.jni_env.pop_local_frame
@@ -301,8 +296,8 @@ class SharedPreferences
 
        # Set a key-value pair using a `Bool` value
        # Returns `self` allowing fluent programming
-       fun add_bool(key: String, value: Bool ): SharedPreferences 
-       do 
+       fun add_bool(key: String, value: Bool): SharedPreferences
+       do
                sys.jni_env.push_local_frame(1)
                editor.put_boolean(key.to_java_string, value)
                sys.jni_env.pop_local_frame
@@ -315,8 +310,8 @@ class SharedPreferences
        #
        # Be aware of possible loss of precision as Nit `Float` corresponds to Java `double`
        # and the methods stores a Java `float`
-       fun add_float(key: String, value: Float): SharedPreferences 
-       do 
+       fun add_float(key: String, value: Float): SharedPreferences
+       do
                sys.jni_env.push_local_frame(1)
                editor.put_float(key.to_java_string, value)
                sys.jni_env.pop_local_frame
@@ -330,8 +325,8 @@ class SharedPreferences
        # Be aware of possible integer overflow as the Nit `Int` corresponds to Java `long`
        # and the methods stores a Java `int`
        # *You might want to use add_long instead*
-       fun add_int(key: String, value: Int): SharedPreferences 
-       do 
+       fun add_int(key: String, value: Int): SharedPreferences
+       do
                sys.jni_env.push_local_frame(1)
                editor.put_int(key.to_java_string, value)
                sys.jni_env.pop_local_frame
@@ -341,8 +336,8 @@ class SharedPreferences
 
        # Set a key-value pair using a `Int` type value
        # Returns `self` allowing fluent programming
-       fun add_long(key: String, value: Int): SharedPreferences 
-       do 
+       fun add_long(key: String, value: Int): SharedPreferences
+       do
                sys.jni_env.push_local_frame(1)
                editor.put_long(key.to_java_string, value)
                sys.jni_env.pop_local_frame
@@ -352,8 +347,8 @@ class SharedPreferences
 
        # Set a key-value pair using a `String` type value
        # Returns `self` allowing fluent programming
-       fun add_string(key: String, value: String): SharedPreferences 
-       do 
+       fun add_string(key: String, value: String): SharedPreferences
+       do
                sys.jni_env.push_local_frame(2)
                editor.put_string(key.to_java_string, value.to_java_string)
                sys.jni_env.pop_local_frame
@@ -363,8 +358,8 @@ class SharedPreferences
 
        # Removes the corresponding entry in the file
        # Returns `self` allowing fluent programming
-       fun remove(key: String): SharedPreferences 
-       do 
+       fun remove(key: String): SharedPreferences
+       do
                sys.jni_env.push_local_frame(1)
                editor.remove(key.to_java_string)
                sys.jni_env.pop_local_frame
@@ -373,7 +368,7 @@ class SharedPreferences
        end
 
        # Deallocate global references allocated by the SharedPreferences instance
-       fun destroy 
+       fun destroy
        do
                self.shared_preferences.delete_global_ref
                self.editor.delete_global_ref
@@ -382,7 +377,7 @@ class SharedPreferences
        # Store `value` as a serialized Json string
        fun []=(key: String, value: nullable Serializable)
        do
-               var serialized_string = new StringOStream
+               var serialized_string = new StringWriter
                var serializer = new JsonSerializer(serialized_string)
                serializer.serialize(value)
 
@@ -393,7 +388,7 @@ class SharedPreferences
        # Retrieve an `Object` stored via `[]=` function
        #
        # Returns `null` if there's no serialized object corresponding to the given key
-       # Make sure that the serialized object is `auto_serializable` or that it redefines
+       # Make sure that the serialized object is `serialize` or that it redefines
        # the appropriate methods. Refer to `Serializable` documentation for further details
        fun [](key: String): nullable Object
        do
@@ -402,12 +397,21 @@ class SharedPreferences
                if serialized_string == "" then return null
 
                var deserializer = new JsonDeserializer(serialized_string)
-               return deserializer.deserialize
+               var deserialized = deserializer.deserialize
+
+               var errors = deserializer.errors
+               if errors.not_empty then
+                       # An update may have broken the versioning compatibility
+                       print_error "{class_name} error at deserialization: {errors.join(", ")}"
+                       return null # Let's be safe
+               end
+
+               return deserialized
        end
 end
 
 redef class App
-       fun shared_preferences: SharedPreferences is cached do 
-               return new SharedPreferences.privately(self, "")
+       var shared_preferences: SharedPreferences is lazy do
+               return new SharedPreferences.privately(self, "app.nit")
        end
 end