文章506
标签266
分类65

Java的内省技术

以前知道Java中的反射, 也学习过一些和反射相关的内容. 今天看到了一个叫内省(IntroSpector)的技术, 所以就总结一下

本文内容包括:

  • 什么是内省(IntroSpector)
  • 内省的作用
  • 内省和反射的区别
  • 如何使用内省
  • 内省的例子
  • beanutils工具包使用

源代码: https://github.com/JasonkayZK/Java_Samples/tree/java-introspector

如果觉得文章写的不错, 可以关注微信公众号: Coder张小凯

内容和博客同步更新~


Java的内省技术


什么是内省

内省: 计算机程序在运行时(Runtime)检查对象(Object)类型的一种能力, 通常也可以称作运行时类型检查


注意: 不应该将内省和反射混淆

相对于内省,反射更进一步: 计算机程序在运行时(Runtime)可以访问、检测和修改它本身状态或行为的一种能力

简单来说就是: 内省只能访问、用,而反射甚至可以更改(而且内省是通过反射实现的!)


内省的作用

内省是操作JavaBean 的 API,用来访问某个属性的 getter/setter 方法

对于一个标准的 javaBean 来说,它包括属性、get 方法和 set 方法,这是一个约定俗成的规范


内省和反射的区别

紧接着上面说的:

  • 反射: 在运行状态把Java类中的各种成分映射成相应的Java类(Method, Class等),可以动态的获取所有的属性以及动态调用任意一个方法,强调的是运行状态
  • 内省: Java 语言针对 Bean 类属性、事件的一种缺省处理方法, 并且内省机制是通过反射来实现的: BeanInfo用来暴露一个bean的属性、方法和事件,以后我们就可以操纵该JavaBean的属性

如何使用内省

Java 中提供了一套 API 用来访问某个属性的 getter/setter 方法,通过这些 API 可以使你不需要了解这个规则(但你最好还是要搞清楚),这些 API 存放于包java.beans中:

  • 核心类是 Introspector, 它提供了的 getBeanInfo 系类方法,可以拿到一个 JavaBean 的所有信息
  • 通过 BeanInfogetPropertyDescriptors 方法和 getMethodDescriptors 方法可以拿到 javaBean 的字段信息列表和 getter 和 setter 方法信息列表
  • PropertyDescriptors 可以根据字段直接获得该字段的 getter 和 setter 方法
  • MethodDescriptors 可以获得方法的元信息,比如方法名,参数个数,参数字段类型等
  • 然后通过反射机制来调用这些方法

以上就是在Java内省中用到的几个类, 以及内省的流程


实例

创建实体类

JavaBean: Person.java

/**
 * JavaBean
 *
 * @author zk
 */
public class Person {

    private String name;

    private String password;

    private int age;

    private Date birthday;

    /**
     * 此时gender也是Bean中的一个属性!
     *
     * @return gender
     */
    public String getGender() {
        return "Unknown";
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }
}

注意: 尽管gender字段没有被声明, 但是存在他的getter方法!

使用内省API操作bean的属性

IntrospectorDemo1.java

/**
 * 直接使用JDK自带API操作Bean
 *
 * @author zk
 */
public class IntrospectorDemo1 {

    /**
     * 得到bean的所有属性
     */
    public static void getAllAttribute() throws Exception {
        // 不自省从父类继承的属性
        BeanInfo info = Introspector.getBeanInfo(Person.class, Object.class);
        // 取得属性描述器
        PropertyDescriptor[] pds = info.getPropertyDescriptors();
        for (PropertyDescriptor pd : pds) {
            System.out.println(pd.getName());
        }
    }

    /**
     * 操纵bean的指定属性
     */
    public static void manipulateAttributeTest() throws Exception {
        Person p = new Person();
        PropertyDescriptor pd = new PropertyDescriptor("age", Person.class);

        // 得到属性的写方法,为属性赋值
        // setAge
        Method method = pd.getWriteMethod();
        method.invoke(p, 24);

        // 获取属性的值
        // getAge()
        method = pd.getReadMethod();
        System.out.println(method.invoke(p));
    }

    /**
     * 获取当前操作的属性的类型
     */
    public static void readAttributeTypeTest() throws Exception {
        PropertyDescriptor pd = new PropertyDescriptor("age", Person.class);
        System.out.println(pd.getPropertyType());
    }

    public static void main(String[] args) throws Exception {
        // age
        // birthday
        // gender
        // name
        // password
        getAllAttribute();

        // 24
        manipulateAttributeTest();

        // int
        readAttributeTypeTest();
    }
}

