如何在OptaPlanner中规划支持2小时/3小时固定时长课程的时间表？

当然可以实现这个需求，而且OptaPlanner提供了几种灵活的方式来处理这类固定规则的约束，我来给你详细拆解下具体步骤：

1. 先完善你的领域模型 #

首先需要在模型中明确存储每个科目的固定时长：

• 如果你已经有单独的Subject实体，给它添加一个durationInHours字段（比如数学设为2，化学设为3）；
• 如果Course实体直接包含科目信息，也可以在Course里添加这个字段，或者通过科目名称映射时长（不过推荐用实体关联的方式，更易维护）。

同时确保你的Timeslot实体可以计算或获取时长——要么直接存储durationInHours，要么通过startTime和endTime计算（比如用ChronoUnit来算时间差）。

示例模型代码：

public class Subject {
    private String name;
    private int durationInHours; // 数学=2，化学=3

    // getter/setter
}

public class Course {
    private Subject subject;
    private StudentGroup studentGroup;
    @PlanningVariable(valueRangeProviderRefs = "timeslotRange")
    private Timeslot timeslot;
    @PlanningVariable(valueRangeProviderRefs = "roomRange")
    private Room room;

    // getter/setter
}

public class Timeslot {
    private LocalDate date;
    private LocalTime startTime;
    private LocalTime endTime;

    // 计算时长（小时）
    public int getDurationInHours() {
        return (int) ChronoUnit.HOURS.between(startTime, endTime);
    }

    // getter/setter
}

2. 添加硬约束强制时长匹配 #

因为科目固定时长是必须严格遵守的规则，所以需要用**硬约束（Hard Constraint）**来实现——违反硬约束的解会被视为不可行，OptaPlanner会优先避免这类情况。

用OptaPlanner推荐的Constraint Streams API实现约束：

public class TimetableConstraintProvider implements ConstraintProvider {
    @Override
    public Constraint[] defineConstraints(ConstraintFactory constraintFactory) {
        return new Constraint[] {
            enforceSubjectFixedDuration(constraintFactory)
        };
    }

    private Constraint enforceSubjectFixedDuration(ConstraintFactory constraintFactory) {
        return constraintFactory.forEach(Course.class)
                // 过滤出时长不匹配的课程
                .filter(course -> course.getTimeslot().getDurationInHours() != course.getSubject().getDurationInHours())
                // 给违反规则的情况施加硬惩罚（ONE_HARD表示违反一次就导致解不可行）
                .penalize("Course duration does not match subject's fixed duration",
                        HardSoftScore.ONE_HARD);
    }
}

3. 优化：提前过滤无效时间槽（可选但推荐） #

为了减少OptaPlanner的搜索空间，提升规划效率，你可以在分配时间槽的时候，直接过滤掉不符合当前科目时长的选项。

通过@ValueRangeProvider实现过滤：

public class Course {
    // ... 其他属性 ...

    @ValueRangeProvider(id = "timeslotRange")
    public List<Timeslot> getFilteredTimeslotRange() {
        // 只返回和科目时长匹配的时间槽
        return timeslotList.stream()
                .filter(timeslot -> timeslot.getDurationInHours() == subject.getDurationInHours())
                .collect(Collectors.toList());
    }
}

这样OptaPlanner在初始化和搜索过程中，只会给课程分配符合时长要求的时间槽，再配合硬约束的检查，双重保障规则被严格执行。

补充说明 #

• 如果你的时间表模板中的时间槽本身就是预先定义好的2小时或3小时段，这种方式会非常高效；
• 硬约束的优先级最高，确保所有解都满足时长要求，完全符合你的核心需求；
• 如果你需要更复杂的时长规则（比如部分科目可选时长），也可以调整约束逻辑，用软约束（Soft Constraint）来处理非强制规则。

内容的提问来源于stack exchange，提问作者Tarik Ouhamou