windyboy
1183c7522b
把上一提交没覆盖到的模块也改完，至此仓库内不再有"只写编号、不写说明"的注释。 涉及 33 个文件（生产 24 + 测试 9），包括航班状态模型与合并引擎、事件与留痕模型、 运营日计算、投递器、历史归档作业、编解码与身份、重试与重放、健康指示器、 生命周期装配、以及各自的测试类。 改法与前面一致：先说这段代码做什么，再说为什么这么做，术语第一次出现就地解释 （FLID、OPERATION_DAY、航班版本号、删除通知、待发事件表等）。工单编号 （U07/N02/ACM2-10 之类）已全部移除；段落编号只剩 10 处，全部带文件名位于句尾， 用作延伸阅读，例如"见 docs/flight-state.md §5"。 保留了本来就自解释的行内注释、PgTestSupport 顶部的环境变量默认值表格， 以及 InboxController 里描述待补接口的 TODO。 校验：逐文件做"去注释后比对"（块注释 + 行注释清除、空白归一），33 个文件代码 零差异；另做逐行非注释代码比对，同样零差异。clean test 为 78 passed / 1 skipped。
54 lines
2.4 KiB
Kotlin
54 lines
2.4 KiB
Kotlin
package com.gzzn.omms.msgexchange.domain
|
|
|
|
import java.time.LocalDate
|
|
import java.time.LocalDateTime
|
|
import java.time.ZoneId
|
|
|
|
/**
|
|
* 算航班的运营保障日（OPERATION_DAY）：拿计划运行时间 SODT 和机场时区推出来。它不是消息
|
|
* 接收日、也不是落库日，算出来之后就固定不变。
|
|
*
|
|
* 民航的一天不一定从零点开始，切日边界由 msgx.operation-day.cutoff-hour 配。默认 0 点只是
|
|
* 占位，真实口径还要业务确认。见 docs/flight-state.md §2.1。
|
|
*/
|
|
class OperationDayCalculator(
|
|
zone: ZoneId,
|
|
cutoffHour: Int,
|
|
) {
|
|
private val zone: ZoneId = zone
|
|
/** 切日边界小时：SODT 的本地时刻早于这个点就归属前一个运营日。取值 0–23，超出范围会被夹到边界值。 */
|
|
private val cutoffHour: Int = cutoffHour.coerceIn(0, 23)
|
|
|
|
/** 把 SODT 换算成运营日；入参为空、全空白或格式不对时返回 null 而不抛异常，由调用方按"运营日算不出来"处理。 */
|
|
fun compute(sodt: String?): LocalDate? {
|
|
if (sodt.isNullOrBlank()) return null
|
|
val local = parseSodt(sodt.trim()) ?: return null
|
|
val day = local.atZone(zone).toLocalDate()
|
|
return if (local.hour < cutoffHour) day.minusDays(1) else day
|
|
}
|
|
|
|
companion object {
|
|
/**
|
|
* SODT 的报文格式：ddMMMyyHHmm，比如 15DEC031723，月份是三字母英文缩写、大小写都认。
|
|
*
|
|
* 两位年份显式按 2000 年展开，不交给 java.time 的 yy 解析——不同实现对两位年的处理
|
|
* 不一致，自己展开才能保证各方对年份窗口的理解相同。基准年等真实报文到了再确认。
|
|
*/
|
|
private val SODT_REGEX = Regex("(\\d{1,2})([A-Za-z]{3})(\\d{2})(\\d{2})(\\d{2})")
|
|
|
|
private val MONTHS = mapOf(
|
|
"JAN" to 1, "FEB" to 2, "MAR" to 3, "APR" to 4, "MAY" to 5, "JUN" to 6,
|
|
"JUL" to 7, "AUG" to 8, "SEP" to 9, "OCT" to 10, "NOV" to 11, "DEC" to 12,
|
|
)
|
|
|
|
internal fun parseSodt(raw: String): LocalDateTime? {
|
|
val m = SODT_REGEX.matchEntire(raw.uppercase()) ?: return null
|
|
val (d, mon, yy, hh, mm) = m.destructured
|
|
val month = MONTHS[mon] ?: return null
|
|
return runCatching {
|
|
LocalDateTime.of(2000 + yy.toInt(), month, d.toInt(), hh.toInt(), mm.toInt())
|
|
}.getOrNull()
|
|
}
|
|
}
|
|
}
|