9 Commits
1.4.1 ... 1.7.2

11 changed files with 323 additions and 51 deletions

View File

@@ -8,7 +8,7 @@
使用方法: 使用方法:
+ 在项目中放置jar包的地方把seq-1.4.1.jar、seq-1.4.1-sources.jar、seq-1.4.1-pom.xml复制过去 + 在项目中放置jar包的地方把seq-1.7.2.jar、seq-1.7.2-sources.jar、seq-1.7.2-pom.xml复制过去
+ 在pom.xml中增加以下内容然后执行maven命令mvn clean + 在pom.xml中增加以下内容然后执行maven命令mvn clean
```xml ```xml
@@ -18,7 +18,7 @@
<dependency> <dependency>
<groupId>com.yanghuanglin</groupId> <groupId>com.yanghuanglin</groupId>
<artifactId>seq</artifactId> <artifactId>seq</artifactId>
<version>1.4.1</version> <version>1.7.2</version>
<exclusions> <exclusions>
<!-- 如若你项目中有引用spring-jdbc则需要排除seq的jdbc依赖 --> <!-- 如若你项目中有引用spring-jdbc则需要排除seq的jdbc依赖 -->
<exclusion> <exclusion>
@@ -50,13 +50,13 @@
</goals> </goals>
<configuration> <configuration>
<!-- ${project.basedir}表示当前项目的根目录 --> <!-- ${project.basedir}表示当前项目的根目录 -->
<file>${project.basedir}/lib/seq-1.4.1.jar</file> <file>${project.basedir}/lib/seq-1.7.2.jar</file>
<pomFile>${pom.basedir}/lib/seq-1.4.1-pom.xml</pomFile> <pomFile>${project.basedir}/lib/seq-1.7.2-pom.xml</pomFile>
<sources>${project.basedir}/lib/seq-1.4.1-sources.jar</sources> <sources>${project.basedir}/lib/seq-1.7.2-sources.jar</sources>
<repositoryLayout>default</repositoryLayout> <repositoryLayout>default</repositoryLayout>
<groupId>com.yanghuanglin</groupId> <groupId>com.yanghuanglin</groupId>
<artifactId>seq</artifactId> <artifactId>seq</artifactId>
<version>1.4.1</version> <version>1.7.2</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<generatePom>true</generatePom> <generatePom>true</generatePom>
</configuration> </configuration>
@@ -461,6 +461,17 @@ public interface Generator {
*/ */
boolean lock(Sequences sequences); boolean lock(Sequences sequences);
/**
* 忽略{@link Sequences#getSeq()} ,仅通过{@link Sequences#getKey()}和{@link Sequences#getType()}来锁定序号。
* <p/>
* 如果ignoreSeq为false则等价于{@link #lock(Sequences)}
*
* @param sequences 需要锁定的序号
* @param ignoreSeq 是否忽略序号
* @return 锁定结果
*/
boolean lock(Sequences sequences, boolean ignoreSeq);
/** /**
* 释放所有未使用的序号 * 释放所有未使用的序号
* <p/> * <p/>
@@ -478,12 +489,61 @@ public interface Generator {
*/ */
void release(Date begin, Date end); void release(Date begin, Date end);
/**
* 释放从开始时间开始,到现在时间之间未使用的序号。结束时间为方法执行时的时间
*
* @param begin 开始时间
*/
void releaseAfter(Date begin);
/**
* 释放结束时间以前的序号
*
* @param end 结束时间
*/
void releaseBefore(Date end);
/** /**
* 释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。 * 释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。
* *
* @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象 * @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象
*/ */
void release(Sequences sequences); void release(Sequences sequences);
/**
* 忽略{@link Sequences#getSeq()}来释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。
* <p/>
* 如果ignoreSeq为false则等价于{@link #release(Sequences)}
*
* @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象
* @param ignoreSeq 是否忽略序号
*/
void release(Sequences sequences, boolean ignoreSeq);
/**
* 清空所有闲置序号和未锁定序号
*/
void clear();
/**
* 清空指定时间段内闲置序号和未锁定序号
*/
void clear(Date begin, Date end);
/**
* 清空从开始时间到限制时间之间闲置序号和未锁定序号,结束时间为方法执行时的时间
*
* @param begin 开始时间
*/
void clearAfter(Date begin);
/**
* 清空结束时间之前的限制序号和未锁定序号
*
* @param end 结束时间
*/
void clearBefore(Date end);
} }
``` ```

