Files
godot-docs-l10n/classes/zh_CN/class_javaclasswrapper.rst

95 lines
4.0 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/4.4/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/4.4/doc/classes/JavaClassWrapper.xml.
.. _class_JavaClassWrapper:
JavaClassWrapper
================
**继承:** :ref:`Object<class_Object>`
提供对 Java 原生接口的访问。
.. rst-class:: classref-introduction-group
描述
----
JavaClassWrapper 单例为 Godot 应用程序提供了一种通过 `Java 原生接口 <https://developer.android.com/training/articles/perf-jni>`__\ JNI发送和接收数据的方法。
\ **注意:**\ 该单例仅适用于 Android 版本。
::
var LocalDateTime = JavaClassWrapper.wrap("java.time.LocalDateTime")
var DateTimeFormatter = JavaClassWrapper.wrap("java.time.format.DateTimeFormatter")
var datetime = LocalDateTime.now()
var formatter = DateTimeFormatter.ofPattern("dd-MM-yyyy HH:mm:ss")
print(datetime.format(formatter))
\ **警告:**\ 调用 Java 方法时,请确保使用 :ref:`get_exception()<class_JavaClassWrapper_method_get_exception>` 检查该方法是否抛出了异常。
.. rst-class:: classref-reftable-group
方法
----
.. table::
:widths: auto
+-------------------------------------+-------------------------------------------------------------------------------------------+
| :ref:`JavaObject<class_JavaObject>` | :ref:`get_exception<class_JavaClassWrapper_method_get_exception>`\ (\ ) |
+-------------------------------------+-------------------------------------------------------------------------------------------+
| :ref:`JavaClass<class_JavaClass>` | :ref:`wrap<class_JavaClassWrapper_method_wrap>`\ (\ name\: :ref:`String<class_String>`\ ) |
+-------------------------------------+-------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法说明
--------
.. _class_JavaClassWrapper_method_get_exception:
.. rst-class:: classref-method
:ref:`JavaObject<class_JavaObject>` **get_exception**\ (\ ) :ref:`🔗<class_JavaClassWrapper_method_get_exception>`
返回最近一次调用 Java 类时产生的 Java 异常。如果没有产生异常则返回 ``null``\ 。
\ **注意:**\ 该方法仅在 Android 上有效。该方法在其他平台上始终返回 ``null``\ 。
.. rst-class:: classref-item-separator
----
.. _class_JavaClassWrapper_method_wrap:
.. rst-class:: classref-method
:ref:`JavaClass<class_JavaClass>` **wrap**\ (\ name\: :ref:`String<class_String>`\ ) :ref:`🔗<class_JavaClassWrapper_method_wrap>`
包装 Java 中定义的类,返回 Godot 可以与之交互的 :ref:`Object<class_Object>` 类型 :ref:`JavaClass<class_JavaClass>`\ 。
包装内部(嵌套)类时请使用 ``$`` 分隔,不要用 ``.``\ 。例如 **WindowManager.LayoutParams** 类应使用 ``JavaClassWrapper.wrap("android.view.WindowManager$LayoutParams")`` 进行包装。
\ **注意:**\ 该方法仅适用于 Android在其他所有平台上都不会执行任何操作返回的是空的 :ref:`JavaClass<class_JavaClass>`\ 。
.. |virtual| replace:: :abbr:`virtual (本方法通常需要用户覆盖才能生效。)`
.. |const| replace:: :abbr:`const (本方法无副作用,不会修改该实例的任何成员变量。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了能接受在此处描述的参数外,还能够继续接受任意数量的参数。)`
.. |constructor| replace:: :abbr:`constructor (本方法用于构造某个类型。)`
.. |static| replace:: :abbr:`static (调用本方法无需实例,可直接使用类名进行调用。)`
.. |operator| replace:: :abbr:`operator (本方法描述的是使用本类型作为左操作数的有效运算符。)`
.. |bitfield| replace:: :abbr:`BitField (这个值是由下列位标志构成位掩码的整数。)`
.. |void| replace:: :abbr:`void (无返回值。)`