Rooba
/
pyjnius
mirror of https://github.com/kivy/pyjnius.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

clarifications including viz. #511

This commit is contained in:
Craig Macdonald 2020-04-19 10:22:47 +01:00 committed by GitHub
parent 837659a4e6
commit f7f34bb831
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/source/api.rst
View File

@ -13,9 +13,10 @@ Reflection classes
.. class:: JavaClass .. class:: JavaClass
Base for reflecting a Java class. The idea is to subclass this JavaClass, Base for reflecting a Java class, allowing access to that Java class from Python.
add few :class:`JavaMethod`, :class:`JavaStaticMethod`, :class:`JavaField`, The idea is to subclass this JavaClass, add few :class:`JavaMethod`,
:class:`JavaStaticField`, and you're done. :class:`JavaStaticMethod`, :class:`JavaField`, :class:`JavaStaticField`, and
you're done.
You need to define at minimum the :data:`__javaclass__` attribute, and set You need to define at minimum the :data:`__javaclass__` attribute, and set
the :data:`__metaclass__` to :class:`MetaJavaClass`. the :data:`__metaclass__` to :class:`MetaJavaClass`.
@ -208,7 +209,8 @@ Java class implementation in Python
.. class:: PythonJavaClass .. class:: PythonJavaClass
Base for creating a Java class from a Python class. This allows us to Base for creating a Java class from a Python class. This allows us to
implement java interfaces completely in Python. implement java interfaces completely in Python, and pass such a Python
object back to Java.
In reality, you'll create a Python class that mimics the list of declared In reality, you'll create a Python class that mimics the list of declared
:data:`__javainterfaces__`. When you give an instance of this class to :data:`__javainterfaces__`. When you give an instance of this class to
@ -221,10 +223,16 @@ Java class implementation in Python
You need to define at minimum the :data:`__javainterfaces__` attribute, and You need to define at minimum the :data:`__javainterfaces__` attribute, and
declare java methods with the :func:`java_method` decorator. declare java methods with the :func:`java_method` decorator.
.. note:: .. notes::
Static methods and static fields are not supported. Static methods and static fields are not supported.
You can only implement Java interfaces. You cannot sub-class a java
object.
You must retain a reference to the Python object for the entire liftime
that your object is in-use within java.
For example, you could implement the `java/util/ListIterator` interface in For example, you could implement the `java/util/ListIterator` interface in
Python like this:: Python like this::