1.1 Class 对象
1.2 名称信息
1.3 构造器
1.4 字段信息
1.5 方法信息
1.6 类型检查
二、注解
2.1 注解定义
2.2 注解信息
2.3 注解继承
在 Java 中,每个已加载的类在内存中都有一份类信息,类信息对应的类是 java.lang.Class
,每个对象都持有指向它所属类信息的引用。想要获取 Class 对象,有以下三种方法:
- 通过类名获取:
Class<Date> dateClass = Date.class;
Class<Integer> integerClass = int.class;
- 通过对象的
getClass()
方法获取:
Date date = new Date();
Class<? extends Date> aClass = date.getClass();
- 通过 Class 类的静态方法
forName
获取:
Class<?> aClass = Class.forName("java.util.Date");
Class 提供了如下三个方法,用于获取名称信息,其作用和输出分别如下:
- getName:返回 Java 内部使用的名称;
- getSimpleName:返回简称;
- getCanonicalName:返回由 Java 语言规范定义的命名。
Class 对象 | getName | getSimpleName | getCanonicalName |
---|---|---|---|
int.class | int | int | int |
int[].class | [I | int[] | int[] |
int[][].class | [[I | int[][] | int[][] |
String.class | java.lang.String | String | java.lang.String |
String[].class | [Ljava.lang.String; | String[] | java.lang.String[] |
ArrayList.class | java.util.ArrayList | ArrayList | java.util.ArrayList |
对于数组类型的getName返回值,使用前缀[
表示数组,有几个[
表示是几维数组,数组类型使用简写表示:boolean(Z)
、byte(B)
、char(C)
、double(D)
、float(F)
、int(I)
、long(J)
、short(S)
、接口和类(L)
。
Class 有以下四个获取构造器信息的方法:
//឴ 获取所有的public构造器
public Constructor<?>[] getConstructors()
//឴ 获取所有构造器
public Constructor<?>[] getDeclaredConstructors()
//឴ 获取指定参数的public构造器
public Constructor<T> getConstructor(Class<?>... parameterTypes)
// 获取指定参数的构造器឴
public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes)
获取指定的构造器后,可以使用 newInstance
方法来创建其实例,示例如下:
class Test {
static class Student {
private String name;
private int age;
Student() {}
Student(String name, int age) {
this.name = name;
this.age = age;
}
@Override
public String toString() {return "Student{" + "name='" + name + '\'' + ", age=" + age + '}';}
}
public static void main(String[] args) throws Exception {
Constructor<? extends Student> constructor = Student.class.getDeclaredConstructor(String.class, int.class);
Student student = constructor.newInstance("heibaiying", 10);
System.out.println(student);
}
}
// 输出:Student{name='heibaiying', age=10}
如果你只是想调用默认的无参构造器,则可以直接使用 Class 对象的newInstance
方法:
Student student = Student.class.newInstance();
Class 有以下四个获取字段信息的方法:
// 返回本类或其父类的所有public字段
public Field[] getFields()
// 返回本类声明的所有字段,但不包括父类的
public Field[] getDeclaredFields()
// 返回本类或其父类中指定名称的public字段
public Field getField(String name)
// 返回本类声明的指定名称的字段
public Field getDeclaredField(String name)
字段信息被封装在 Field 类中,Field 对象有以下常用方法:
// 获取字段的名称
public String getName()
// 判断是否有该字段的访问权限
public boolean isAccessible()
// 设置为true表示忽略Java的访问检查机制,从而可以读写非public的字段
public void setAccessible(boolean flag)
// 获取指定对象obj中该字段的值
public Object get(Object obj)
// 将指定对象obj中该字段的值设为value
public void set(Object obj, Object value)
以下给出一个修改字段的使用示例:
class Test {
static class Student {
private String name;
private int age;
}
public static void main(String[] args) throws Exception {
Student student = new Student();
Class<? extends Student> aClass = student.getClass();
Field field = aClass.getDeclaredField("name");
field.setAccessible(true);
field.set(student, "heibaiying");
System.out.println(field.get(student));
}
}
// 输出: heibaiying
Class 有以下四个获取方法信息的方法:
// 返回本类或其父类的所有public方法
public Method[] getMethods()
// 返回本类声明的所有方法,但不包括父类的
public Method[] getDeclaredMethods()
// 返回本类或其父类中指定名称及其参数类型的public方法
public Method getMethod(String name, Class<?>... parameterTypes)
// 返回本类声明的指定名称及其参数类型的方法
public Method getDeclaredMethod(String name, Class<?>... parameterTypes)
方法信息被封装在 Method 类中,Method 对象有以下常用方法:
// 获取方法的名称
public String getName()
// 设置为true表示忽略Java的访问检查机制,从而可以调用非public方法
public void setAccessible(boolean flag)
// 在指定的obj对象上调用invoke方法,args为传递的参数列表
public Object invoke(Object obj, Object... args)
基本使用示例如下:
class Test {
static class Student {
private String name;
public void setName(String name) {this.name = name;}
public String getName() { return name;}
}
public static void main(String[] args) throws Exception {
Student student = new Student();
Class<? extends Student> aClass = student.getClass();
Method setMethod = aClass.getDeclaredMethod("setName",String.class);
setMethod.invoke(student, "heibaiying");
Method geMethod = aClass.getDeclaredMethod("getName");
System.out.println(geMethod.invoke(student));
}
}
// 输出: heibaiying
想要判断某个对象是否是某个类或其子类的示例,可以使用 instanceof
关键字,或者使用 Class 的 isInstance
方法,示例如下:
static class Manager {}
static class Employee extends Manager {}
public static void main(String[] args) {
Employee employee = new Employee();
System.out.println(employee instanceof Manager); // true
System.out.println(employee instanceof Employee); // true
System.out.println(Manager.class.isInstance(employee)); // true
System.out.println(Employee.class.isInstance(employee)); // true
}
如果想要判断对象的具体类型,则可以使用equals
方法进行比较,示例如下:
employee.getClass().equals(Manager.class); // false
employee.getClass().equals(Employee.class); // true
在知道对象的类型后,如果你需要对其进行类型转换,则可以使用类型转换语法或者 Class 的 cast
方法:
Manager manager01 = Manager.class.cast(employee);
Manager manager02 = (Manager) employee;
下面是 @Override
注解的定义,所有注解均使用 @interface
关键字修饰, @Target
定义注解的使用对象,@Retention
表示注解信息保留到什么时候:
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}
@Target
有以下可选值,其含义分别如下:
- TYPE:表示类、接口(包括注释类型)或枚举声明;
- FIELD:字段声明(包括枚举常量);
- METHOD:方法声明;
- PARAMETER:参数声明;
- CONSTRUCTOR:构造器声明;
- LOCAL_VARIABLE:本地变量声明;
- ANNOTATION_TYPE:注解声明;
- PACKAGE:包声明;
- TYPE_PARAMETER:类型参数声明;
- TYPE_USE:任何使用类型的语句。
@Retention
有以下可选值,其含义分别如下:
- SOURCE:只在源代码中保留,编译器将代码编译为字节码后就会丢掉;
- CLASS:保留在字节码文件中,但虚拟机将 class 文件加载到内存时不一定会在内存中保留,这是默认的行为;
- RUNTIME:一直保留到运行时,可以通过反射获取其信息。
对于 @Retention
类型为 RUNTIME
的注解,可以利用反射机制查看其信息。因为注解可以运用在不同目标上,所以 Class 、Field、Method、Constructor 都有如下方法:
// 获取所有注解
public Annotation[] getAnnotations()
// 获取本元素上直接声明的所有注解,忽略inherited来的
public Annotation[] getDeclaredAnnotations()
// 获取指定类型的注解,如果不存在则返回null
public <T extends Annotation> T getAnnotation(Class<T> annotationClass)
// 判断是否有指定类型的注解
public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
这里给出一个使用示例,模仿常用的序列化框架,通过注解定义字段的序列化名称和序列化格式,注解定义如下:
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Json {
String value();
String format() default "";
}
class Test {
static class Student {
/*当只有一个值并且其对应的方法名为value时候,可以省略value = */
@Json("姓名")
private String name;
@Json(value = "出生日期", format = "yyyy-MM-dd HH:mm:ss")
private Date birthday;
......
}
static void parse(Object object, Class<?> clazz) throws IllegalAccessException {
Field[] fields = clazz.getDeclaredFields();
for (Field field : fields) {
if (field.isAnnotationPresent(Json.class)) {
field.setAccessible(true);
Object value = field.get(object);
Json json = field.getAnnotation(Json.class);
String name = json.value();
String format = json.format();
if (!"".equals(format) && field.getType() == Date.class) {
SimpleDateFormat formatter = new SimpleDateFormat(format);
value = formatter.format((Date) value);
}
System.out.println(name + ":" + value);
}
}
}
public static void main(String[] args) throws Exception {
Student student = new Student("heibai", new Date());
parse(student, Student.class);
}
}
输出如下:
姓名:heibai
出生日期:2019-07-06 08:45:47
一个常用的元注解是 @Inherited
,它表示某个注解是否能够被继承。示例如下:
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface ClassName {
String value();
}
使用示例如下,此时如果加上 @Inherited
注解,则两者的输出都是 true;如果不加上 @Inherited
,第二行语句输出 false,代表子类 PrimaryStudent 没有继承到 @ClassName
注解:
class Test {
@ClassName("学生类")
static class Student {}
static class PrimaryStudent extends Student {}
public static void main(String[] args) {
System.out.println(Student.class.isAnnotationPresent(ClassName.class));
System.out.println(PrimaryStudent.class.isAnnotationPresent(ClassName.class));
}
}
- 马俊昌 . Java编程的逻辑 . 机械工业出版社 . 2018-01-01