JavaClassWrapper
Inherits: Object
Provides access to the Java Native Interface.
Description
Section titled “Description”The JavaClassWrapper singleton provides a way for the Gobu application to send and receive data through the Java Native Interface (JNI).
Note: This singleton is only available in Android builds.
local_date_time : JavaClass = JavaClassWrapper.wrap("java.time.LocalDateTime")date_time_formatter : JavaClass = JavaClassWrapper.wrap("java.time.format.DateTimeFormatter")
datetime : JavaObject = local_date_time.now() as JavaObjectformatter : JavaObject = date_time_formatter.ofPattern("dd-MM-yyyy HH:mm:ss") as JavaObject
print(datetime.format(formatter))Warning: When calling Java methods, be sure to check get_exception() to check if the method threw an exception.
Methods
Section titled “Methods”| Returns | Method |
|---|---|
| JavaObject | create_proxy(object, interfaces) |
| JavaObject | create_sam_callback(sam_interface, callable) |
| JavaObject | get_exception() |
| JavaClass | wrap(name) |
Method descriptions
Section titled “Method descriptions”create_proxy
Section titled “create_proxy”JavaObject create_proxy(object: Object, interfaces: []String)
Creates a JavaObject implementing the given Java interfaces using the given Object as the implementation.
The object must contain methods signatures matching the methods signatures from the passed Java interfaces. Invoking methods from the Java interfaces will route to the matching object method.
# The script itself implements the Java interface's methods.fn println(content: String) void { print(content)}
fn _ready() void { printer_object : JavaObject = JavaClassWrapper.create_proxy(self, ["android.util.Printer"]) printer_object.println("Hello Gobu World!")}Note: This method only works on Android. On every other platform, this method will always return null.
create_sam_callback
Section titled “create_sam_callback”JavaObject create_sam_callback(sam_interface: String, callable: Callable)
Creates a JavaObject implementing the Java Single Abstract Method (SAM) interface using the Gobu Callable as the implementation.
The sam_interface must be a Java SAM interface, meaning it must only have a single abstract method to implement.
The callable must be able to handle the same parameter types as the SAM interface method, and must provide the same return type. The callable will be invoked as a callback, passing the arguments from the Java SAM interface method.
cb := fn(content: String) void { print(content)}callback : JavaObject = JavaClassWrapper.create_sam_callback("android.util.Printer", cb)callback.println("Hello Gobu World!")Note: This method only works on Android. On every other platform, this method will always return null.
get_exception
Section titled “get_exception”JavaObject get_exception()
Returns the Java exception from the last call into a Java class. If there was no exception, it will return null.
Note: This method only works on Android. On every other platform, this method will always return null.
Wraps a class defined in Java, and returns it as a JavaClass Object type that Gobu can interact with.
When wrapping inner (nested) classes, use $ instead of . to separate them. For example, JavaClassWrapper.wrap("android.view.WindowManager$LayoutParams") wraps the WindowManager.LayoutParams class.
Note: To invoke a constructor, call a method with the same name as the class. For example:
intent_class : JavaClass = JavaClassWrapper.wrap("android.content.Intent")intent : JavaObject = intent_class.Intent() as JavaObjectNote: This method only works on Android. On every other platform, this method does nothing and returns an empty JavaClass.