Java-API简析_java.lang.Class类（基于 Latest JDK）（浅析源码）

【版权声明】未经博主同意，谢绝转载！（请尊重原创，博主保留追究权）
https://blog.csdn.net/m0_69908381/article/details/130838927
出自【进步*于辰的博客】

其实我的【Java-API】专栏内的博文对大家来说意义是不大的。因为暂且没有源码讲解，而且需要看Java-API，直接看Java-API文档就行了，也不用看博文。所以呢，这篇博文主要是写给我自己看的，也就是Java-API笔记。
因为我发现目前，我对Java-API的学习意识比较薄弱，需要慢慢习惯使用Java-API，乃至剖析源码来提升自己的源码阅读能力和编码素质。
大家如果需要Java-API文档，我上传了【https://download.csdn.net/download/m0_69908381/87691693】。

注：在java中，直接使用此类比较常见的是【反射】。我曾写过一篇关于反射的文章，大家可查阅博文【关于对【java反射】的理解与使用】，下文一部分方法的示例在这篇文章中。

1、概述

Class 类的实例表示正在运行的 Java 应用程序中的类和接口。枚举是一种类，注释是一种接口。每个数组属于被映射为 Class 对象的一个类，所有具有相同元素类型和维数的数组都共享该 Class 对象。基本的 Java 类型（boolean、byte、char、short、int、long、float 和 double）和关键字 void 也表示为 Class 对象。

Class 没有公共构造方法。Class 对象是在加载类时由 Java 虚拟机以及通过调用类加载器中的 defineClass()方法自动构造的。

以下示例使用 Class 对象来显示对象的类名：

void printClassName(Object obj) {
    System.out.println("The class of " + obj +
                       " is " + obj.getClass().getName());
}

还可以使用一个类字面值（JLS Section 15.8.2）来获得命名类型（或 void）的 Class 对象。例如：

System.out.println("The name of class Foo is: "+ Foo.class.getName());

从以下版本开始：
JDK1.0
另请参见：
ClassLoader.defineClass(byte[], int, int)，序列化表格

2、方法摘要

2.1 Class asSubclass(Class clazz)

强制转换该 Class 对象，以表示指定的 class 对象所表示的类的一个子类。（后续补充）
说明：
看源码。

2.2 T cast(Object obj)

将一个对象强制转换成此 Class 对象所表示的类或接口。（暂未可知）

2.3 boolean desiredAssertionStatus()

如果要在调用此方法时，将要初始化该类，则返回将分配给该类的断言状态。（暂未可知）

2.4 static Class forName(String className)

返回与带有给定字符串名的类或接口相关联的 Class 对象。

2.5 static Class forName(String name, boolean initialize, ClassLoader loader)

使用给定的类加载器，返回与带有给定字符串名的类或接口相关联的 Class 对象。（暂未可知）

2.6 A getAnnotation(Class annotationClass)

如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。

2.7 Annotation[] getAnnotations()

返回此元素上存在的所有注释。

2.8 String getCanonicalName()

返回《Java Language Specification》中所定义的基础类的规范化名称。即全限定名。
示例：

Class z1 = Integer.class;
sout z1.getCanonicalName();// 打印：java.lang.Integer

2.9 Class[] getClasses()

返回一个包含某些 Class 对象的数组，这些对象表示属于此 Class 对象所表示的类的成员的所有公共类和接口，包括从超类和公共类继承的以及通过该类声明的公共类和接口成员。（暂未可知）

2.10 ClassLoader getClassLoader()

返回该类的类加载器。

2.11 Class getComponentType()

返回表示数组组件类型的 Class。（暂未可知）

2.12 Constructor getConstructor(Class... parameterTypes)

