MyBatis配置文件(五)－－objectFactory对象工厂

我们在使用MyBatis执行查询语句的时候，通常都会有一个返回类型，这个是在mapper文件中给sql增加一个resultType(或resultMap)属性进行控制。resultType和resultMap都能控制返回类型，只要定义了这个配置就能自动返回我想要的结果，于是我就很纳闷这个自动过程的实现原理，想必大多数人刚开始的时候应该也有和我一样的困惑和好奇，那么今天我就把自己的研究分享一下。在JDBC中查询的结果会保存在一个结果集中，其实MyBatis也是这个原理，只不过MyBatis在创建结果集的时候，会使用其定义的对象工厂DefaultObjectFactory来完成对应的工作，下面来看一下其源代码：

一、默认对象工厂DefaultObjectFactory.java

 /**
  * @author Clinton Begin
  */
 public class DefaultObjectFactory implements ObjectFactory, Serializable {

   private static final long serialVersionUID = -8855120656740914948L;

   @Override
   public <T> T create(Class<T> type) {
     return create(type, null, null);
   }

   @SuppressWarnings("unchecked")
   @Override
   public <T> T create(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs) {
     Class<?> classToCreate = resolveInterface(type);
     // we know types are assignable
     return (T) instantiateClass(classToCreate, constructorArgTypes, constructorArgs);
   }

   @Override
   public void setProperties(Properties properties) {
     // no props for default
   }

   private  <T> T instantiateClass(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs) {
     try {
       Constructor<T> constructor;
       if (constructorArgTypes == null || constructorArgs == null) {
         constructor = type.getDeclaredConstructor();
         if (!constructor.isAccessible()) {
           constructor.setAccessible(true);
         }
         return constructor.newInstance();
       }
       constructor = type.getDeclaredConstructor(constructorArgTypes.toArray(new Class[constructorArgTypes.size()]));
       if (!constructor.isAccessible()) {
         constructor.setAccessible(true);
       }
       return constructor.newInstance(constructorArgs.toArray(new Object[constructorArgs.size()]));
     } catch (Exception e) {
       StringBuilder argTypes = new StringBuilder();
       if (constructorArgTypes != null && !constructorArgTypes.isEmpty()) {
         for (Class<?> argType : constructorArgTypes) {
           argTypes.append(argType.getSimpleName());
           argTypes.append(",");
         }
         argTypes.deleteCharAt(argTypes.length() - 1); // remove trailing ,
       }
       StringBuilder argValues = new StringBuilder();
       if (constructorArgs != null && !constructorArgs.isEmpty()) {
         for (Object argValue : constructorArgs) {
           argValues.append(String.valueOf(argValue));
           argValues.append(",");
         }
         argValues.deleteCharAt(argValues.length() - 1); // remove trailing ,
       }
       throw new ReflectionException("Error instantiating " + type + " with invalid types (" + argTypes + ") or values (" + argValues + "). Cause: " + e, e);
     }
   }

   protected Class<?> resolveInterface(Class<?> type) {
     Class<?> classToCreate;
     if (type == List.class || type == Collection.class || type == Iterable.class) {
       classToCreate = ArrayList.class;
     } else if (type == Map.class) {
       classToCreate = HashMap.class;
     } else if (type == SortedSet.class) { // issue #510 Collections Support
       classToCreate = TreeSet.class;
     } else if (type == Set.class) {
       classToCreate = HashSet.class;
     } else {
       classToCreate = type;
     }
     return classToCreate;
   }

   @Override
   public <T> boolean isCollection(Class<T> type) {
     return Collection.class.isAssignableFrom(type);
   }

 }

在这个类中有6个方法：

1⃣️create(Class<T> type)：这个方法我认为是创建结果集的方法，但它其实是直接调用了第二个create方法，只不过后两个参数传的是null，所以直接看下面的方法；

2⃣️create(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs)：这个方法中传了三个参数，分别应该是返回的结果集类型、此类构造函数参数类型、此类构造函数参数值。从它的内部实现来看，首先调用了下面的resolveInterface方法获取返回类型，其次调用instantiateClass方法实例化出我们所需的结果集；

3⃣️setProperties(Properties properties)：这个方法是用来设置一些配置信息，比如我们给objectFactory定义一个property子元素时，就是通过这个方法进行配置的；

4⃣️instantiateClass(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs)：此方法是用来实例化一个类，需要实例化的类型是通过下面的resolveInterface方法决定，从内部实现来看，这个实例化过程是通过反射实现的；