View File

@@ -4,7 +4,7 @@
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>com.yanghuanglin</groupId> <groupId>com.yanghuanglin</groupId>
<artifactId>seq</artifactId> <artifactId>seq</artifactId>
<version>1.4.1</version> <version>1.7.2</version>
<name>seq</name> <name>seq</name>
<description>seq</description> <description>seq</description>
<properties> <properties>
@@ -24,7 +24,7 @@
<dependency> <dependency>
<groupId>junit</groupId> <groupId>junit</groupId>
<artifactId>junit</artifactId> <artifactId>junit</artifactId>
<version>4.12</version> <version>4.13.2</version>
<scope>test</scope> <scope>test</scope>
</dependency> </dependency>
</dependencies> </dependencies>

View File

@@ -2,6 +2,7 @@ package com.yanghuanglin.seq.dao;
import com.yanghuanglin.seq.po.SequencesUnused; import com.yanghuanglin.seq.po.SequencesUnused;
import java.util.Date;
import java.util.List; import java.util.List;
/** /**
@@ -36,4 +37,14 @@ public interface SequencesUnusedDao {
boolean saveBatch(List<SequencesUnused> sequencesUnusedList); boolean saveBatch(List<SequencesUnused> sequencesUnusedList);
void createTable(); void createTable();
/**
* 删除所有闲置的序号
*/
boolean deleteAll();
/**
* 删除指定时间段内使用中的序号
*/
boolean deleteByDate(Date begin, Date end);
} }

View File

