update doc

tito · tito · commit 6f32a6faac10 · 2012-08-13T13:09:02.000+02:00
diff --git a/recipes/android/src/java.pyx b/recipes/android/src/java.pyx
@@ -3,32 +3,85 @@ Java wrapper
 ============
 
 With this module, you can create Python class that reflect a Java class, and use
-it directly in Python. For example, if you have a Java class named
-Hardware.java, in org/test directory::
+it directly in Python.
 
+Example with static method
+--------------------------
+
+Java::
+
+    package org.test;
     public class Hardware {
         static int getDPI() {
             return metrics.densityDpi;
         }
     }
 
-You can create this Python class to use it::
+Python::
 
     class Hardware(JavaClass):
+        __metaclass__ = MetaJavaClass
         __javaclass__ = 'org/test/Hardware'
         getDPI = JavaStaticMethod('()I')
 
-And then, do::
+    Hardware.getDPI()
+
+
+Example with instance method
+----------------------------
+
+Java::
+
+    package org.test;
+    public class Action {
+        public String getName() {
+            return new String("Hello world")
+        }
+    }
+
+Python::
+
+    class Action(JavaClass):
+        __metaclass__ = MetaJavaClass
+        __javaclass__ = 'org/test/Action'
+        getName = JavaMethod('()Ljava/lang/String;')
+
+    action = Action()
+    print action.getName()
+    # will output Hello World
+
+
+Example with static/instance field
+----------------------------------
+
+Java::
+
+    package org.test;
+    public class Test {
+        public static String field1 = new String("hello");
+        public String field2;
+
+        public Test() {
+            this.field2 = new String("world");
+        }
+    }
+
+Python::
+
+    class Test(JavaClass):
+        __metaclass__ = MetaJavaClass
+        __javaclass__ = 'org/test/Test'
+
+        field1 = JavaStaticField('Ljava/lang/String;')
+        field2 = JavaField('Ljava/lang/String;')
 
-    hardware = Hardware()
-    hardware.getDPI()
+    # access directly to the static field
+    print Test.field1
 
-Limitations
------------
+    # create the instance, and access to the instance field
+    test = Test()
+    print test.field2
 
-- Even if the method is static in Java, you need to instanciate the object in
-  Python.
-- Array currently not supported
 '''
 
 __all__ = ('JavaObject', 'JavaClass', 'JavaMethod', 'JavaStaticMethod',