5⃣️resolveInterface(Class<?> type）：此方法是用来对集合类型进行处理，即如果我们定义一个resultType为集合类型，那么它就会根据这个类型决定出即将创建的结果集类型；

6⃣️isCollection(Class<T> type)：这个方法是用来判断我们配置的类型是不是一个集合。比如如果返回多条数据，但是我们配置resultType是个普通类，那么在执行过程中就会报错；

以上就是MyBatis默认objectFactory中的具体实现，通过它来创建我们配置的结果集，一般情况下都会使用默认的对象工厂，但是我们也可以自定义一个，只要继承DefaultObjectFactory.java即可。

二、自定义一个对象工厂MyObjectFactory.java

 package com.daily.objectfactory;

 import java.util.List;
 import java.util.Properties;

 import org.apache.ibatis.reflection.factory.DefaultObjectFactory;

 public class MyObjectFactory extends DefaultObjectFactory{

     private static final long serialVersionUID = 1L;

     @Override
     public void setProperties(Properties properties) {
         super.setProperties(properties);
         System.out.println("初始化参数：［"+properties.toString()+"]");
     }

     @Override
     public <T> T create(Class<T> type,List<Class<?>> constructorArgTypes,List<Object> constructorArgs) {
         T result = super.create(type, constructorArgTypes, constructorArgs);
         System.out.println("创建对象方法："+result.getClass().getSimpleName());
         return result;
     }

     @Override
     public <T> boolean isCollection(Class<T> type) {
         return super.isCollection(type);
     }

 }

其实我们自定义的时候只要重写其中的create方法就可以，至于选择哪个，其实两个都行，因为第一个方法内部还是调用了第二个，我在这里调用了第二个，还重写了setProperties方法，用来查看其作用。

下面据一个例子来查看怎么使用自定义的objectFactory

第一步：配置

在mybatis-config.xml中做如下配置，并自定义一个property子元素，设置其name和value

 <!--对象工厂 -->
     <objectFactory type="com.daily.objectfactory.MyObjectFactory">
         <property name="prop1" value="value1"/>
     </objectFactory>

第二步：配置查询映射器接口和sql

接口：

 //获取所有的产品
 public List<Product> getAllProduct();

sql:

 <select id="getAllProduct"resultMap="BaseResultMap">
         SELECT * FROM product
3 </select>

在上面的代码中，接口返回的是一个List，而其中的元素是Product类，sql定义返回的结果集是一个BaseResultMap，其定义如下：

 <resultMap id="BaseResultMap" type="com.daily.pojo.Product">
         <id column="id" jdbcType="VARCHAR" property="id" />
         <result column="product_name" jdbcType="VARCHAR" property="productName" />
         <result column="product_price" jdbcType="VARCHAR" property="productPrice" />
         <result column="product_type" jdbcType="VARCHAR" property="productType" />
 </resultMap>

它们都在同一个mapper.xml文件中.

第三步：打印查询结果

 // 获取商品列表
     public void getProductList() {
         List<Product> productList = productService.getProductList();
         for (Product product : productList) {
             System.out.println(product.getProductName());
         }
     }

获取到商品列表之后进行遍历并打印名称

第四步：查询结果

 初始化参数：［{prop1=value1}]
 创建对象方法：ArrayList
 创建对象方法：Product
 创建对象方法：Product
 创建对象方法：Product
 创建对象方法：Product
 衬衫
 卫衣
 连衣裙
 连衣裙

从执行结果来看，创建结果集的步骤如下：

1⃣️首先进行初始化参数，也就是根据objectFactory中的配置；

2⃣️然后创建了一个ArrayList对象；

3⃣️再创建四个Product对象（注意：查询结果有几条就创建几个 ）；

4⃣️将四个对象设置到ArrayList中封装成我们需要的返回类型List；

按照我的理解，mybatis创建结果集的过程是这样的：首先根据sql执行的结果，即返回条数判断是不是一个集合类型，然后将每条结果实例化成一个对象，如果前面判断返回的是多条，则将这些对象设置到一个List中，否则就是一个单独的对象，然后根据我们在映射器接口中定义的返回类型进行适配，如果接口定义返回List就返回List，如果接口定义返回一个单独的类型，则返回实例化的对象。后来仔细一想不对呀，这样的话如果查询结果是一条，但是我在接口中定义的返回类型是List，那岂不是冲突了？为了研究这个创建过程，我又写了两个查询接口，一个只返回一个对象，一个查询所有但返回一个对象（这个按理说是不对的，主要看看mybatis会报什么错），然后在DefaultObjectFactory中打断点进行调试，下面介绍我的实验过程：

第一步：再创建两个查询接口

1⃣️根据ID查询

 //查询接口
 public Product selectById(String id);

sql配置

 <select id="selectById" parameterType="String" resultType="product">
         SELECT * FROM product p WHERE p.id = #{id,jdbcType=VARCHAR}
 </select>

这个是根据ID查询，返回类型是Product

2⃣️查询所有

 public Product getAllProducts();

sql配置

 <select id="getAllProducts" resultType="product">
         SELECT * FROM product
 </select>

这个是查询所有，但返回类型是Product，即一个对象

第二步：对三种情况打断点进行调试

在调试过程中我发现以下几点：

1、在获取SQL session对象的过程中就已经调用了DefaultObjectFactory中的setProperties方法，其实这个不难理解，毕竟在获取SQL session之前就已经加载了mybatis的配置文件，首先当然要进行配置；

2、然后会进入到DefaultObjectFactory中的isCollection方法，而传给它的参数类型就是我在映射器接口中定义的返回类型；

3、不管查询出多少条数据，也不管返回类型是什么，首先都会调用create方法创建一个ArrayList对象；

4、查询出多少条数据，就会调用多少次create方法，将一条数据封装成一个类并进行实例化；

以上是三种不同的查询结果都会执行的步骤，其他的中间还有很复杂的创建过程，根据我有限的理解，推断出mybatis在创建结果集的过程如下：

1⃣️先判断接口返回的类型是一个单独的类还是一个集合；

2⃣️创建一个ArrayList对象；

3⃣️将每个查询结果实例化成一个对象，然后设置到ArrayList对象中；

4⃣️如果在第一步中接口返回的是单独的类，此时查看第三步封装的结果，如果只有一条数据，则获取对象并返回；如果有多条，则报错；

如果在第一步中接口返回的是一个集合，则直接返回第三步封装的结果；

其实所谓结果集，必定是个集合，所以才会有创建ArrayList并将实例化的对象添加在其中这一步，至于怎么返回就要看接口中的定义了，如果mybatis能根据接口定义返回指定类型，则没有任何问题，否则就会报错，就像上面的第三种情况，封装的结果集是个含多个product对象的集合，但是接口中定义只要一个对象，那这时候mybatis就不知道给哪个合适，所以只能报错了。

以上就是我对objectFactory这个配置项的理解，不正确的地方希望看到文章的你能给予指正，谢了～～