@@ -57,9 +57,9 @@ public class SequencesDaoImpl implements SequencesDao {
@Override @Override
public void createTable() { public void createTable() {
String sql = "CREATE TABLE IF NOT EXISTS `%s` ( " + String sql = "CREATE TABLE IF NOT EXISTS `%s` ( " +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号英文名称'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号英文名称'," +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号类型'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号类型'," +
" `%s` BIGINT ( 2 ) NOT NULL COMMENT '已使用到的序号'," + " `%s` BIGINT ( 20 ) NOT NULL COMMENT '已使用到的序号'," +
" PRIMARY KEY ( `%s`, `%s` ) " + " PRIMARY KEY ( `%s`, `%s` ) " +
" ) COMMENT '当前序号表'"; " ) COMMENT '当前序号表'";
sql = String.format(sql, tableConfig.getTable(), sql = String.format(sql, tableConfig.getTable(),

View File

@@ -33,10 +33,15 @@ public class SequencesUnlockDaoImpl implements SequencesUnlockDao {
@Override @Override
public boolean delete(SequencesUnlock sequencesUnlock) { public boolean delete(SequencesUnlock sequencesUnlock) {
String sql = "delete from `%s_unlock` where `%s`=? and `%s`=? and `%s`=?"; String sql = "delete from `%s_unlock` where `%s`=? and `%s`=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn());
int result = this.jdbcTemplate.update(sql, sequencesUnlock.getKey(), sequencesUnlock.getType(), sequencesUnlock.getSeq()); if (sequencesUnlock.getSeq() != null) {
return result != 0; sql += " and `%s`=?";
sql = String.format(sql, tableConfig.getSeqColumn());
return this.jdbcTemplate.update(sql, sequencesUnlock.getKey(), sequencesUnlock.getType(), sequencesUnlock.getSeq()) != 0;
} else {
return this.jdbcTemplate.update(sql, sequencesUnlock.getKey(), sequencesUnlock.getType()) != 0;
}
} }
@Override @Override
@@ -48,9 +53,22 @@ public class SequencesUnlockDaoImpl implements SequencesUnlockDao {
@Override @Override
public List<SequencesUnlock> listByDate(Date begin, Date end) { public List<SequencesUnlock> listByDate(Date begin, Date end) {
String sql = "select * from `%s_unlock` where `%s`>=? and `%s`<=?"; String sql;
if (begin != null && end != null) {
sql = "select * from `%s_unlock` where `%s`>=? and `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn(), tableConfig.getCreateTimeColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.query(sql, rowMapper(), begin, end); return this.jdbcTemplate.query(sql, rowMapper(), begin, end);
} else if (begin != null) {
sql = "select * from `%s_unlock` where `%s`>=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.query(sql, rowMapper(), begin);
} else if (end != null) {
sql = "select * from `%s_unlock` where `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.query(sql, rowMapper(), end);
} else {
return listAll();
}
} }
@Override @Override
@@ -63,18 +81,30 @@ public class SequencesUnlockDaoImpl implements SequencesUnlockDao {
@Override @Override
public boolean deleteByDate(Date begin, Date end) { public boolean deleteByDate(Date begin, Date end) {
String sql = "delete from `%s_unlock` where `%s`>=? and `%s`<=?"; String sql;
if (begin != null && end != null) {
sql = "delete from `%s_unlock` where `%s`>=? and `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn(), tableConfig.getCreateTimeColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn(), tableConfig.getCreateTimeColumn());
int result = this.jdbcTemplate.update(sql, begin, end); return this.jdbcTemplate.update(sql, begin, end) != 0;
return result != 0; } else if (begin != null) {
sql = "delete from `%s_unlock` where `%s`>=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.update(sql, begin) != 0;
} else if (end != null) {
sql = "delete from `%s_unlock` where `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.update(sql, end) != 0;
} else {
return deleteAll();
}
} }
@Override @Override
public void createTable() { public void createTable() {
String sql = "CREATE TABLE IF NOT EXISTS `%s_unlock` ( " + String sql = "CREATE TABLE IF NOT EXISTS `%s_unlock` ( " +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号英文名称'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号英文名称'," +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号类型'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号类型'," +
" `%s` BIGINT ( 2 ) NOT NULL COMMENT '尚未锁定的序号'," + " `%s` BIGINT ( 20 ) NOT NULL COMMENT '尚未锁定的序号'," +
" `%s` DATETIME NOT NULL COMMENT '使用时间'," + " `%s` DATETIME NOT NULL COMMENT '使用时间'," +
" PRIMARY KEY ( `%s`, `%s` ,`%s` ) " + " PRIMARY KEY ( `%s`, `%s` ,`%s` ) " +
" ) COMMENT '未锁定序号表'"; " ) COMMENT '未锁定序号表'";

View File

@@ -10,6 +10,8 @@ import org.springframework.jdbc.core.RowMapper;
import java.sql.PreparedStatement; import java.sql.PreparedStatement;
import java.sql.SQLException; import java.sql.SQLException;
import java.sql.Timestamp;
import java.util.Date;
import java.util.List; import java.util.List;
/** /**
@@ -28,7 +30,7 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
@Override @Override
public SequencesUnused findMinSeq(SequencesUnused sequencesUnused) { public SequencesUnused findMinSeq(SequencesUnused sequencesUnused) {
String sql = "select * from `%s_ununsed` where `%s`=? and `%s`=? order by `%s` asc limit 0,1"; String sql = "select * from `%s_unused` where `%s`=? and `%s`=? order by `%s` asc limit 0,1";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn());
try { try {
return this.jdbcTemplate.queryForObject(sql, rowMapper(), sequencesUnused.getKey(), sequencesUnused.getType()); return this.jdbcTemplate.queryForObject(sql, rowMapper(), sequencesUnused.getKey(), sequencesUnused.getType());
@@ -40,7 +42,7 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
@Override @Override
public SequencesUnused findMaxSeq(SequencesUnused sequencesUnused) { public SequencesUnused findMaxSeq(SequencesUnused sequencesUnused) {
try { try {
String sql = "select * from `%s_ununsed` where `%s`=? and `%s`=? order by `%s` desc limit 0,1"; String sql = "select * from `%s_unused` where `%s`=? and `%s`=? order by `%s` desc limit 0,1";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn());
return this.jdbcTemplate.queryForObject(sql, rowMapper(), sequencesUnused.getKey(), sequencesUnused.getType()); return this.jdbcTemplate.queryForObject(sql, rowMapper(), sequencesUnused.getKey(), sequencesUnused.getType());
} catch (EmptyResultDataAccessException ignored) { } catch (EmptyResultDataAccessException ignored) {
@@ -50,7 +52,7 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
@Override @Override
public boolean delete(SequencesUnused sequencesUnused) { public boolean delete(SequencesUnused sequencesUnused) {
String sql = "delete from `%s_ununsed` where `%s`=? and `%s`=? and `%s`=?"; String sql = "delete from `%s_unused` where `%s`=? and `%s`=? and `%s`=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn());
int result = this.jdbcTemplate.update(sql, sequencesUnused.getKey(), sequencesUnused.getType(), sequencesUnused.getSeq()); int result = this.jdbcTemplate.update(sql, sequencesUnused.getKey(), sequencesUnused.getType(), sequencesUnused.getSeq());
return result != 0; return result != 0;
@@ -58,16 +60,16 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
@Override @Override
public boolean save(SequencesUnused sequencesUnused) { public boolean save(SequencesUnused sequencesUnused) {
String sql = "insert into `%s_ununsed`(`%s`,`%s`,`%s`) values(?,?,?)"; String sql = "insert into `%s_unused`(`%s`,`%s`,`%s`,`%s`) values(?,?,?,?)";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn(), tableConfig.getCreateTimeColumn());
int result = this.jdbcTemplate.update(sql, sequencesUnused.getKey(), sequencesUnused.getType(), sequencesUnused.getSeq()); int result = this.jdbcTemplate.update(sql, sequencesUnused.getKey(), sequencesUnused.getType(), sequencesUnused.getSeq(), sequencesUnused.getCreateTime());
return result != 0; return result != 0;
} }
@Override @Override
public boolean saveBatch(List<SequencesUnused> sequencesUnusedList) { public boolean saveBatch(List<SequencesUnused> sequencesUnusedList) {
String sql = "insert into `%s_ununsed`(`%s`,`%s`,`%s`) values(?,?,?)"; String sql = "insert into `%s_unused`(`%s`,`%s`,`%s`,`%s`) values(?,?,?,?)";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn()); sql = String.format(sql, tableConfig.getTable(), tableConfig.getKeyColumn(), tableConfig.getTypeColumn(), tableConfig.getSeqColumn(), tableConfig.getCreateTimeColumn());
int[] result = this.jdbcTemplate.batchUpdate(sql, new BatchPreparedStatementSetter() { int[] result = this.jdbcTemplate.batchUpdate(sql, new BatchPreparedStatementSetter() {
@Override @Override
public void setValues(PreparedStatement ps, int i) throws SQLException { public void setValues(PreparedStatement ps, int i) throws SQLException {
@@ -75,6 +77,7 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
ps.setString(1, sequencesUnused.getKey()); ps.setString(1, sequencesUnused.getKey());
ps.setString(2, sequencesUnused.getType()); ps.setString(2, sequencesUnused.getType());
ps.setLong(3, sequencesUnused.getSeq()); ps.setLong(3, sequencesUnused.getSeq());
ps.setTimestamp(4, new Timestamp(sequencesUnused.getCreateTime().getTime()));
} }
@Override @Override
@@ -87,29 +90,60 @@ public class SequencesUnusedDaoImpl implements SequencesUnusedDao {
@Override @Override
public void createTable() { public void createTable() {
String sql = "CREATE TABLE IF NOT EXISTS `%s_ununsed` ( " + String sql = "CREATE TABLE IF NOT EXISTS `%s_unused` ( " +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号英文名称'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号英文名称'," +
" `%s` VARCHAR ( 255 ) NOT NULL COMMENT '序号类型'," + " `%s` VARCHAR ( 64 ) NOT NULL COMMENT '序号类型'," +
" `%s` BIGINT ( 2 ) NOT NULL COMMENT '闲置的的序号'," + " `%s` BIGINT ( 20 ) NOT NULL COMMENT '闲置的的序号'," +
" `%s` DATETIME NOT NULL COMMENT '设为闲置序号的时间'," +
" PRIMARY KEY ( `%s`, `%s`, `%s` ) " + " PRIMARY KEY ( `%s`, `%s`, `%s` ) " +
" ) COMMENT '闲置序号表'"; " ) COMMENT '闲置序号表'";
sql = String.format(sql, tableConfig.getTable(), sql = String.format(sql, tableConfig.getTable(),
tableConfig.getKeyColumn(), tableConfig.getKeyColumn(),
tableConfig.getTypeColumn(), tableConfig.getTypeColumn(),
tableConfig.getSeqColumn(), tableConfig.getSeqColumn(),
tableConfig.getCreateTimeColumn(),
tableConfig.getKeyColumn(), tableConfig.getKeyColumn(),
tableConfig.getTypeColumn(), tableConfig.getTypeColumn(),
tableConfig.getSeqColumn()); tableConfig.getSeqColumn());
this.jdbcTemplate.execute(sql); this.jdbcTemplate.execute(sql);
} }
@Override
public boolean deleteAll() {
String sql = "delete from `%s_unused`";
sql = String.format(sql, tableConfig.getTable());
int result = this.jdbcTemplate.update(sql);
return result != 0;
}
@Override
public boolean deleteByDate(Date begin, Date end) {
String sql;
if (begin != null && end != null) {
sql = "delete from `%s_unused` where `%s`>=? and `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.update(sql, begin, end) != 0;
} else if (begin != null) {
sql = "delete from `%s_unused` where `%s`>=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.update(sql, begin) != 0;
} else if (end != null) {
sql = "delete from `%s_unused` where `%s`<=?";
sql = String.format(sql, tableConfig.getTable(), tableConfig.getCreateTimeColumn());
return this.jdbcTemplate.update(sql, end) != 0;
} else {
return deleteAll();
}
}
private RowMapper<SequencesUnused> rowMapper() { private RowMapper<SequencesUnused> rowMapper() {
return (rs, rowNum) -> { return (rs, rowNum) -> {
SequencesUnused result = new SequencesUnused(); SequencesUnused sequencesUnused = new SequencesUnused();
result.setKey(rs.getString(tableConfig.getKeyColumn())); sequencesUnused.setKey(rs.getString(tableConfig.getKeyColumn()));
result.setType(rs.getString(tableConfig.getTypeColumn())); sequencesUnused.setType(rs.getString(tableConfig.getTypeColumn()));
result.setSeq(rs.getLong(tableConfig.getSeqColumn())); sequencesUnused.setSeq(rs.getLong(tableConfig.getSeqColumn()));
return result; sequencesUnused.setCreateTime(rs.getDate(tableConfig.getCreateTimeColumn()));
return sequencesUnused;
}; };
} }
} }

View File

@@ -167,6 +167,17 @@ public interface Generator {
*/ */
boolean lock(Sequences sequences); boolean lock(Sequences sequences);
/**
* 忽略{@link Sequences#getSeq()} ,仅通过{@link Sequences#getKey()}和{@link Sequences#getType()}来锁定序号。
* <p/>
* 如果ignoreSeq为false则等价于{@link #lock(Sequences)}
*
* @param sequences 需要锁定的序号
* @param ignoreSeq 是否忽略序号
* @return 锁定结果
*/
boolean lock(Sequences sequences, boolean ignoreSeq);
/** /**
* 释放所有未使用的序号 * 释放所有未使用的序号
* <p/> * <p/>
@@ -184,10 +195,58 @@ public interface Generator {
*/ */
void release(Date begin, Date end); void release(Date begin, Date end);
/**
* 释放从开始时间开始,到现在时间之间未使用的序号。结束时间为方法执行时的时间
*
* @param begin 开始时间
*/
void releaseAfter(Date begin);
/**
* 释放结束时间以前的序号
*
* @param end 结束时间
*/
void releaseBefore(Date end);
/** /**
* 释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。 * 释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。
* *
* @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象 * @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象
*/ */
void release(Sequences sequences); void release(Sequences sequences);
/**
* 忽略{@link Sequences#getSeq()}来释放指定序号。一般用于业务对象删除后,对应序号需要回收使用时。
* <p/>
* 如果ignoreSeq为false则等价于{@link #release(Sequences)}
*
* @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象
* @param ignoreSeq 是否忽略序号
*/
void release(Sequences sequences, boolean ignoreSeq);
/**
* 清空所有闲置序号和未锁定序号
*/
void clear();
/**
* 清空指定时间段内闲置序号和未锁定序号
*/
void clear(Date begin, Date end);
/**
* 清空从开始时间到限制时间之间闲置序号和未锁定序号,结束时间为方法执行时的时间
*
* @param begin 开始时间
*/
void clearAfter(Date begin);
/**
* 清空结束时间之前的限制序号和未锁定序号
*
* @param end 结束时间
*/
void clearBefore(Date end);
} }

View File

@@ -50,7 +50,7 @@ public class SequencesGenerator implements Generator {
* *
* @param autoCreate 是否自动创建 * @param autoCreate 是否自动创建
*/ */
private void createTable(Boolean autoCreate) { private synchronized void createTable(Boolean autoCreate) {
if (!autoCreate) if (!autoCreate)
return; return;
this.sequencesDao.createTable(); this.sequencesDao.createTable();
@@ -111,7 +111,7 @@ public class SequencesGenerator implements Generator {
@Override @Override
public synchronized String generate(String key, String type, Integer minLength) { public synchronized String generate(String key, String type, Integer minLength) {
Sequences sequences = this.generate(key, type); Sequences sequences = generate(key, type);
if (sequences == null) if (sequences == null)
return null; return null;
return sequences.format(minLength); return sequences.format(minLength);
@@ -242,6 +242,18 @@ public class SequencesGenerator implements Generator {
return sequencesUnlockDao.delete(condition); return sequencesUnlockDao.delete(condition);
} }
@Override
public synchronized boolean lock(Sequences sequences, boolean ignoreSeq) {
if (!ignoreSeq)
return lock(sequences);
if (sequences == null)
return true;
SequencesUnlock condition = new SequencesUnlock(sequences);
condition.setSeq(null);
//将使用中表的对应数据删除,空闲表中数据在生成时会删除,因此这里不需要处理该表
return sequencesUnlockDao.delete(condition);
}
@Override @Override
public synchronized void release() { public synchronized void release() {
//列出所有使用中表存在的序号 //列出所有使用中表存在的序号
@@ -249,7 +261,7 @@ public class SequencesGenerator implements Generator {
List<SequencesUnused> sequencesUnusedList = new ArrayList<>(); List<SequencesUnused> sequencesUnusedList = new ArrayList<>();
for (SequencesUnlock sequencesUnlock : sequencesUnlockList) { for (SequencesUnlock sequencesUnlock : sequencesUnlockList) {
sequencesUnusedList.add(new SequencesUnused(sequencesUnlock)); sequencesUnusedList.add(new SequencesUnused(sequencesUnlock, new Date()));
} }
//将使用中表的序号放到空闲表中 //将使用中表的序号放到空闲表中
@@ -265,7 +277,7 @@ public class SequencesGenerator implements Generator {
List<SequencesUnused> sequencesUnusedList = new ArrayList<>(); List<SequencesUnused> sequencesUnusedList = new ArrayList<>();
for (SequencesUnlock sequencesUnlock : sequencesUnlockList) { for (SequencesUnlock sequencesUnlock : sequencesUnlockList) {
sequencesUnusedList.add(new SequencesUnused(sequencesUnlock)); sequencesUnusedList.add(new SequencesUnused(sequencesUnlock, new Date()));
} }
//将指定时间段内使用中表的序号放到空闲表中 //将指定时间段内使用中表的序号放到空闲表中
@@ -274,11 +286,57 @@ public class SequencesGenerator implements Generator {
sequencesUnlockDao.deleteByDate(begin, end); sequencesUnlockDao.deleteByDate(begin, end);
} }
@Override
public synchronized void releaseAfter(Date begin) {
release(begin, null);
}
@Override
public synchronized void releaseBefore(Date end) {
release(null, end);
}
@Override @Override
public synchronized void release(Sequences sequences) { public synchronized void release(Sequences sequences) {
if (sequences == null) if (sequences == null)
return; return;
sequencesUnlockDao.delete(new SequencesUnlock(sequences)); sequencesUnlockDao.delete(new SequencesUnlock(sequences));
sequencesUnusedDao.save(new SequencesUnused(sequences)); sequencesUnusedDao.save(new SequencesUnused(sequences, new Date()));
}
@Override
public synchronized void release(Sequences sequences, boolean ignoreSeq) {
if (!ignoreSeq) {
release(sequences);
return;
}
if (sequences == null)
return;
SequencesUnlock sequencesUnlock = new SequencesUnlock(sequences);
sequencesUnlock.setSeq(null);
sequencesUnlockDao.delete(sequencesUnlock);
//由于忽略了序号因此不需要将未使用序号放到SequencesUnused里面
}
@Override
public synchronized void clear() {
sequencesUnlockDao.deleteAll();
sequencesUnusedDao.deleteAll();
}
@Override
public synchronized void clear(Date begin, Date end) {
sequencesUnlockDao.deleteByDate(begin, end);
sequencesUnusedDao.deleteByDate(begin, end);
}
@Override
public synchronized void clearAfter(Date begin) {
clear(begin, null);
}
@Override
public synchronized void clearBefore(Date end) {
clear(null, end);
} }
} }

View File

@@ -129,9 +129,9 @@ public class Sequences {
* @return 补零后的序号,若未单独设置序号的长度,则最小长度为{@link BaseConfig#getMinLength()}长度;否则为修改后的长度,不足部分补零 * @return 补零后的序号,若未单独设置序号的长度,则最小长度为{@link BaseConfig#getMinLength()}长度;否则为修改后的长度,不足部分补零
*/ */
public String format() { public String format() {
BaseConfig baseConfig = BaseConfig.getInstance(); Integer minLength = BaseConfig.getInstance().getMinLength();
if (baseConfig.getMinLength() != null) if (minLength != null)
return String.format("%0" + baseConfig.getMinLength() + "d", this.seq); return String.format("%0" + minLength + "d", this.seq);
return String.valueOf(this.seq); return String.valueOf(this.seq);
} }

View File

@@ -1,6 +1,8 @@
package com.yanghuanglin.seq.po; package com.yanghuanglin.seq.po;
import java.util.Date;
/** /**
* 闲置序号 * 闲置序号
* *
@@ -8,6 +10,8 @@ package com.yanghuanglin.seq.po;
* @since 2022/1/28 * @since 2022/1/28
*/ */
public class SequencesUnused extends Sequences { public class SequencesUnused extends Sequences {
private Date createTime;
public SequencesUnused() { public SequencesUnused() {
} }
@@ -17,12 +21,28 @@ public class SequencesUnused extends Sequences {
this.seq = sequences.getSeq(); this.seq = sequences.getSeq();
} }
public SequencesUnused(Sequences sequences, Date createTime) {
this.key = sequences.getKey();
this.type = sequences.getType();
this.seq = sequences.getSeq();
this.createTime = createTime;
}
public Date getCreateTime() {
return createTime;
}
public void setCreateTime(Date createTime) {
this.createTime = createTime;
}
@Override @Override
public String toString() { public String toString() {
return "SequencesUnused{" + return "SequencesUnused{" +
"key='" + key + '\'' + "key='" + key + '\'' +
", type='" + type + '\'' + ", type='" + type + '\'' +
", seq=" + seq + ", seq=" + seq +
", createTime=" + createTime +
'}'; '}';
} }
} }

View File

@@ -30,7 +30,7 @@ public class SeqTest {
tableConfig.setTable("sequences"); tableConfig.setTable("sequences");
tableConfig.setKeyColumn("SEQUENCE_KEY"); tableConfig.setKeyColumn("SEQUENCE_KEY");
tableConfig.setTypeColumn("SEQUENCE_TYPE"); tableConfig.setTypeColumn("SEQUENCE_TYPE");
tableConfig.setSeqColumn("NEXT_ID"); tableConfig.setSeqColumn("CURRENT");
generatorConfig.setTableConfig(tableConfig); generatorConfig.setTableConfig(tableConfig);
generator = new SequencesGenerator(generatorConfig); generator = new SequencesGenerator(generatorConfig);