droid_wrap/java/lang/
reflect.rs

1/*
2 * Copyright (c) 2024. The RigelA open source project team and
3 * its contributors reserve all rights.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software distributed under the
10 * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11 * See the License for the specific language governing permissions and limitations under the License.
12 */
13
14use crate::{JObjNew, JObjRef, JType, java::lang::Object, java_class, java_interface, java_method};
15
16/**
17InvocationHandler 是代理实例的调用处理程序实现的接口。每个代理实例都有一个关联的调用处理程序。当在代理实例上调用方法时，方法调用将被编码并分派到其调用处理程序的invoke方法。
18*/
19#[java_interface(name = "java/lang/InvocationHandler")]
20pub trait InvocationHandler {
21    /**
22    处理代理实例上的方法调用并返回结果。当在与其关联的代理实例上调用方法时，将在调用处理程序上调用此方法。
23    返回：从代理实例上的方法调用返回的值。如果接口方法声明的返回类型是原始类型，则此方法返回的值必须是相应原始包装器类的实例；否则，它必须是可分配给声明的返回类型的类型。如果此方法返回的值为 null，并且接口方法的返回类型为原始类型，则代理实例上的方法调用将抛出 NullPointerException。如果此方法返回的值与接口方法声明的返回类型不兼容（如上所述），则代理实例上的方法调用将抛出 ClassCastException。
24    抛出:Throwable – 代理实例上的方法调用抛出的异常。异常的类型必须可分配给接口方法的 throws 子句中声明的任何异常类型，或可分配给未经检查的异常类型 java.lang.RuntimeException 或 java.lang.Error。如果此方法抛出的已检查异常无法分配给接口方法的 throws 子句中声明的任何异常类型，则代理实例上的方法调用将抛出包含此方法抛出的异常的 UndeclaredThrowableException。
25    `proxy` 调用该方法的代理实例
26    `method` 与在代理实例上调用的接口方法相对应的 Method 实例。Method 对象的声明类将是声明该方法的接口，该接口可能是代理类通过其继承方法的代理接口的超接口。
27    `args` 包含代理实例上的方法调用中传递的参数值的对象数组，如果接口方法不带参数，则为 null。原始类型的参数包装在适当的原始包装器类的实例中，例如 java.lang.Integer 或 java.lang.Boolean。
28    */
29    fn invoke(proxy: &Object, method: &Method, args: &[Object]);
30}
31
32/// 方法和构造函数的共同功能的共享超类。
33#[java_class(name = "java/lang/reflect/Executable")]
34pub struct Executable;
35
36impl Executable {
37    /**
38    返回此对象所代表的可执行文件的名称。
39    */
40    #[java_method]
41    pub fn get_name(&self) -> String {}
42
43    /**
44    返回此对象所代表的可执行文件的形式参数数量（无论是显式声明、隐式声明还是均未声明）。
45    返回：此对象所代表的可执行文件的形式参数数量
46    */
47    #[java_method]
48    pub fn get_parameter_count(&self) -> i32 {}
49}
50
51/**
52方法提供有关类或接口上的单个方法的信息和访问权。反射方法可以是类方法或实例方法（包括抽象方法）。当将要调用的实际参数与底层方法的形式参数匹配时，方法允许发生扩展转换，但如果发生缩小转换，则会引发 IllegalArgumentException。
53*/
54#[java_class(name = "java/lang/reflect/Method", extends=Executable)]
55pub struct Method;
56
57impl Method {
58    /**
59    以字符串形式返回此 Method 对象所表示的方法的名称。
60    */
61    pub fn get_name(&self) -> String {
62        self._based.get_name()
63    }
64
65    /**
66    返回此对象所代表的可执行文件的形式参数数量（无论是显式声明、隐式声明还是均未声明）。
67    返回：此对象所代表的可执行文件的形式参数数量
68    */
69    pub fn get_parameter_count(&self) -> i32 {
70        self._based.get_parameter_count()
71    }
72}
73
74/// 测试java.lang.reflect
75#[cfg(feature = "test_java_lang_reflect")]
76pub fn test() {}
droid_wrap/java/lang/reflect.rs

droid_wrap/java/lang/
reflect.rs
