JadePool作为简化JDBC编程工具,提供主键生成方法是必须的。在JadePool中,ProcessVO用于事务型数据库的DML操作,Access用于非事务型数据库的DML操作,Access参照ProcessVO实现。
目前,JadePool只提供了单主键的键值生成方法,没有提供复合主键的生成方法。这里以ProcessVO为例。ProcessVO提供了三个插入主键的方法,分别是:
[plain]
public Long insertKey(String tableName);
public Object insertAutoKey(String tableName);
public String insertKey(String tableName, String keyValue);
参数tableName是表的名称,虽然没有提供XML映射、注入映射,但创建ProcessVO对象时,通过实例化DbCenter的某一个实例,数据库的结构信息已经被保存在该实例的相关属性中。在tableName表中,哪一个字段是主键,该字段有哪些属性,这些信息均可以通过访问DbCenter的实例得到。
一、长整形主键键值生成策略
调用insertKey(String tableName)插入长整形键值。
insertKey在多例模式的某一个实例中实现,取值范围是系统时间*10000+[0~9999]。在这个取值范围内,按照从小到大的方向,通过递归唯一性验证的方式获取第一个符合条件的值。用户在使用JadePool时,应当注意,一个数据库只使用DbCenter的一个实例。
一个数据库只使用DbCenter的一个实例,这同使用单例模式的效果是相同的。
插入主键的过程是这样的,ProcessVO的对象向DbCenter的实例请求插入主键键值,DbCenter的实例通过调用自身管理的Table对象的方法makeLongKeyValue()计算唯一性的主键值, 将结果返回给DbCenter的实例,逐步返回给ProcessVO对象。
在Table对象中,makeLongKeyValue()方法调用了一个递归方法onlyLongValue(),用于确保返回的键值是唯一的。
[plain]
ProcessVO DbCenter
| |
| |
| |
insertKey------------->|
| |
| getTable(tableName).makeLongKeyValue()
| |
|<------------------|
| |
| |
具体的实现,参阅源代码
[java]
/**
* Make long KeyValue
*
* @return System.currentTimeMillis*10000+Num, the Num is between 0 and
* 9999;for example :2012-11-01 HH:mm:ss as
* 1351749144390,getting:13517491443897256
*/
synchronized public long makeLongKeyValue() {
long t = System.currentTimeMillis();
return onlyLongValue(t, 0);//only value//递归,直到不等
}
private long onlyLongValue(long time, long add) {
long v;
long len = 10000;
long k = time * len + add;
if (k > lastMakeLongKeyValue) {
lastMakeLongKeyValue = k;
v = k;
} else {
add++;
if (add > 9999) {
v = onlyLongValue(time + 1, 0);
} else {
v = onlyLongValue(time, add);
}
}
return v;
}
有关主键生成策略的话题很多,较有代表性的提法是用系统时间加随机数作为键值,这种方式产生的结果会导致键值不能按照时间的先后排列,如果按照主键键值的大小顺序排队买火车票,这种方式就不合理了。
二、通用键值生成器
调用insertAutoKey(String tableName)可以插入Long、Integer、Short、Double、Float以及String类型的主键键值。除了String类型有一定的条件限制外,其它类型的主键键值均是在原表中最大主键值得基础上加1或更大的数所得。生成过程与长整形主键生成的过程相同,同样经过递归唯一性验证。
具体的实现,参阅源代码
[java]
/**
* @param field
* @param fieldValue 从数据库中查询的最大值 生成各种类型的第一个主键值
*/
synchronized public Object makeObjectKeyValue(Field field, Object fieldValue) throws SQLException {
String className = field.getTypeClassName();
Object nextValue = null;
if (fieldValue != null && !"".equals(fieldValue.toString())) {
if (className.equals("java.lang.Long")) {
if (((Long) fieldValue).longValue() == Long.MAX_VALUE) {
throw new SQLException("Long value must less than Long.MAX_VALUE " + Long.MAX_VALUE);
}
nextValue = new Long(((Long) fieldValue).longValue() + 1);
}
if (className.equals("java.lang.Integer")) {
if (((Integer) fieldValue).intValue() == Integer.MAX_VALUE) {
throw new SQLException("Integer value must less than Integer.MAX_VALUE " + Integer.MAX_VALUE);
}
nextValue = new Integer(((Integer) fieldValue).intValue() + 1);
}
if (className.equals("java.lang.Short")) {
if (((Short) fieldValue).shortValue() == Short.MAX_VALUE) {
throw new SQLException("Short value must less than Short.MAX_VALUE " + Short.MAX_VALUE);
}
short v = ((Short) fieldValue).shortValue();
v++;
nextValue = new Short(v);
}