患者根据医生编号完成绑定和解绑接口

医疗系统接口文档

一、Controller 层

1. InstitutionDoctorController

医疗机构和医生相关的控制器，提供机构查询、医生查询、绑定解绑医生等功能。

@RestController
@RequestMapping("/institution-doctor")
public class InstitutionDoctorController {@Autowiredprivate InstitutionService institutionService;@Autowiredprivate DoctorService doctorService;@Autowiredprivate ClientService clientService;@GetMapping("/listInstitution/{institutionCategoryId}")public Result<List<Institution>> getInstitutionList(@PathVariable Long institutionCategoryId) {List<Institution> institutionList = institutionService.getInstitutionByInstitutionCategoryId(institutionCategoryId);return Result.success(institutionList);}@GetMapping("/listDoctor")public Result<List<User>> getDoctorList(@RequestParam String institution) {List<User> doctorList = doctorService.getDoctorByInstitutionName(institution);return Result.success(doctorList);}@PatchMapping("/bindDoctorByDoctorNumber")public Result<Boolean> bindDoctorByDoctorNumber(@PathVariable BindDoctorDto bindDoctorDto){boolean result = clientService.bindDoctorByDoctorNumber(bindDoctorDto);return Result.success(result);}@PatchMapping("/unbindDoctorByDoctorNumber")public Result<Boolean> unbindDoctorByDoctorNumber(@PathVariable BindDoctorDto bindDoctorDto){boolean result = clientService.unbindDoctorByDoctorNumber(bindDoctorDto);return Result.success(result);}@GetMapping("/getDoctorMsg/{doctorNumber}")public Result<UserVO> getDoctorMsg(@RequestParam int doctorNumber){UserVO doctorMsg = doctorService.getDoctorMsg(doctorNumber);return Result.success(doctorMsg);}
}

二、Service 接口

1. DoctorService

医生服务接口，提供获取医生信息的方法。

public interface DoctorService extends IService<User> {List<User> getDoctorByInstitutionName(String institution);UserVO getDoctorMsg(int doctorNumber);
}

2. ClientService

客户服务接口，提供客户与医生绑定和解绑的功能。

public interface ClientService extends IService<Client> {boolean bindDoctorByDoctorNumber(BindDoctorDto bindDoctorDto);boolean unbindDoctorByDoctorNumber(BindDoctorDto bindDoctorDto);
}

3. InstitutionService

医疗机构服务接口，提供获取机构列表的功能。

public interface InstitutionService extends IService<Institution>{List<Institution> getInstitutionByInstitutionCategoryId(Long institutionCategoryId);
}

三、Service 实现类

1. DoctorServiceImpl

