学步园

通过 DAOFactory 的泛型写法来演示Java泛型的特殊用法

小型项目中常常都没有用三方持久化框架，而大都是用公司或自行依据DAO模式封装的一些组件来完成数据库持久化动作，并且，通常为了更具可扩展性，常常使用抽象工厂模式来解耦合。

一、先看代码

1、简单工厂代码

/*****************************************************************************/<br /> /* Title: DAOFactory 1.0 */<br /> /* Description: DAOFactory 1.0 Java Source Code. */<br /> /* Copyright: Copyright(c) 2009 - CodingMouse, Inc. All rights are reserved. */<br /> /* Company: CodingMouse's Java R&D Studio */<br /> /* */<br /> /* Created in August 8, 2009 */<br /> /*****************************************************************************/<br /> package com.china.codingmouse.cmsdk4j.dao.factory;</p> <p>import java.io.Serializable;</p> <p>import com.china.codingmouse.cmsdk4j.config.CmSdk4jConfigurationReader;<br /> import com.china.codingmouse.cmsdk4j.dao.generaldao.GeneralDAO;<br /> import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;<br /> import com.china.codingmouse.cmsdk4j.dao.genericsdao.GenericsDAO;<br /> import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;<br /> import com.china.codingmouse.cmsdk4j.exception.GeneralException;</p> <p>/**<br /> * 数据访问工厂。<br><br><br /> *<br /> * 用于封装常规以及泛型数据访问动作实现的构建。<br /> * @param <T> 泛型类型参数。<br /> * @author CodingMouse<br /> * @version 1.0<br /> * @see AbstractDAOFactory<br /> * @since JDK1.5<br /> */<br /> public class DAOFactory<T extends Serializable> extends AbstractDAOFactory<T> {</p> <p> /**<br /> * 构建常规数据访问动作实例。<br /> * @return 常规数据访问动作接口实例。<br /> */<br /> @Override<br /> public IGeneralDAO buildGeneralDAO() {</p> <p> try {<br /> // 从配置档中读取常规数据访问动作实现类完全限定名<br /> String className = CmSdk4jConfigurationReader.getInstance().getBaseSetting(false).getGeneralDAOFullName();<br /> // 如果没有配置则返回默认实现类实例<br /> if (className == null<br /> || className.length() == 0)<br /> return new GeneralDAO();<br /> // 否则，将配置的实现类加载到虚拟机环境并通过默认构造器构建实例<br /> Object instance = Class.forName(className).newInstance();<br /> // 返回实现类实例<br /> return IGeneralDAO.class.cast(instance);<br /> } catch (Throwable e) {<br /> // 调试信息<br /> String debugMsg = "Configuration items <generaldao> the contents of the invalid, " +<br /> "can not be converted to the specified class interface " + IGeneralDAO.class.getName() + " instance.";<br /> // 抛出自定义异常<br /> throw new GeneralException(debugMsg, e);<br /> }</p> <p> }</p> <p> /**<br /> * 构建泛型数据访问动作实例。<br /> * @return 泛型数据访问动作接口实例。<br /> */<br /> @Override<br /> @SuppressWarnings("unchecked")<br /> public IGenericsDAO<T> buildGenericsDAO() {</p> <p> try {<br /> // 从配置档中读取常规数据访问动作实现类完全限定名<br /> String className = CmSdk4jConfigurationReader.getInstance().getBaseSetting(false).getGenericsDAOFullName();<br /> // 如果没有配置则返回默认实现类实例<br /> if (className == null<br /> || className.length() == 0)<br /> return new GenericsDAO<T>();<br /> // 否则，将配置的实现类加载到虚拟机环境并通过默认构造器构建实例<br /> Object instance = Class.forName(className).newInstance();<br /> // 返回实现类实例<br /> return IGenericsDAO.class.cast(instance);<br /> } catch (Throwable e) {<br /> // 调试信息<br /> String debugMsg = "Configuration items <genericsdao> the contents of the invalid, " +<br /> "can not be converted to the specified class interface " + IGenericsDAO.class.getName() + " instance.";<br /> // 抛出自定义异常<br /> throw new GeneralException(debugMsg, e);<br /> }</p> <p> }</p> <p>}<br />

2、抽象工厂代码

/*****************************************************************************/<br /> /* Title: AbstractDAOFactory 1.0 */<br /> /* Description: AbstractDAOFactory 1.0 Java Source Code. */<br /> /* Copyright: Copyright(c) 2009 - CodingMouse, Inc. All rights are reserved. */<br /> /* Company: CodingMouse's Java R&D Studio */<br /> /* */<br /> /* Created in August 8, 2009 */<br /> /*****************************************************************************/<br /> package com.china.codingmouse.cmsdk4j.dao.factory;</p> <p>import java.io.Serializable;</p> <p>import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;<br /> import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;</p> <p>/**<br /> * 抽象数据访问工厂。<br><br><br /> *<br /> * 用于封装数据访问工厂实现的构建。<br /> * @param <T> 泛型类型参数。<br /> * @author CodingMouse<br /> * @version 1.0<br /> * @see DAOFactory<br /> * @since JDK1.5<br /> */<br /> public abstract class AbstractDAOFactory<T extends Serializable> {</p> <p> /**<br /> * 获取抽象数据访问工厂实例。<br /> * @param <T> 泛型类型参数。<br /> * @return 抽象数据访问工厂实例。<br /> */<br /> public static<T extends Serializable> AbstractDAOFactory<T> newInstance() {<br /> return new DAOFactory<T>();<br /> }</p> <p> /**<br /> * 构建常规数据访问动作实例。<br /> * @return 常规数据访问动作接口实例。<br /> */<br /> public abstract IGeneralDAO buildGeneralDAO();</p> <p> /**<br /> * 构建泛型数据访问动作实例。<br /> * @return 泛型数据访问动作接口实例。<br /> */<br /> public abstract IGenericsDAO<T> buildGenericsDAO();</p> <p>}<br />

3、客户端代码

package com.china.codingmouse.cmsdk4j.example;</p> <p>import com.china.codingmouse.cmsdk4j.dao.factory.AbstractDAOFactory;<br /> import com.china.codingmouse.cmsdk4j.dao.factory.DAOFactory;<br /> import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;<br /> import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;<br /> import com.china.codingmouse.cmsdk4j.example.pojo.AccountPOJO;</p> <p>/**<br /> * 演示泛型/非泛型DAO工厂的创建。<br /> *<br /> * @author CodingMouse<br /> * @version 1.0<br /> * @see DAOFactory<br /> * @see AbstractDAOFactory<br /> * @since JDK1.5<br /> */<br /> public class TestFactory {</p> <p> public static void main(String[] args) {</p> <p> // 演示泛型DAO工厂的创建方法<br /> AbstractDAOFactory<AccountPOJO> factory = AbstractDAOFactory.newInstance();<br /> IGenericsDAO<AccountPOJO> dao = factory.buildGenericsDAO();<br /> AccountPOJO account = dao.get(AccountPOJO.class, 2);<br /> System.out.println(account);</p> <p> // 演示普通DAO工厂的创建方法<br /> IGeneralDAO dao2 = AbstractDAOFactory.newInstance().buildGeneralDAO();<br /> AccountPOJO account2 = (AccountPOJO) dao2.get(AccountPOJO.class, 1);<br /> System.out.println(account2);<br /> dao2.closePool();</p> <p> }</p> <p>}<br />

二、然后说明

1、简单工厂代码中使用反射机制构建外部指定的实现类来创建接口 IGeneralDAO 和 IGenericsDAO 的实例。这样以来，我们可以将工厂制造的产品类型放到外部来配置以降低耦合度。其中，有两个抽象方法实现，方法签名为 public IGeneralDAO buildGeneralDAO() 的这个方法没有使用泛型机制，而方法签名为 public IGenericsDAO<T> buildGenericsDAO() 的这个方法则使用了泛型机制。

2、抽象工厂代码中名为 newInstance 的静态方法使用了泛型机制。请注意泛型的写法。

/**<br /> * 获取抽象数据访问工厂实例。<br /> * @param <T> 泛型类型参数。<br /> * @return 抽象数据访问工厂实例。<br /> */<br /> public static<T extends Serializable> AbstractDAOFactory<T> newInstance() {<br /> return new DAOFactory<T>();<br /> }

3、客户端代码中则演示了用相同的抽象工厂，如何构建泛型和非泛型的方法。需要注意的是：

AbstractDAOFactory<AccountPOJO> factory = AbstractDAOFactory.newInstance();<br /> IGenericsDAO<AccountPOJO> dao = factory.buildGenericsDAO();

与下面这种写法是不一样的（这段代码无法通过编译，原因在于这时AbstractDAOFactory.newInstance().buildGenericsDAO()返回的是IGenericsDAO<Serializable> 类型，而非IGenericsDAO<AccountPOJO> ）：

IGenericsDAO<AccountPOJO> dao = AbstractDAOFactory.newInstance().buildGenericsDAO();

怎么样？感觉类似的写法，效果却大不相同。慢慢体会吧！

By CodingMouse

2010年1月11日