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

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

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

一、先看代码

1、简单工厂代码

/*****************************************************************************/
/* Title: DAOFactory 1.0                                                     */
/* Description: DAOFactory 1.0 Java Source Code.                             */
/* Copyright: Copyright(c) 2009 - CodingMouse, Inc. All rights are reserved. */
/* Company: CodingMouse's Java R&D Studio                                    */
/*                                                                           */
/* Created in August 8, 2009                                                 */
/*****************************************************************************/
package com.china.codingmouse.cmsdk4j.dao.factory;

import java.io.Serializable;

import com.china.codingmouse.cmsdk4j.config.CmSdk4jConfigurationReader;
import com.china.codingmouse.cmsdk4j.dao.generaldao.GeneralDAO;
import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;
import com.china.codingmouse.cmsdk4j.dao.genericsdao.GenericsDAO;
import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;
import com.china.codingmouse.cmsdk4j.exception.GeneralException;

/**
* 数据访问工厂。<br><br>
*
* 用于封装常规以及泛型数据访问动作实现的构建。
* @param <T> 泛型类型参数。
* @author CodingMouse
* @version 1.0
* @see AbstractDAOFactory
* @since JDK1.5
*/
public class DAOFactory<T extends Serializable> extends AbstractDAOFactory<T> {

/**
* 构建常规数据访问动作实例。
* @return 常规数据访问动作接口实例。
*/
@Override
public IGeneralDAO buildGeneralDAO() {

try {
// 从配置档中读取常规数据访问动作实现类完全限定名
String className = CmSdk4jConfigurationReader.getInstance().getBaseSetting(false).getGeneralDAOFullName();
// 如果没有配置则返回默认实现类实例
if (className == null
|| className.length() == 0)
return new GeneralDAO();
// 否则，将配置的实现类加载到虚拟机环境并通过默认构造器构建实例
Object instance = Class.forName(className).newInstance();
// 返回实现类实例
return IGeneralDAO.class.cast(instance);
} catch (Throwable e) {
// 调试信息
String debugMsg = "Configuration items <generaldao> the contents of the invalid, " +
"can not be converted to the specified class interface " + IGeneralDAO.class.getName() + " instance.";
// 抛出自定义异常
throw new GeneralException(debugMsg, e);
}

}

/**
* 构建泛型数据访问动作实例。
* @return 泛型数据访问动作接口实例。
*/
@Override
@SuppressWarnings("unchecked")
public IGenericsDAO<T> buildGenericsDAO() {

try {
// 从配置档中读取常规数据访问动作实现类完全限定名
String className = CmSdk4jConfigurationReader.getInstance().getBaseSetting(false).getGenericsDAOFullName();
// 如果没有配置则返回默认实现类实例
if (className == null
|| className.length() == 0)
return new GenericsDAO<T>();
// 否则，将配置的实现类加载到虚拟机环境并通过默认构造器构建实例
Object instance = Class.forName(className).newInstance();
// 返回实现类实例
return IGenericsDAO.class.cast(instance);
} catch (Throwable e) {
// 调试信息
String debugMsg = "Configuration items <genericsdao> the contents of the invalid, " +
"can not be converted to the specified class interface " + IGenericsDAO.class.getName() + " instance.";
// 抛出自定义异常
throw new GeneralException(debugMsg, e);
}

}

}

2、抽象工厂代码

/*****************************************************************************/
/* Title: AbstractDAOFactory 1.0                                             */
/* Description: AbstractDAOFactory 1.0 Java Source Code.                     */
/* Copyright: Copyright(c) 2009 - CodingMouse, Inc. All rights are reserved. */
/* Company: CodingMouse's Java R&D Studio                                    */
/*                                                                           */
/* Created in August 8, 2009                                                 */
/*****************************************************************************/
package com.china.codingmouse.cmsdk4j.dao.factory;

import java.io.Serializable;

import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;
import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;

/**
* 抽象数据访问工厂。<br><br>
*
* 用于封装数据访问工厂实现的构建。
* @param <T> 泛型类型参数。
* @author CodingMouse
* @version 1.0
* @see DAOFactory
* @since JDK1.5
*/
public abstract class AbstractDAOFactory<T extends Serializable>  {

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

/**
* 构建常规数据访问动作实例。
* @return 常规数据访问动作接口实例。
*/
public abstract IGeneralDAO buildGeneralDAO();

/**
* 构建泛型数据访问动作实例。
* @return 泛型数据访问动作接口实例。
*/
public abstract IGenericsDAO<T> buildGenericsDAO();

}

3、客户端代码

package com.china.codingmouse.cmsdk4j.example;

import com.china.codingmouse.cmsdk4j.dao.factory.AbstractDAOFactory;
import com.china.codingmouse.cmsdk4j.dao.factory.DAOFactory;
import com.china.codingmouse.cmsdk4j.dao.generaldao.IGeneralDAO;
import com.china.codingmouse.cmsdk4j.dao.genericsdao.IGenericsDAO;
import com.china.codingmouse.cmsdk4j.example.pojo.AccountPOJO;

/**
* 演示泛型/非泛型DAO工厂的创建。
*
* @author CodingMouse
* @version 1.0
* @see DAOFactory
* @see AbstractDAOFactory
* @since JDK1.5
*/
public class TestFactory {

public static void main(String[] args) {

// 演示泛型DAO工厂的创建方法
AbstractDAOFactory<AccountPOJO> factory = AbstractDAOFactory.newInstance();
IGenericsDAO<AccountPOJO> dao = factory.buildGenericsDAO();
AccountPOJO account = dao.get(AccountPOJO.class, 2);
System.out.println(account);

// 演示普通DAO工厂的创建方法
IGeneralDAO dao2 = AbstractDAOFactory.newInstance().buildGeneralDAO();
AccountPOJO account2 = (AccountPOJO) dao2.get(AccountPOJO.class, 1);
System.out.println(account2);
dao2.closePool();

}

}

二、然后说明

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

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

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

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

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

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

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

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

By CodingMouse

2010年1月11日