`返回一个 Constructor 对象，它反映此 Class 对象所表示的类的指定公共构造方法。
说明：
示例请查阅那篇【博文】的第2.1.2项。

2.13 Constructor[] getConstructors()

返回一个包含某些 Constructor 对象的数组，这些对象反映此 Class 对象所表示的类的所有公共构造方法。
说明：
示例请查阅那篇【博文】的第2.1.1项。

2.14 Annotation[] getDeclaredAnnotations()

返回直接存在于此元素上的所有注释。
说明：
暂未可知此方法与第7项的区别。

2.15 Class[] getDeclaredClasses()

返回 Class 对象的一个数组，这些对象反映声明为此 Class 对象所表示的类的成员的所有类和接口，包括该类所声明的公共、保护、默认（包）访问及私有类和接口，但不包括继承的类和接口。（暂未可知）

2.16 Constructor getDeclaredConstructor(Class... parameterTypes)

返回一个 Constructor 对象，该对象反映此 Class 对象所表示的类或接口的指定构造方法。
说明：
示例请查阅那篇【博文】的第2.1.2项。

2.17 Constructor[] getDeclaredConstructors()

返回 Constructor 对象的一个数组，这些对象反映此 Class 对象表示的类声明的所有构造方法。
说明：
示例请查阅那篇【博文】的第2.1.1项。

2.18 Field getDeclaredField(String name)

返回一个 Field 对象，该对象反映此 Class 对象所表示的类或接口的指定已声明字段。
说明：
示例请查阅那篇【博文】的第2.3.2项。

2.19 Field[] getDeclaredFields()

返回 Field 对象的一个数组，这些对象反映此 Class 对象所表示的类或接口所声明的所有字段，包括公共、保护、默认（包）访问和私有字段，但不包括继承的字段。

2.20 Method getDeclaredMethod(String name, Class… parameterTypes)

返回一个 Method 对象，该对象反映此 Class 对象所表示的类或接口的指定已声明方法。
说明：
示例请查阅那篇【博文】的第2.2.2项。

2.21 Method[] getDeclaredMethods()

返回 Method 对象的一个数组，这些对象反映此 Class 对象表示的类或接口声明的所有方法，包括公共、保护、默认（包）访问和私有方法，但不包括继承的方法。

2.22 Class getDeclaringClass()

如果此 Class 对象所表示的类或接口是另一个类的成员，则返回的 Class 对象表示该对象的声明类。（暂未可知）

2.23 Class getEnclosingClass()

返回基础类的立即封闭类。（暂未可知）

2.24 Constructor getEnclosingConstructor()

如果该 Class 对象表示构造方法中的一个本地或匿名类，则返回 Constructor 对象，它表示基础类的立即封闭构造方法。（暂未可知）

2.25 Method getEnclosingMethod()

如果此 Class 对象表示某一方法中的一个本地或匿名类，则返回 Method 对象，它表示基础类的立即封闭方法。（暂未可知）

2.26 T[] getEnumConstants()

如果此 Class 对象不表示枚举类型，则返回枚举类的元素或 null。（暂未可知）

2.27 Field getField(String name)

返回一个 Field 对象，它反映此 Class 对象所表示的类或接口的指定公共成员字段。
说明：
示例请查阅那篇【博文】的第2.3.2项。

2.28 Field[] getFields()

返回一个包含某些 Field 对象的数组，这些对象反映此 Class 对象所表示的类或接口的所有可访问公共字段。

2.29 Type[] getGenericInterfaces()

返回表示某些接口的 Type，这些接口由此对象所表示的类或接口直接实现。即父接口。

2.30 Type getGenericSuperclass()

返回表示此 Class 所表示的实体（类、接口、基本类型或 void）的直接超类的 Type。即父类。

2.31 Class[] getInterfaces()

确定此对象所表示的类或接口实现的接口。

2.32 Method getMethod(String name, Class… parameterTypes)

说明：
示例请查阅那篇【博文】的第2.2.2项。

2.33 Method[] getMethods()

返回一个包含某些 Method 对象的数组，这些对象反映此 Class 对象所表示的类或接口（包括那些由该类或接口声明的以及从超类和超接口继承的那些的类或接口）的公共 member 方法。

2.34 int getModifiers()

返回此类或接口以整数编码的 Java 语言修饰符。（暂未可知）

2.35 String getName()

以 String 的形式返回此 Class 对象所表示的实体（类、接口、数组类、基本类型或 void）名称。即返回全限定名。

2.36 Package getPackage()

获取此类的包。

2.37 ProtectionDomain getProtectionDomain()

返回该类的 ProtectionDomain。（暂未可知）

2.38 URL getResource(String name)

查找带有给定名称的资源。（暂未可知）

2.39 InputStream getResourceAsStream(String name)

查找具有给定名称的资源。（暂未可知）

2.40 Object[] getSigners()

获取此类的标记。
说明：
先看源码。

翻译：
返回此 class 的signers。如果没有signers，返回 null。特殊情况，如果当前 class 对象所表示的类/接口是基本数据类型或void，也返回 null。
至于标记是何物？暂未可知。
示例：

int.class;// 结果：null
void.class;// 结果：null

2.41 String getSimpleName()

返回源代码中给出的基础类的简称。即类/接口名。

2.42 Class getSuperclass()

返回表示此 Class 所表示的实体（类、接口、基本类型或 void）的超类的 Class。包括父类和超类。

2.43 TypeVariable>[] getTypeParameters()

按声明顺序返回 TypeVariable 对象的一个数组，这些对象表示用此 GenericDeclaration 对象所表示的常规声明来声明的类型变量。（暂未可知）

2.44 boolean isAnnotation()

如果此 Class 对象表示一个注释类型则返回 true。

2.45 boolean isAnnotationPresent(Class annotationClass)

如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。

2.46 boolean isAnonymousClass()

当且仅当基础类是匿名类时返回 true。
说明：
匿名类只能是采用最初始的定义方法，不能使用Lambda表达式定义。
示例：

// 示例1：初始定义方式
Consumer<String> service1 = new Consumer<String>() {
    @Override
    public void accept(String str) {
        System.out.println(str);
    }
};
Class z1 = service1.getClass();// 结果：true

// 示例2：用Lambda表达式简化定义方式
Consumer<String> service2 = str -> System.out.println(str);
Class z2 = service2.getClass();// 结果：false

// 示例3：方法引用（不过，这种好像完全是Lambda表达式应用，与匿名类关系不大）
Consumer<String> service3 =String::toString;
service3.accept("csdn");
Class z3 = service3.getClass();// 结果：false

2.47 boolean isArray()

判定此 Class 对象是否表示一个数组类。

2.48 boolean isAssignableFrom(Class cls)

判定此 Class 对象所表示的类或接口与指定的 Class 参数所表示的类或接口是否相同，或是否是其超类或超接口。即：若此 Class 对象所表示的类或接口是cls所表示的类或接口的父类/超类，返回 true。

2.49 boolean isEnum()

当且仅当该类声明为源代码中的枚举时返回 true。

2.50 boolean isInstance(Object obj)

判定指定的 Object 是否与此 Class 所表示的对象赋值兼容。
说明：
此方法一般用于包装类，即判断是否可赋值。

2.51 boolean isInterface()

判定指定的 Class 对象是否表示一个接口。

2.52 boolean isLocalClass()

当且仅当基础类是本地类时返回 true。（暂未可知）

2.53 boolean isMemberClass()

当且仅当基础类是成员类时返回 true。（暂未可知）

2.54 boolean isPrimitive()

判定指定的 Class 对象是否表示一个基本类型。

2.55 boolean isSynthetic()

如果此类是复合类，则返回 true，否则 false。
说明：
复合类也称之为组合类，是指将一个类（A）的对象作为另一个类（B）的成员变量，即B依赖于A，则B是复合类。
这是C++中复合类的定义，而在java中，经测试，暂未可知。

2.56 T newInstance()

创建此 Class 对象所表示的类的一个新实例。

2.57 String toString()

将对象转换为字符串。

3、其他类/接口

Arrays、Collections、Double、DriverManager、HashMap、Integer、Math、Locale、Package、StrictMath、String、System

本文持续更新中。。。
`