需要注意的是:

  • ① gender也被作为了Bean中的属性(因为含有getter方法);
  • ② manipulateAttributeTest()方法的确修改了age属性的值;
  • ③ readAttributeTypeTest()方法取得了age所声明的属性类型;

以上的操作略显繁琐, 所以Apache组织开发了一套用于操作JavaBean的API: commons-beanutils

这套API考虑到了很多实际开发中的应用场景,因此在实际开发中很多程序员使用这套API操作JavaBean,以简化程序代码的编写


beanutils工具包使用

Maven依赖:

<dependency>
    <groupId>commons-beanutils</groupId>
    <artifactId>commons-beanutils</artifactId>
    <version>1.9.4</version>
</dependency>

Beanutils工具包的常用类和方法:

  • BeanUtils
  • PropertyUtils
  • ConvertUtils.regsiter(Converter convert, Class clazz)

例子:

① setProperty(): 对bean中的某个属性进行赋值

Person p = new Person();
BeanUtils.setProperty(p, "name", "jasonkay");
// jasonkay
System.out.println(p.getName());

② 自定义转换器

因为用户提交的1994-10-12是个字符串,而bean中的birthday是个Date类型的属性,由于String类型自动转化仅限于8种基本类型,所以无法直接将字符串转换为Date

这就需要我们自定义一个转换器:

通过ConvertUtils.regsiter(Converter convert, Class clazz)方法

Person p = new Person();
// 模拟用户提交的表单
String name = "jasonkay";
String password = "123";
String age = "23";
String birthday = "1996-07-27";

// 给BeanUtils注册一个日期转换器
ConvertUtils.register(new Converter() {
    @Override
    public <T> T convert(Class<T> aClass, Object value) {
        if (value == null) {
            return null;
        }
        if (!(value instanceof String)) {
            throw new ConversionException("只支持String类型的转换!");
        }
        String str = (String) value;
        if ("".equals(str.trim())) {
            return null;
        }

        SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd");
        try {
            return (T) df.parse(str);
        } catch (ParseException e) {
            // 异常链不能断
            throw new RuntimeException(e);
        }
    }
}, Date.class);

// 封装到p对象中
BeanUtils.setProperty(p, "name", name);
BeanUtils.setProperty(p, "password", password);
// 自动将数据转换为基本类型
BeanUtils.setProperty(p, "age", age);
// 通过自定义Converter转换
BeanUtils.setProperty(p, "birthday", birthday);

// jasonkay
// 123
// 23
// Sat Jul 27 00:00:00 CST 1996
System.out.println(p.getName());
System.out.println(p.getPassword());
System.out.println(p.getAge());
System.out.println(p.getBirthday());

在调用setProperty()方法之前, 通过ConvertUtils.regsiter()方法注册了一个转换器, 实现从String -> java.util.Date的转换

此后调用BeanUtils.setProperty()方法:

  • BeanUtils.setProperty(p, “age”, age): 自动将数据转换为基本类型
  • BeanUtils.setProperty(p, “birthday”, birthday): 通过自定义Converter转换

补充: 也可以使用API中自带的转换器: DateLocaleConverter


③ BeanUtils.populate(): 用map集合中的值填充bean的属性

Map<String, String> map = new HashMap<>(16);
map.put("name","jasonkay");
map.put("password","123");
map.put("age","23");
map.put("birthday","1996-07-27");

// 给BeanUtils注册一个日期转换器
registDateConverter();

Person bean = new Person();
// 用map集合中的值填充bean的属性
BeanUtils.populate(bean, map);

// jasonkay
// 123
// 23
// Sat Jul 27 00:00:00 CST 1996
System.out.println(bean.getName());
System.out.println(bean.getPassword());
System.out.println(bean.getAge());
System.out.println(bean.getBirthday());

其中registDateConverter()方法既是注册了一个转换器


以上代码源码见: https://github.com/JasonkayZK/Java_Samples/tree/java-introspector


总结

内省是基于反射实现的,主要用来操作JavaBean(可以认为是简化通过反射来操作JavaBean),通过内省可以很方便的动态获得bean的set/get方法,属性,方法名


附录

源代码: https://github.com/JasonkayZK/Java_Samples/tree/java-introspector

文章参考:



本文作者:Jasonkay
本文链接:https://jasonkayzk.github.io/2020/03/02/Java的内省技术/
版权声明:本文采用 CC BY-NC-SA 3.0 CN 协议进行许可