ZhouXY108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-05-09 23:51:34 +08:00
Code Issues Packages Projects Releases Wiki Activity

完善注释和描述，添加ReflectUtil.getDescriptor测试用例,优化appendDescriptor

Browse Source
This commit is contained in:
achao 2022-06-06 12:48:56 +08:00 committed by VampireAchao
parent 518b4212f6
commit fa3dfcdf79
2 changed files with 38 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
hutool-core/src/main/java/cn/hutool/core/reflect/ReflectUtil.java
View File

@ -29,10 +29,19 @@ public class ReflectUtil {
} }
/** /**
* 获取描述符 * 获取jvm定义的Field Descriptors（字段描述）
* *
* @param executable 可执行的反射对象 * @param executable 可执行的反射对象
* @return 描述符 * @return 描述符
* @apiNote 参考：<a href="https://docs.oracle.com/javase/specs/jvms/se7/html/jvms-4.html">jvm定义的Field Descriptors（字段描述）</a>
* <p>例：</p>
* <ul>
* <li>{@code ReflectUtil.getDescriptor(Object.class.getMethod("hashCode")) // "()I"}</li>
* <li>{@code ReflectUtil.getDescriptor(Object.class.getMethod("toString")) // "()Ljava/lang/String;"}</li>
* <li>{@code ReflectUtil.getDescriptor(Object.class.getMethod("equals", Object.class)) // "(Ljava/lang/Object;)Z"}</li>
* <li>{@code ReflectUtil.getDescriptor(ReflectUtil.class.getDeclaredMethod("appendDescriptor", Class.clas, StringBuilder.class)) // "(Ljava/lang/Class;Ljava/lang/StringBuilder;)V"}</li>
* <li>{@code ReflectUtil.getDescriptor(ArrayUtil.class.getMethod("isEmpty", Object[].class)) // "([Ljava/lang/Object;)Z"}</li>
* </ul>Object.class.getMethod("hashCode")
*/ */
public static String getDescriptor(Executable executable) { public static String getDescriptor(Executable executable) {
StringBuilder stringBuilder = new StringBuilder(); StringBuilder stringBuilder = new StringBuilder();
@ -52,6 +61,13 @@ public class ReflectUtil {
throw new IllegalArgumentException("Unknown Executable: " + executable); throw new IllegalArgumentException("Unknown Executable: " + executable);
} }
/**
* 拼接描述符
*
* @param clazz 类
* @param stringBuilder 描述符
* @link <a href="https://docs.oracle.com/javase/specs/jvms/se7/html/jvms-4.html">jvm定义的Field Descriptors（字段描述）</a>
*/
private static void appendDescriptor(Class<?> clazz, StringBuilder stringBuilder) { private static void appendDescriptor(Class<?> clazz, StringBuilder stringBuilder) {
Class<?> currentClass; Class<?> currentClass;
for (currentClass = clazz; for (currentClass = clazz;
@ -59,7 +75,7 @@ public class ReflectUtil {
currentClass = currentClass.getComponentType()) { currentClass = currentClass.getComponentType()) {
stringBuilder.append('['); stringBuilder.append('[');
} }
if (currentClass.isPrimitive()) { if (ClassUtil.isBasicType(currentClass)) {
stringBuilder.append(getDescriptorChar(currentClass)); stringBuilder.append(getDescriptorChar(currentClass));
} else { } else {
stringBuilder.append('L').append(currentClass.getName().replace('.', '/')).append(';'); stringBuilder.append('L').append(currentClass.getName().replace('.', '/')).append(';');
@ -67,9 +83,13 @@ public class ReflectUtil {
} }
/**
* 获取单个描述符
*
* @param currentClass 当前类
* @return 描述符
*/
private static char getDescriptorChar(Class<?> currentClass) { private static char getDescriptorChar(Class<?> currentClass) {
// see sun.invoke.util.Wrapper
// These must be in the order defined for widening primitive conversions in JLS 5.1.2
if (currentClass == Boolean.class || currentClass == boolean.class) { if (currentClass == Boolean.class || currentClass == boolean.class) {
return 'Z'; return 'Z';
} }

14
hutool-core/src/test/java/cn/hutool/core/reflect/ReflectUtilTest.java
View File

@ -1,6 +1,10 @@
package cn.hutool.core.reflect; package cn.hutool.core.reflect;
import cn.hutool.core.lang.Assert;
import cn.hutool.core.util.ArrayUtil;
import lombok.Data; import lombok.Data;
import lombok.SneakyThrows;
import org.junit.Test;
/** /**
* 反射工具类单元测试 * 反射工具类单元测试
@ -105,4 +109,14 @@ public class ReflectUtilTest {
} }
} }
@Test
@SneakyThrows
public void testGetDescriptor() {
Assert.equals("()I", ReflectUtil.getDescriptor(Object.class.getMethod("hashCode")));
Assert.equals("()Ljava/lang/String;", ReflectUtil.getDescriptor(Object.class.getMethod("toString")));
Assert.equals("(Ljava/lang/Object;)Z", ReflectUtil.getDescriptor(Object.class.getMethod("equals", Object.class)));
Assert.equals("(Ljava/lang/Class;Ljava/lang/StringBuilder;)V", ReflectUtil.getDescriptor(ReflectUtil.class.getDeclaredMethod("appendDescriptor", Class.class, StringBuilder.class)));
Assert.equals("([Ljava/lang/Object;)Z", ReflectUtil.getDescriptor(ArrayUtil.class.getMethod("isEmpty", Object[].class)));
}
} }