一 背景
主要用于批量处理:
二 基本架构
三 代码
package com.xuyu.batch;
import lombok.extern.slf4j.Slf4j;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.BlockingQueue;
/**
* 数据库批量处理器
*/
@Slf4j
public class BatchProcessor<T> {
/**
* 一次批量提交多少个,默认1000
*/
private int bulkNum;
/**
* 最多隔多久进行一次提交,单位秒
*/
private int flushInterval;
/**
* 保存数据的队列
*/
private BlockingQueue<T> itemQueue;
private volatile boolean closed = false;
/**
* 执行插入动作的执行器
*/
private DoInsert<T> doInsert;
private static final int DEFAULT_BULK_NUM = 1000;
private static final int DEFAULT_CAPACITY = 1024;
private static final int DEFAULT_FLUSH_INTERVAL = 3;
public BatchProcessor(DoInsert<T> doInsert) {
this(doInsert, DEFAULT_BULK_NUM, DEFAULT_FLUSH_INTERVAL, DEFAULT_CAPACITY);
}
public BatchProcessor(DoInsert<T> doInsert, int bulkNum) {
this(doInsert, bulkNum, DEFAULT_FLUSH_INTERVAL, DEFAULT_CAPACITY);
}
public BatchProcessor(DoInsert<T> doInsert, int bulkNum, int flushInterval) {
this(doInsert, bulkNum, flushInterval, DEFAULT_CAPACITY);
}
public BatchProcessor(DoInsert<T> doInsert, int bulkNum, int flushInterval, int capacity) {
if (bulkNum < 1) {
bulkNum = DEFAULT_BULK_NUM;
}
if (capacity < 1 || capacity < bulkNum) {
capacity = Math.max(DEFAULT_CAPACITY, bulkNum * 2);
}
if (flushInterval < 1) {
flushInterval = DEFAULT_FLUSH_INTERVAL;
}
this.bulkNum = bulkNum;
this.doInsert = doInsert;
this.flushInterval = flushInterval;
itemQueue = new ArrayBlockingQueue<>(capacity);
//开始flash任务
this.startFlushTask();
}
/**
* 阻塞添加到队列中
*
* @param item
* @return 最后添加成功就返回true,添加失败就返回false
*/
public boolean addItem(T item) {
if (closed) {
return false;
}
try {
itemQueue.put(item);
return true;
} catch (InterruptedException e) {
log.error("添加到队列时中断!item={}", e);
}
return false;
}
/**
* 将队列中的数据全部提交到数据库中
*/
public void flushAllItem() {
while (!itemQueue.isEmpty()) {
List<T> list = new ArrayList<>(bulkNum);
itemQueue.drainTo(list, bulkNum);
if (!list.isEmpty()) {
flushToDB(list);
}
}
log.info("flushAllItem success!");
}
/**
* 关闭批量插入处理器,并提交队列中所有的数据
*/
public void close() {
this.closed = true;
flushAllItem();
log.info("DbBatchInsertProcessor 成功关闭");
}
/**
* 开始flush任务
*/
private void startFlushTask() {
Thread t = new Thread(() -> {
int waitSecond = 0;
while (true) {
if (closed) {
break;
}
if (itemQueue.size() >= bulkNum || waitSecond >= flushInterval) {
//队列数量大于批量提交数或等待超过指定的时间时,进行提交
if (!itemQueue.isEmpty()) {
List<T> list = new ArrayList<>(bulkNum);
itemQueue.drainTo(list, bulkNum);
if (!list.isEmpty()) {
flushToDB(list);
}
}
waitSecond = 0;
} else {
//还没到批量提交点,进行等待
try {
Thread.sleep(1000);
waitSecond++;
} catch (InterruptedException e) {
log.error("startFlushTask 异常中断!");
}
}
}
});
t.setName("BatchProcessor thread" + this.hashCode());
t.start();
}
private void flushToDB(List<T> list) {
try {
int insertRow = doInsert.batchInsert(list);
log.info("{}表插入{}条记录", doInsert.tableName(), insertRow);
} catch (Throwable e) {
log.error("{}表批量插入时发生异常,list={}", doInsert.tableName(), e);
}
}
/**
* 执行真正批量插入的接口
*
* @param <T>
*/
interface DoInsert<T> {
int batchInsert(List<T> list);
String tableName();
}
}