@Service
public class DoctorServiceImpl extends ServiceImpl<UserMapper, User> implements DoctorService {@Autowiredprivate UserMapper userMapper;private static final String Institution = "institution";@Overridepublic List<User> getDoctorByInstitutionName(String institution) {QueryWrapper<User> queryWrapper = new QueryWrapper<>();queryWrapper.eq(Institution,institution);return userMapper.selectList(queryWrapper);}@Overridepublic UserVO getDoctorMsg(int doctorNumber) {LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();queryWrapper.eq(User::getNumber, doctorNumber);// 查询数据库User doctor = userMapper.selectOne(queryWrapper);if (doctor == null) {throw new BusinessException(InstitutionDoctorEnum.DOCTOR_NOT_EXIST.getCode(),InstitutionDoctorEnum.DOCTOR_NOT_EXIST.getMessage());}UserVO userVO = new UserVO();BeanUtils.copyProperties(doctor, userVO);return userVO;}
}

2. ClientServiceImpl

@Service
public class ClientServiceImpl extends ServiceImpl<ClientMapper, Client> implements ClientService {@Autowiredprivate ClientMapper clientMapper;@Autowiredprivate UserMapper userMapper;@Autowiredprivate PatientMapper patientMapper;private static final String NUMBER = "number";private static final String UUID = "uuid";private static final int DEFAULT_DOCTOR_NUMBER = 887375;// 绑定医生@Overridepublic boolean bindDoctorByDoctorNumber(BindDoctorDto bindDoctorDto){String clientUuid = bindDoctorDto.getUuid();int doctorNumber = bindDoctorDto.getDoctorNumber();// 1. 查询医生User doctor = userMapper.selectOne(new QueryWrapper<User>().eq(NUMBER, doctorNumber));if (doctor == null) {throw new BusinessException(InstitutionDoctorEnum.DOCTOR_NOT_EXIST.getCode(),InstitutionDoctorEnum.DOCTOR_NOT_EXIST.getMessage());}// 2. 查询 clientClient client = clientMapper.selectOne(new QueryWrapper<Client>().eq(UUID, clientUuid));if (client == null) {throw new BusinessException(InstitutionDoctorEnum.CLIENT_NOT_EXIST.getCode(),InstitutionDoctorEnum.CLIENT_NOT_EXIST.getMessage());}// 3. 查询 patientPatient patient = patientMapper.selectOne(new QueryWrapper<Patient>().eq(UUID, clientUuid));if (patient == null) {throw new BusinessException(InstitutionDoctorEnum.Patient_NOT_EXIST.getCode(),InstitutionDoctorEnum.Patient_NOT_EXIST.getMessage());}// 4. 校验当前医生是否可覆盖Integer currentDoctorNumber = patient.getDoctorNumber();if (currentDoctorNumber != null) {User currentDoctor = userMapper.selectOne(new QueryWrapper<User>().eq(NUMBER, currentDoctorNumber));if (currentDoctor != null && currentDoctor.getRole() != 1) {throw new BusinessException(InstitutionDoctorEnum.DOCTOR_ALREADY_BOUND.getCode(),InstitutionDoctorEnum.DOCTOR_ALREADY_BOUND.getMessage());}}// 5. 更新绑定patient.setDoctorNumber(doctorNumber);int update = patientMapper.update(patient,new UpdateWrapper<Patient>().eq(UUID, patient.getUuid()));if (update <= 0) {throw new BusinessException(InstitutionDoctorEnum.BIND_UPDATE_FAILED.getCode(),InstitutionDoctorEnum.BIND_UPDATE_FAILED.getMessage());}return true;}@Overridepublic boolean unbindDoctorByDoctorNumber(BindDoctorDto bindDoctorDto) {String clientUuid = bindDoctorDto.getUuid();Patient patient = patientMapper.selectOne(new QueryWrapper<Patient>().eq(UUID, clientUuid));if (patient == null) {throw new BusinessException(InstitutionDoctorEnum.Patient_NOT_EXIST.getCode(),InstitutionDoctorEnum.Patient_NOT_EXIST.getMessage());}patient.setDoctorNumber(DEFAULT_DOCTOR_NUMBER);int update = patientMapper.update(patient,new UpdateWrapper<Patient>().eq(UUID, clientUuid));if (update <= 0) {throw new BusinessException(InstitutionDoctorEnum.BIND_UPDATE_FAILED.getCode(),InstitutionDoctorEnum.BIND_UPDATE_FAILED.getMessage());}return true;}
}

3. InstitutionServiceImpl

@Service
public class InstitutionServiceImpl extends ServiceImpl<InstitutionMapper, Institution> implements InstitutionService {@Autowiredprivate InstitutionMapper institutionMapper;@Autowiredprivate UserMapper userMapper;public static final String CATEGORY_ID = "category_id";@Overridepublic List<Institution> getInstitutionByInstitutionCategoryId(Long institutionCategoryId) {// 使用QueryWrapper构建查询条件QueryWrapper<Institution> queryWrapper = new QueryWrapper<>();queryWrapper.eq(CATEGORY_ID, institutionCategoryId);// 查询符合条件的所有机构return institutionMapper.selectList(queryWrapper);}
}

四、枚举类

InstitutionDoctorEnum

定义了医生和机构相关的业务异常枚举。

public enum InstitutionDoctorEnum {DOCTOR_NOT_EXIST(4031,"医生不存在"),CLIENT_NOT_EXIST(4032,"患者不存在"),Patient_NOT_EXIST(4033,"患者未绑定，请前往绑定"),DOCTOR_ALREADY_BOUND(4034,"用户已绑定医生"),BIND_UPDATE_FAILED(4035,"其它绑定错误");private Integer code;private String message;InstitutionDoctorEnum(Integer code, String message) {this.code = code;this.message = message;}
}

五、接口功能说明

1. getInstitutionList：根据机构分类ID获取机构列表
2. getDoctorList：根据机构名称获取该机构的医生列表
3. bindDoctorByDoctorNumber：通过医生编号为用户绑定医生
4. unbindDoctorByDoctorNumber：解除用户与医生的绑定关系
5. getDoctorMsg：根据医生编号获取医生详细信息

六、接口调用示例

1. 获取机构列表

GET /institution-doctor/listInstitution/1

2. 获取医生列表

GET /institution-doctor/listDoctor?institution=某医院

3. 绑定医生

PATCH /institution-doctor/bindDoctorByDoctorNumber
请求体: {"uuid": "用户UUID", "doctorNumber": 12345}

4. 解绑医生

PATCH /institution-doctor/unbindDoctorByDoctorNumber
请求体: {"uuid": "用户UUID", "doctorNumber": 12345}

5. 获取医生信息

GET /institution-doctor/getDoctorMsg/12345

其它问题思考：

1. pathVariable和requestparam的使用场景
2. 唯一标识在用户量不大的情况下使用INT和String哪个效率高
3. 用uuid完全代替id是否合理