package com.smartor.statemachine;
|
|
/**
|
* 住院状态机使用示例
|
*
|
* 本类展示如何在现有代码中集成状态机，仅供参考，不需要运行
|
*
|
* @author smartor
|
*/
|
public class InhospStateMachineExample {
|
|
/**
|
* 示例1: 在ServiceSLTDHealthcareRecordServiceImpl中使用状态机
|
*
|
* 原方法签名：
|
* private void processPatientInhospInfo(ServiceSLTDInhospResDTO dto, PatArchive patArchive, String cry)
|
*
|
* 改造方案：用状态机替换原有的if-else逻辑
|
*/
|
public void exampleUsageInService() {
|
/*
|
// 原代码（561-677行）改造为：
|
|
@Autowired
|
private InhospStateMachineService stateMachineService;
|
|
private void processPatientInhospInfo(ServiceSLTDInhospResDTO dto, PatArchive patArchive, String cry) {
|
// 构建住院记录对象（保持原有逻辑）
|
PatMedInhosp patMedInhosp = buildPatientInhospInfo(dto, patArchive, cry);
|
|
// 使用状态机处理状态转换（替换原有的大段if-else）
|
boolean success = stateMachineService.processStateChange(patMedInhosp, cry);
|
|
if (success) {
|
log.info("【processPatientInhospInfo】状态转换成功：serialnum={}, cry={}",
|
patMedInhosp.getSerialnum(), cry);
|
} else {
|
log.warn("【processPatientInhospInfo】状态转换失败或跳过：serialnum={}, cry={}",
|
patMedInhosp.getSerialnum(), cry);
|
}
|
}
|
|
// 优点：
|
// 1. 代码从100+行减少到10行
|
// 2. 状态转换逻辑清晰，易于维护
|
// 3. 自动加分布式锁，解决并发问题
|
// 4. 状态校验规则集中管理
|
*/
|
}
|
|
/**
|
* 示例2: 直接使用状态机服务API
|
*/
|
public void exampleDirectUsage() {
|
/*
|
@Autowired
|
private InhospStateMachineService stateMachineService;
|
|
// 处理预入院
|
PatMedInhosp preAdmission = new PatMedInhosp();
|
preAdmission.setSerialnum("202601290001");
|
preAdmission.setOrgid("HOS001");
|
preAdmission.setPatno("P001");
|
// ... 设置其他字段
|
|
boolean result1 = stateMachineService.processPreAdmission(preAdmission);
|
|
// 处理入院（会自动从预入院状态转换）
|
PatMedInhosp inHospital = new PatMedInhosp();
|
inHospital.setSerialnum("202601290001");
|
inHospital.setOrgid("HOS001");
|
inHospital.setPatno("P001");
|
// ... 设置其他字段
|
|
boolean result2 = stateMachineService.processInHospital(inHospital);
|
|
// 处理出院（会自动从入院状态转换）
|
PatMedInhosp discharge = new PatMedInhosp();
|
discharge.setSerialnum("202601290001");
|
discharge.setOrgid("HOS001");
|
discharge.setPatno("P001");
|
// ... 设置其他字段
|
|
boolean result3 = stateMachineService.processDischarge(discharge);
|
|
// 查询当前状态
|
String currentState = stateMachineService.getCurrentState("202601290001", "HOS001", "P001");
|
// currentState = "1" (出院状态)
|
*/
|
}
|
|
/**
|
* 示例3: 状态转换校验
|
*/
|
public void exampleStateValidation() {
|
/*
|
// 非法转换示例1：预入院直接到出院（会抛出异常）
|
try {
|
PatMedInhosp discharge = new PatMedInhosp();
|
discharge.setSerialnum("202601290002");
|
discharge.setOrgid("HOS001");
|
discharge.setPatno("P002");
|
discharge.setInhospstate("3"); // 当前是预入院
|
|
stateMachineService.processDischarge(discharge); // 尝试直接出院
|
|
} catch (StateTransitionException e) {
|
log.error("状态转换失败：{}", e.getMessage());
|
// 输出: 非法的状态转换: 从 [3] 到 [1]
|
}
|
|
// 非法转换示例2：重复入院（会被handler拒绝）
|
PatMedInhosp inHospital1 = new PatMedInhosp();
|
inHospital1.setSerialnum("202601290003");
|
inHospital1.setOrgid("HOS001");
|
inHospital1.setPatno("P003");
|
|
stateMachineService.processInHospital(inHospital1); // 第一次入院：成功
|
|
boolean result = stateMachineService.processInHospital(inHospital1); // 第二次入院：失败
|
// result = false，日志输出警告
|
*/
|
}
|
|
/**
|
* 状态机架构说明
|
*
|
* 1. 状态枚举 (InhospStateEnum)
|
* - 定义所有状态及允许的转换规则
|
* - PRE_ADMISSION(3) -> IN_HOSPITAL(0) -> DISCHARGED(1)
|
*
|
* 2. 状态处理器 (InhospStateHandler)
|
* - PreAdmissionHandler: 处理预入院逻辑
|
* - InHospitalHandler: 处理入院逻辑
|
* - DischargeHandler: 处理出院逻辑
|
*
|
* 3. 状态机管理器 (InhospStateMachine)
|
* - 协调状态转换
|
* - 管理分布式锁
|
* - 验证状态合法性
|
*
|
* 4. 门面服务 (InhospStateMachineService)
|
* - 提供便捷API
|
* - 封装复杂逻辑
|
*
|
* 5. 异常处理 (StateTransitionException)
|
* - 处理非法状态转换
|
*/
|
|
/**
|
* 数据库配合建议
|
*
|
* 1. 添加唯一索引（建议）
|
* CREATE UNIQUE INDEX uk_serialnum_orgid_state
|
* ON pat_med_inhosp(serialnum, orgid, inhospstate);
|
*
|
* 2. 或者更严格的约束（确保一个患者只有一条记录）
|
* CREATE UNIQUE INDEX uk_serialnum_orgid
|
* ON pat_med_inhosp(serialnum, orgid);
|
*
|
* 注意：如果使用第2种索引，需要确保：
|
* - 状态变更必须走更新（不能插入新记录）
|
* - 需要清理历史多状态记录
|
*/
|
|
/**
|
* 渐进式集成方案
|
*
|
* 阶段1：双写模式（推荐）
|
* - 保留原有代码不变
|
* - 新增状态机调用，记录日志对比
|
* - 验证状态机逻辑正确性
|
*
|
* 阶段2：灰度切换
|
* - 部分cry值走状态机
|
* - 观察生产环境表现
|
*
|
* 阶段3：完全迁移
|
* - 全部逻辑切换到状态机
|
* - 移除原有if-else代码
|
*/
|
}
|
