几个经常用到的通用Dorado基础类

1.Dorado中虽然提供了ViewModel的接口, 但是这是一个非常"肥"的接口, 对于客户程序来说很多东东都是用不着的, 于是将经常用到的方法进行了一下封装, 创建了一个更小的接口以便能将viewmodel的功能传递到其他地方使用, 当然出于某些需要, 又加了几个经常需要的方法.

/**
 * 将ViewModel中的getDateset()等方法抽取出来,以便在utils类的静态方法中调用ViewModel的getDataset()等方法
 * 
 * @author Macro Chen
 * @since May 6, 2008
 */
public interface IViewModelProvider extends IProvider {
	public ViewDataset getDataset(String datasetId);

	public Control getControl(String controlId) throws Exception;

	public int getState();

	public boolean isViewState();

	public boolean isViewState(int state);

	public MetaData properties();
}

2.下面的两个类一般联合起来和DBStatement的query(), queryForList()方法一起使用, 用来将通过jbbc取得的VariantSet类型的记录集转换成JavaBean类型的记录集

/**
 * 
 * 封装创建DBStatement,给statement的参数赋值和关闭DBStatement操作 具体是查询还是更新操作由子类实现
 * 
 * @author Macro Chen
 * @Dec 20, 2006
 * 
 */
public abstract class SqlExecutor {

	/**
	 * 公共操作（获取Statement和关闭之）
	 * 
	 * @param sql
	 * @return
	 * @throws Exception
	 */
	public Object execute(String sql) throws Exception {
		DBStatement stmt = DoradoUtils.getStatement(sql);
		try {
			ParameterSet p = stmt.parameters();
			return extract(stmt, p);
		} finally {
			stmt.close();
		}
	}

	/**
	 * 子类需要实现的CURD操作
	 * 
	 * @param stmt
	 * @param p
	 * @return
	 * @throws Exception
	 */
	public abstract Object extract(DBStatement stmt, ParameterSet p) throws Exception;
}

/**
 * 用来将VariantSet转换成JavaBean的接口
 * 
 * @author Macro Chen
 * @Dec 18, 2006
 *
 */
public interface RowConverter {
	public Object convert(VariantSet vs) throws SQLException;
}

3.DBStatement是Dorado中最常用的一个类, StatementDelegate这个封装类貌似用处不大, 本来主要是为了用方法的连写,后来发现经过格式化的连写代码比较难看.

/**
 * 对DBStatement做进一步的代理, 让设置参数的查询和更新更方便, 支持方法的连写
 * 
 * @author Macro Chen
 * @since Jun 19, 2008
 */
public class StatementDelegate extends DBStatement {
	public DBStatement getDBStatement() {
		return this;
	}

	public StatementDelegate addParameter(String name, Long value) {
		if (value == null) {
			this.parameters().setValue(name, value);
		} else {
			this.parameters().setLong(name, value);
		}
		return this;
	}

	public StatementDelegate addParameter(String name, Double value) {
		this.parameters().setDouble(name, value);
		return this;
	}

	public StatementDelegate addParameter(String name, String value) {
		this.parameters().setString(name, value);
		return this;
	}

	public StatementDelegate addParameter(String name, Integer value) {
		if (value == null) {
			this.parameters().setValue(name, value);
		} else {
			this.parameters().setInt(name, value);
		}
		return this;
	}

	public StatementDelegate setDateTime(String fieldName) {
		DoradoUtils.setDateTime(parameters(), fieldName);
		return this;
	}

	public StatementDelegate setPrimaryKey(long primaryKey) {
		addParameter("id", primaryKey);
		return this;
	}

	public StatementDelegate setPrimaryKey() {
		long primaryKey = IdentifierUtils.getPrimaryKey();

		addParameter("id", primaryKey);
		return this;
	}
}

4.这个是我比较常用到的一个类, 用了一个回调的模式, 用来处理在一个sql操作中调用其他的sql操作.后来发现它还有一个妙用, 就是封装一个不完全的查询, 丢到另一个查询中使用, 并注入剩下的查询条件

/**
 * 为了处理在调用setSql()的时候关闭正在使用的DBStatement, 将创建DBStatement延迟到使用的时候
 * 
 * @author Macro Chen
 * @since Jun 11, 2008
 */
public abstract class DBStatementCallback {

	public DBStatement getDBStatement() throws Exception {
		DBStatement stmt = DoradoUtils.getDBStatement(getSql());
		setParameters(stmt.parameters());
		return stmt;
	}

	protected abstract String getSql();

	protected abstract void setParameters(ParameterSet parameters);
}

/**
 * 针对只设置sql, 不设置parameter的情况
 * @author Macro Chen
 * @since Jun 11, 2008
 */
public abstract class SimpleDBStatementCallback extends DBStatementCallback {
	@Override
	protected void setParameters(ParameterSet parameters) {
	}

}