第2章 预约管理-检查项管理
1. 需求分析
传智健康管理系统是一款应用于健康管理机构的业务系统，实现健康管理机构工作内容可视化、患者管理专业化、健康评估数字化、健康干预流程化、知识库集成化，从而提高健康管理师的工作效率，加强与患者间的互动，增强管理者对健康管理机构运营情况的了解。
系统分为传智健康后台管理系统和移动端应用两部分。其中后台系统提供给健康管理机构内部人员（包括系统管理员、健康管理师等）使用，微信端应用提供给健康管理机构的用户（体检用户）使用。
本项目功能架构图：
通过上面的功能架构图可以看到，传智健康后台管理系统有会员管理、预约管理、健康评估、健康干预等功能。移动端有会员管理、体检预约、体检报告等功能。后台系统和移动端应用都会通过Dubbo调用服务层发布的服务来完成具体的操作。本项目属于典型的SOA架构形式。
本章节完成的功能开发是预约管理功能，包括检查项管理、检查组管理、体检套餐管理、预约设置等（参见产品原型）。预约管理属于系统的基础功能，主要就是管理一些体检的基础数据。
2. 基础环境搭建
2.1 导入预约管理模块数据表
操作步骤：
（1）根据资料中提供的itcasthealth.pdm文件导出SQL脚本
（2）创建本项目使用的数据库health
（3）将PowerDesigner导出的SQL脚本导入health数据库进行建表
2.2 导入预约管理模块实体类
将资料中提供的POJO实体类复制到health_common工程中。
2.3 导入项目所需公共资源
项目开发过程中一般会提供一些公共资源，供多个模块或者系统来使用。
本章节我们导入的公共资源有：
（1）返回消息常量类MessageConstant，放到health_common工程中
package com.itheima.constant; /** * 消息常量 */ public class MessageConstant { public static final String DELETE_CHECKITEM_FAIL = "删除检查项失败"; public static final String DELETE_CHECKITEM_SUCCESS = "删除检查项成功"; public static final String ADD_CHECKITEM_SUCCESS = "新增检查项成功"; public static final String ADD_CHECKITEM_FAIL = "新增检查项失败"; public static final String EDIT_CHECKITEM_FAIL = "编辑检查项失败"; public static final String EDIT_CHECKITEM_SUCCESS = "编辑检查项成功"; public static final String QUERY_CHECKITEM_SUCCESS = "查询检查项成功"; public static final String QUERY_CHECKITEM_FAIL = "查询检查项失败"; public static final String UPLOAD_SUCCESS = "上传成功"; public static final String ADD_CHECKGROUP_FAIL = "新增检查组失败"; public static final String ADD_CHECKGROUP_SUCCESS = "新增检查组成功"; public static final String DELETE_CHECKGROUP_FAIL = "删除检查组失败"; public static final String DELETE_CHECKGROUP_SUCCESS = "删除检查组成功"; public static final String QUERY_CHECKGROUP_SUCCESS = "查询检查组成功"; public static final String QUERY_CHECKGROUP_FAIL = "查询检查组失败"; public static final String EDIT_CHECKGROUP_FAIL = "编辑检查组失败"; public static final String EDIT_CHECKGROUP_SUCCESS = "编辑检查组成功"; public static final String PIC_UPLOAD_SUCCESS = "图片上传成功"; public static final String PIC_UPLOAD_FAIL = "图片上传失败"; public static final String ADD_SETMEAL_FAIL = "新增套餐失败"; public static final String ADD_SETMEAL_SUCCESS = "新增套餐成功"; public static final String IMPORT_ORDERSETTING_FAIL = "批量导入预约设置数据失败"; public static final String IMPORT_ORDERSETTING_SUCCESS = "批量导入预约设置数据成功"; public static final String GET_ORDERSETTING_SUCCESS = "获取预约设置数据成功"; public static final String GET_ORDERSETTING_FAIL = "获取预约设置数据失败"; public static final String ORDERSETTING_SUCCESS = "预约设置成功"; public static final String ORDERSETTING_FAIL = "预约设置失败"; public static final String ADD_MEMBER_FAIL = "新增会员失败"; public static final String ADD_MEMBER_SUCCESS = "新增会员成功"; public static final String DELETE_MEMBER_FAIL = "删除会员失败"; public static final String DELETE_MEMBER_SUCCESS = "删除会员成功"; public static final String EDIT_MEMBER_FAIL = "编辑会员失败"; public static final String EDIT_MEMBER_SUCCESS = "编辑会员成功"; public static final String TELEPHONE_VALIDATECODE_NOTNULL = "手机号和验证码都不能为空"; public static final String LOGIN_SUCCESS = "登录成功"; public static final String VALIDATECODE_ERROR = "验证码输入错误"; public static final String QUERY_ORDER_SUCCESS = "查询预约信息成功"; public static final String QUERY_ORDER_FAIL = "查询预约信息失败"; public static final String QUERY_SETMEALLIST_SUCCESS = "查询套餐列表数据成功"; public static final String QUERY_SETMEALLIST_FAIL = "查询套餐列表数据失败"; public static final String QUERY_SETMEAL_SUCCESS = "查询套餐数据成功"; public static final String QUERY_SETMEAL_FAIL = "查询套餐数据失败"; public static final String SEND_VALIDATECODE_FAIL = "验证码发送失败"; public static final String SEND_VALIDATECODE_SUCCESS = "验证码发送成功"; public static final String SELECTED_DATE_CANNOT_ORDER = "所选日期不能进行体检预约"; public static final String ORDER_FULL = "预约已满"; public static final String HAS_ORDERED = "已经完成预约，不能重复预约"; public static final String ORDER_SUCCESS = "预约成功"; public static final String GET_USERNAME_SUCCESS = "获取当前登录用户名称成功"; public static final String GET_USERNAME_FAIL = "获取当前登录用户名称失败"; public static final String GET_MENU_SUCCESS = "获取当前登录用户菜单成功"; public static final String GET_MENU_FAIL = "获取当前登录用户菜单失败"; public static final String GET_MEMBER_NUMBER_REPORT_SUCCESS = "获取会员统计数据成功"; public static final String GET_MEMBER_NUMBER_REPORT_FAIL = "获取会员统计数据失败"; public static final String GET_SETMEAL_COUNT_REPORT_SUCCESS = "获取套餐统计数据成功"; public static final String GET_SETMEAL_COUNT_REPORT_FAIL = "获取套餐统计数据失败"; public static final String GET_BUSINESS_REPORT_SUCCESS = "获取运营统计数据成功"; public static final String GET_BUSINESS_REPORT_FAIL = "获取运营统计数据失败"; public static final String GET_SETMEAL_LIST_SUCCESS = "查询套餐列表数据成功"; public static final String GET_SETMEAL_LIST_FAIL = "查询套餐列表数据失败"; }
（2）返回结果Result和PageResult类，放到health_common工程中
package com.itheima.entity; import java.io.Serializable; /** * 封装返回结果 */ public class Result implements Serializable{ private boolean flag;//执行结果，true为执行成功 false为执行失败 private String message;//返回提示信息，主要用于页面提示信息 private Object data;//返回数据 public Result(boolean flag, String message) { super(); this.flag = flag; this.message = message; } public Result(boolean flag, String message, Object data) { this.flag = flag; this.message = message; this.data = data; } public boolean isFlag() { return flag; } public void setFlag(boolean flag) { this.flag = flag; } public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } public Object getData() { return data; } public void setData(Object data) { this.data = data; } }
package com.itheima.entity; import java.io.Serializable; import java.util.List; /** * 分页结果封装对象 */ public class PageResult implements Serializable{ private Long total;//总记录数 private List rows;//当前页结果 public PageResult(Long total, List rows) { super(); this.total = total; this.rows = rows; } public Long getTotal() { return total; } public void setTotal(Long total) { this.total = total; } public List getRows() { return rows; } public void setRows(List rows) { this.rows = rows; } }
（3）封装查询条件的QueryPageBean类，放到health_common工程中
package com.itheima.entity; import java.io.Serializable; /** * 封装查询条件 */ public class QueryPageBean implements Serializable{ private Integer currentPage;//页码 private Integer pageSize;//每页记录数 private String queryString;//查询条件 public Integer getCurrentPage() { return currentPage; } public void setCurrentPage(Integer currentPage) { this.currentPage = currentPage; } public Integer getPageSize() { return pageSize; } public void setPageSize(Integer pageSize) { this.pageSize = pageSize; } public String getQueryString() { return queryString; } public void setQueryString(String queryString) { this.queryString = queryString; } }
（4）html、js、css、图片等静态资源，放到health_backend工程中
注意：后续随着项目开发还会陆续导入其他一些公共资源。
3. 新增检查项
3.1 完善页面
检查项管理页面对应的是checkitem.html页面，根据产品设计的原型已经完成了页面基本结构的编写，现在需要完善页面动态效果。
3.1.1 弹出新增窗口
页面中已经提供了新增窗口，只是处于隐藏状态。只需要将控制展示状态的属性dialogFormVisible改为true就可以显示出新增窗口。
新建按钮绑定的方法为handleCreate，所以在handleCreate方法中修改dialogFormVisible属性的值为true即可。同时为了增加用户体验度，需要每次点击新建按钮时清空表单输入项。
// 重置表单 resetForm() { this.formData = {}; }, // 弹出添加窗口 handleCreate() { this.resetForm(); this.dialogFormVisible = true; }
3.1.2 输入校验
rules: {//校验规则 code: [{ required: true, message: '项目编码为必填项', trigger: 'blur' }], name: [{ required: true, message: '项目名称为必填项', trigger: 'blur' }] }
3.1.3 提交表单数据
点击新增窗口中的确定按钮时，触发handleAdd方法，所以需要在handleAdd方法中进行完善。
//添加 handleAdd () { //进行表单校验 this.$refs['dataAddForm'].validate((valid) => { if(valid){ //表单校验通过，发生ajax请求，将录入的数据提交到后台进行处理 console.log(this.formData); axios.post("/checkItem/add.do",this.formData).then((res) => { //关闭新增窗口 this.dialogFormVisible = false; if(res.data.flag){//执行成功 //新增成功后，重新调用分页查询方法，查询出最新的数据 this.findPage(); //弹出提示信息 this.$message({ message:res.data.message, type:'success' }); }else{//执行失败 //弹出提示 this.$message.error(res.data.message); } }); }else{ //校验不通过 this.$message.error("数据校验失败，请检查你的输入信息是否正确！"); return false; } }); }
3.2 后台代码
3.2.1 Controller
在health_backend工程中创建CheckItemController
package com.itheima.controller; import com.alibaba.dubbo.config.annotation.Reference; import com.itheima.constant.MessageConstant; import com.itheima.entity.PageResult; import com.itheima.entity.QueryPageBean; import com.itheima.entity.Result; import com.itheima.pojo.CheckItem; import com.itheima.service.CheckItemService; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import java.util.List; /** * 体检检查项管理 */ @RestController @RequestMapping("/checkitem") public class CheckItemController { @Reference private CheckItemService checkItemService; //新增 @RequestMapping("/add") public Result add(@RequestBody CheckItem checkItem){ try { checkItemService.add(checkItem); }catch (Exception e){ return new Result(false,MessageConstant.ADD_CHECKITEM_FAIL); } return new Result(true,MessageConstant.ADD_CHECKITEM_SUCCESS); } }
3.2.2 服务接口
在health_interface工程中创建CheckItemService接口
package com.itheima.service; import com.itheima.pojo.CheckItem; import java.util.List; /** * 检查项服务接口 */ public interface CheckItemService { public void add(CheckItem checkItem); }
3.2.3 服务实现类
在health_service_provider工程中创建CheckItemServiceImpl实现类
package com.itheima.service; import com.alibaba.dubbo.config.annotation.Service; import com.itheima.dao.CheckItemDao; import com.itheima.pojo.CheckItem; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.transaction.annotation.Transactional; /** * 检查项服务 */ @Service(interfaceClass = CheckItemService.class) @Transactional public class CheckItemServiceImpl implements CheckItemService { @Autowired private CheckItemDao checkItemDao; //新增 public void add(CheckItem checkItem) { checkItemDao.add(checkItem); } }
3.2.4 Dao接口
在health_service_provider工程中创建CheckItemDao接口，本项目是基于Mybatis的Mapper代理技术实现持久层操作，故只需要提供接口和Mapper映射文件，无须提供实现类
package com.itheima.dao; import com.itheima.pojo.CheckItem; /** * 持久层Dao接口 */ public interface CheckItemDao { public void add(CheckItem checkItem); }
3.2.5 Mapper映射文件
在health_service_provider工程中创建CheckItemDao.xml映射文件，需要和CheckItemDao接口在同一目录下
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="com.itheima.dao.CheckItemDao"> <!--新增--> <insert id="add" parameterType="com.itheima.pojo.CheckItem"> insert into t_checkitem(code,name,sex,age,price,type,remark,attention) values (#{code},#{name},#{sex},#{age},#{price},#{type},#{remark},#{attention}) </insert> </mapper>
