会议室管理与时间冲突检测
导读
「会议室管理与时间冲突检测」是面试与实战中都会被反复问到的问题,下面从结论讲起。
会议室模块是 OA 里典型的"资源预订"场景,核心难点只有一个:判断新申请的时间段是否与已有申请重叠。这个看似简单的问题,在 SQL 里其实有不少门道。
一、领域模型
public class MeetingRoom { // T_MeetingRoom
private int id;
private String sn; // 会议室编号,唯一(如 "A301")
private String position; // 位置描述
private String description;
}
public class MeetingRoomApply { // T_MeetingRoomApply
public static final String STATUS_APPLY = "A"; // 已申请
public static final String STATUS_OCCUR = "O"; // 已占用/已发生
private int id;
private MeetingRoom room; // 申请的会议室
private Date beginDate; // 开始时间
private Date endDate; // 结束时间
private String applyReason; // 申请事由
private String status; // A / O
}
状态设计很轻:申请时为 A,会议实际发生后(或由定时任务扫描)置为 O。真实项目还会补上"已取消 C"、"审批中 P"。
二、冲突检测:两段时间的重叠判断
2.1 数学表达
设已有申请区间为 [ap.beginDate, ap.endDate],新申请为 [begin, end]。两者不重叠的条件是:
end < ap.beginDate 或 begin > ap.endDate
取反即重叠条件:
NOT (end < ap.beginDate OR begin > ap.endDate)
= end >= ap.beginDate AND begin <= ap.endDate
2.2 本项目采用的写法
项目用的是更简洁的一种等价形式——只要新申请的两个端点有任意一个落在已有区间内,就认为冲突:
public void applyRoom(MeetingRoomApply apply, String sn) {
Long size = (Long) getSession()
.createQuery(
"select count(*) from MeetingRoomApply ap where ap.room.sn = ? and " +
"(" +
"(:begin between ap.beginDate and ap.endDate ) or " +
"(:end between ap.beginDate and ap.endDate )" +
")")
.setParameter(0, sn)
.setParameter("begin", apply.getBeginDate())
.setParameter("end", apply.getEndDate())
.uniqueResult();
if (size >= 1) {
throw new SystemException("您申请的会议室与其他人的申请有冲突,请重新申请!");
}
apply.setRoom((MeetingRoom) getSession()
.createQuery("from MeetingRoom ap where ap.sn = ?")
.setParameter(0, sn)
.uniqueResult());
getHibernateTemplate().save(apply);
}
2.3 这个写法有个漏洞
(:begin between ...) or (:end between ...) 只能检出"端点落在区间内",漏掉了"完全包含"的情况:
已有申请: [============]
新申请: [====================] ← 新申请的起止都在已有区间之外
此时两个 between 都为 false,检测不出来。
完整的写法应该是:
"select count(*) from MeetingRoomApply ap where ap.room.sn = :sn and " +
"(:begin < ap.endDate and :end > ap.beginDate)"
这才是标准的"区间相交"判断(a.start < b.end AND a.end > b.start)。
| 场景 | 端点 between 写法 | 标准相交写法 |
|---|---|---|
| 部分重叠 | ✅ 检出 | ✅ 检出 |
| 完全相同 | ✅ 检出 | ✅ 检出 |
| 新申请完全包含已有申请 | ❌ 漏检 | ✅ 检出 |
| 相邻不重叠(end == begin) | ✅ 不误报 | ✅ 不误报 |
边界约定:如果认为"上一场 10:00 结束、下一场 10:00 开始"是允许的,用
</>;如果要求留缓冲,改成<=/>=或加一个间隔常量。
2.4 修改申请时要排除自己
更新一条已存在的申请时,不能把它自己算作冲突:
public void updateApply(MeetingRoomApply apply, String sn) {
Long size = (Long) getSession()
.createQuery(
"select count(*) from MeetingRoomApply ap where ap.room.sn = ? and " +
"(" +
"(:begin between ap.beginDate and ap.endDate ) or " +
"(:end between ap.beginDate and ap.endDate )" +
") and " +
"ap.id <> " + apply.getId())
.setParameter(0, sn)
.setParameter("begin", apply.getBeginDate())
.setParameter("end", apply.getEndDate())
.uniqueResult();
if (size >= 1) {
throw new SystemException("您申请的会议室与其他人的申请有冲突,请重新申请!");
}
apply.setRoom(...);
getHibernateTemplate().update(apply);
}
注意 ap.id <> apply.getId() 这里是字符串拼接,但因为 getId() 返回 int,不存在注入风险;不过统一用 setParameter 仍是更好的习惯。
2.5 并发问题
以上检测是"先查后写",在高并发下会有竞态:两个人同时查到没有冲突,然后都写入成功。
解决办法(按成本递增):
- 数据库唯一约束 —— 最彻底,但时间段无法直接用唯一索引表达;
- 悲观锁 —— 查询时
select ... for update,锁住该会议室的记录; - 乐观锁 —— 在
MeetingRoom上加version字段,冲突时重试; - 应用层串行化 —— 用 Redis 分布式锁按会议室
sn加锁。
中小型 OA 用乐观锁或"按会议室加锁"足够。
三、会议室日历视图
3.1 查询时间范围内的申请
public List searchApplies(Date begin, Date end) {
return getSession().createQuery(
"select a from MeetingRoomApply a where (a.beginDate between :begin and :end ) " +
"or (a.endDate between :begin and :end)")
.setParameter("begin", begin)
.setParameter("end", end)
.list();
}
同样地,这里也漏掉了"申请区间完全覆盖查询区间"的情况。完整写法:
select a from MeetingRoomApply a
where a.beginDate < :end and a.endDate > :begin
3.2 把申请拆成"小时格子"
日历视图通常是一张"会议室 × 小时"的表格,一条跨越 3 小时的申请要占 3 个格子。做法是把一条申请拆成 N 个 VO,每个 VO 带一个可定位的 id:
public class MeetingRoomApplyVO {
private String id; // "A301_2026-10-25-14":会议室_年-月-日-小时
private int oid; // 原始申请的 ID
private String applyReason;
private String status;
}
拆分逻辑:
public static List splitApply(MeetingRoomApply apply) {
Calendar beginCal = Calendar.getInstance();
beginCal.setTime(apply.getBeginDate());
Calendar endCal = Calendar.getInstance();
endCal.setTime(apply.getEndDate());
List applyVO = new ArrayList();
do {
int hour = beginCal.get(Calendar.HOUR_OF_DAY);
if (hour < 8 || hour > 18) { // 只显示 8:00-18:00
beginCal.add(Calendar.HOUR_OF_DAY, 1);
continue;
}
MeetingRoomApplyVO vo = new MeetingRoomApplyVO();
vo.setId(apply.getRoom().getSn() + "_"
+ beginCal.get(Calendar.YEAR) + "-"
+ (beginCal.get(Calendar.MONTH) + 1) + "-"
+ beginCal.get(Calendar.DAY_OF_MONTH) + "-"
+ hour);
vo.setOid(apply.getId());
vo.setApplyReason(apply.getApplyReason());
vo.setStatus(apply.getStatus());
applyVO.add(vo);
beginCal.add(Calendar.HOUR_OF_DAY, 1);
} while (endCal.after(beginCal));
return applyVO;
}
3.3 节假日判断
public static boolean isHoliday(int year, int month, int date) {
Calendar now = Calendar.getInstance();
now.set(year, month - 1, date); // Calendar 的月份从 0 开始
int current = now.get(Calendar.DAY_OF_WEEK);
return current == Calendar.SUNDAY || current == Calendar.SATURDAY;
}
只判断了周末。真实项目应接入法定节假日表或第三方日历接口。
3.4 页面渲染
JSP 里两层循环 + Map 查表即可:
<c:forEach items="${rooms}" var="room">
<tr>
<td>${room.sn}</td>
<c:forEach begin="8" end="18" var="h">
<c:set var="cellId" value="${room.sn}_${year}-${month}-${day}-${h}"/>
<td>
<c:choose>
<c:when test="${not empty applyMap[cellId]}">
<span title="${applyMap[cellId].applyReason}">占用</span>
</c:when>
<c:when test="${my:holiday(year, month, day)}">休</c:when>
<c:otherwise>
<a href="meetingRoom.do?method=applyInput&sn=${room.sn}&hour=${h}">申请</a>
</c:otherwise>
</c:choose>
</td>
</c:forEach>
</tr>
</c:forEach>
四、Action 层的编排
public class MeetingRoomAction extends BaseAction {
private MeetingRoomManager meetingRoomManager;
/** 会议室列表 */
protected ActionForward unspecified(...) {
request.setAttribute("rooms", meetingRoomManager.searchAllRooms());
return mapping.findForward("index");
}
/** 日历视图 */
public ActionForward calendar(...) {
MeetingRoomActionForm maf = (MeetingRoomActionForm) form;
request.setAttribute("applies",
meetingRoomManager.searchApplies(maf.getBegin(), maf.getEnd()));
return mapping.findForward("calendar");
}
/** 提交申请 */
public ActionForward apply(...) {
MeetingRoomActionForm maf = (MeetingRoomActionForm) form;
MeetingRoomApply apply = new MeetingRoomApply();
BeanUtils.copyProperties(apply, maf);
apply.setStatus(MeetingRoomApply.STATUS_APPLY);
meetingRoomManager.applyRoom(apply, maf.getSn());
return mapping.findForward("pub_add_success");
}
}
冲突时抛出的 SystemException 会被全局异常处理器捕获,跳到 common/exception.jsp 显示"您申请的会议室与其他人的申请有冲突,请重新申请!"。
五、可改进之处
| 问题 | 改进 |
|---|---|
| 冲突检测漏掉"完全包含" | 改用 begin < ap.endDate and end > ap.beginDate |
| 查询区间漏掉"覆盖" | 同上 |
| 并发下可能重复预订 | 乐观锁 / 分布式锁 |
| 无审批流程 | 接入 jBPM,让会议室申请也走审批 |
| 无取消与释放 | 补状态机:A(申请)→ O(占用)/ C(取消) |
| 节假日只判周末 | 引入节假日数据表 |
| 无重复周期会议 | 增加"每周重复"规则,展开成多条申请 |
六、小结
会议室模块的价值不在于 CRUD,而在于两个通用技巧:
- 区间重叠判断:
a.start < b.end AND a.end > b.start,这是所有排班、预订、档期系统的基础公式; - 一条记录展开成多个展示单元(
splitApply):用带业务含义的复合 id 把"时间段"映射到"格子",是日历类视图的通用做法。
要点小结
-
- | 问题 | 改进 | |---|---| | 冲突检测漏掉"完全包含" | 改用
begin < ap.endDate and end > ap.beginDate|… -
- 一条记录展开成多个展示单元(
splitApply):用带业务含义的复合 id 把"时间段"映射到"格子",是日历类视图的通用做法。
- 一条记录展开成多个展示单元(
- 会议室模块的价值不在于 CRUD,而在于两个通用技巧: 1. 区间重叠判断:
a.start < b.end AND a.end > b.start,这是所有排班…
由站内小编编辑整理