專案功能--批次匯入預約設定

　　一、需求分析
　　我們需要進行預約設定，就是設定每一天的體檢預約最大數量。客戶可以透過微信端線上預約，線上預約時需要選擇體檢的時間，如果客戶選擇的時間已經預約滿則無法進行預約。

　　二、 Apache POI簡介
　　Apache POI是用Java編寫的免費開源的跨平臺的Java API，Apache POI提供API給Java程式對Microsoft Office格式檔案讀和寫的功能，其中使用最多的就是使用POI操作Excel檔案。

POI結構

HSSF － 提供讀寫Microsoft Excel XLS格式檔案的功能
XSSF － 提供讀寫Microsoft Excel OOXML XLSX格式檔案的功能
HWPF － 提供讀寫Microsoft Word DOC格式檔案的功能
HSLF － 提供讀寫Microsoft PowerPoint格式檔案的功能
HDGF － 提供讀Microsoft Visio格式檔案的功能
HPBF － 提供讀Microsoft Publisher格式檔案的功能
HSMF － 提供讀Microsoft Outlook格式檔案的功能

　　2.1從Excel檔案讀取資料

使用POI可以從一個已經存在的Excel檔案中讀取資料，透過遍歷工作表獲得行，遍歷行獲得單元格，最終獲取單元格中的值。

//建立工作簿
XSSFWorkbook workbook = new XSSFWorkbook("D:\\test.xlsx");
//獲取工作表，既可以根據工作表的順序獲取，也可以根據工作表的名稱獲取
XSSFSheet sheet = workbook.getSheetAt(0);
//遍歷工作表獲得行物件
for (Row row : sheet) {
  //遍歷行物件獲取單元格物件
  for (Cell cell : row) {
    //獲得單元格中的值
    String value = cell.getStringCellValue();
    System.out.println(value);
  }
}
workbook.close();

POI操作Excel表格封裝了幾個核心物件：
XSSFWorkbook：工作簿
XSSFSheet：工作表
Row：行
Cell：單元格

　　還有一種讀取方式就是獲取工作表最後一個行號，從而根據行號獲得行物件，透過行獲取最後一個單元格索引，從而根據單元格索引獲取每行的一個單元格物件，程式碼如下：

//建立工作簿
XSSFWorkbook workbook = new XSSFWorkbook("D:\\test.xlsx");
//獲取工作表，既可以根據工作表的順序獲取，也可以根據工作表的名稱獲取
XSSFSheet sheet = workbook.getSheetAt(0);
//獲取當前工作表最後一行的行號，行號從0開始
int lastRowNum = sheet.getLastRowNum();
for(int i=0;i<=lastRowNum;i++){
  //根據行號獲取行物件
  XSSFRow row = sheet.getRow(i);
  short lastCellNum = row.getLastCellNum();
  for(short j=0;j<lastCellNum;j++){
    String value = row.getCell(j).getStringCellValue();
    System.out.println(value);
  }
}
workbook.close();

　　2.2 向Excel檔案寫入資料
使用POI可以在記憶體中建立一個Excel檔案並將資料寫入到這個檔案，最後透過輸出流將記憶體中的Excel檔案下載到磁碟

//在記憶體中建立一個Excel檔案
XSSFWorkbook workbook = new XSSFWorkbook();
//建立工作表，指定工作表名稱
XSSFSheet sheet = workbook.createSheet("測試");
​
//建立行，0表示第一行
XSSFRow row = sheet.createRow(0);
//建立單元格，0表示第一個單元格
row.createCell(0).setCellValue("編號");
row.createCell(1).setCellValue("名稱");
row.createCell(2).setCellValue("年齡");
​
XSSFRow row1 = sheet.createRow(1);
row1.createCell(0).setCellValue("1");
row1.createCell(1).setCellValue("小明");
row1.createCell(2).setCellValue("10");
​
XSSFRow row2 = sheet.createRow(2);
row2.createCell(0).setCellValue("2");
row2.createCell(1).setCellValue("小王");
row2.createCell(2).setCellValue("20");
​
//透過輸出流將workbook物件下載到磁碟
FileOutputStream out = new FileOutputStream("D:\\test.xlsx");
workbook.write(out);
out.flush();
out.close();
workbook.close();

　　三、程式碼實現

批次匯入預約設定資訊操作過程：

1、點選模板下載按鈕下載Excel模板檔案

2、將預約設定資訊錄入到模板檔案中

3、點選上傳檔案按鈕將錄入完資訊的模板檔案上傳到伺服器

4、透過POI讀取上傳檔案的資料並儲存到資料庫

預約設定資訊對應的資料表為t_ordersetting，t_ordersetting表結構：

orderDate：預約日期

number：可預約人數

reservations：已預約人數

步驟一: 提供模板檔案
將Excel模板檔案放在backend工程的template目錄下

步驟二: 實現模板檔案下載
為模板下載按鈕繫結事件實現模板檔案下載

html程式碼：

    <el-card class="box-card">
        <div class="boxMain">
        <el-button style="margin-bottom: 20px;margin-right: 20px" type="primary" @click="downloadTemplate()">模板下載</el-button>
        <el-upload action="/ordersetting/upload.do"
                   name="excelFile"
                   :show-file-list="false"
                   :on-success="handleSuccess"
                   :before-upload="beforeUpload">
            <el-button type="primary">上傳檔案</el-button>
        </el-upload>
    </div>
    <div>
        操作說明：請點選"模板下載"按鈕獲取模板檔案，在模板檔案中錄入預約設定資料後點選"上傳檔案"按鈕上傳模板檔案。
    </div>
</el-card>

javascript程式碼：

//上傳之前進行檔案格式校驗
    beforeUpload(file){
        const isXLS = file.type === 'application/vnd.ms-excel';
        if(isXLS){
            return true;
        }
        const isXLSX = file.type === 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
        if (isXLSX) {
            return true;
        }
        this.$message.error('上傳檔案只能是xls或者xlsx格式!');
        return false;
    },
    //下載模板檔案
    downloadTemplate(){
        window.location.href="../../template/ordersetting_template.xlsx";
    },
    //上傳成功提示
    handleSuccess(response, file) {
        if(response.flag){
            this.$message({
                message: response.message,
                type: 'success'
            });
        }else{
            this.$message.error(response.message);
        }
        console.log(response, file, fileList);
    },

步驟三: 檔案上傳
使用ElementUI的上傳元件實現檔案上傳並繫結相關事件

html程式碼：

 <el-card class="box-card">
        <div class="boxMain">
        <el-button style="margin-bottom: 20px;margin-right: 20px" type="primary" @click="downloadTemplate()">模板下載</el-button>
        <el-upload action="/ordersetting/upload.do"
                   name="excelFile"
                   :show-file-list="false"
                   :on-success="handleSuccess"
                   :before-upload="beforeUpload">
            <el-button type="primary">上傳檔案</el-button>
        </el-upload>
    </div>
    <div>
        操作說明：請點選"模板下載"按鈕獲取模板檔案，在模板檔案中錄入預約設定資料後點選"上傳檔案"按鈕上傳模板檔案。
    </div>
</el-card>

javascript程式碼：

//上傳之前進行檔案格式校驗
    beforeUpload(file){
        const isXLS = file.type === 'application/vnd.ms-excel';
        if(isXLS){
            return true;
        }
        const isXLSX = file.type === 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
        if (isXLSX) {
            return true;
        }
        this.$message.error('上傳檔案只能是xls或者xlsx格式!');
        return false;
    },
    //下載模板檔案
    downloadTemplate(){
        window.location.href="../../template/ordersetting_template.xlsx";
    },
    //上傳成功提示
    handleSuccess(response, file) {
        if(response.flag){
            this.$message({
                message: response.message,
                type: 'success'
            });
        }else{
            this.$message.error(response.message);
        }
        console.log(response, file, fileList);
    },

步驟四: Controller

在common工程中，編寫POIUtils工具類，在backend工程建立Controller並提供upload方法處理

    /**
     * Excel檔案上傳，解析檔案內容儲存到資料庫,實現預約設定資料批次匯入
     * @param excelFile
     * @return
     */
    @RequestMapping("/upload")
    public Result upload(@RequestParam("excelFile")MultipartFile excelFile){
 
        try {
            List<String[]> list = POIUtils.readExcel(excelFile);//使用POI解析表格資料
            if(list != null && list.size() > 0){
                List<OrderSetting> orderSettingList = new ArrayList<>();
                for (String[] strings : list) {
                    OrderSetting orderSetting =
                            new OrderSetting(new Date(strings[0]), Integer.parseInt(strings[1]));
                    orderSettingList.add(orderSetting);
                }
                orderSettingService.add(orderSettingList);
            }
        } catch (IOException e) {
            e.printStackTrace();
            return new Result(false, MessageConstant.IMPORT_ORDERSETTING_FAIL);
        }
        return new Result(true,MessageConstant.IMPORT_ORDERSETTING_SUCCESS);
    }

步驟五：編寫OrderSettingService 服務介面和服務實現類

為了避免重複匯入，需要先判斷當前日期是否已經進行設定，如果沒有進行預約設定直接insert新增設定，如果已經進行預約設定就需要更新設定。

服務介面：

import com.it.pojo.OrderSetting;
import java.util.List;
import java.util.Map;
​
public interface OrderSettingService {
    public void add(List<OrderSetting> list);
}

服務實現類：

/**
 * 預約設定服務
 */
@Service(interfaceClass = OrderSettingService.class)
@Transactional
public class OrderSettingServiceImpl implements OrderSettingService {
    @Autowired
    private OrderSettingDao orderSettingDao;
    //批次新增
    public void add(List<OrderSetting> list) {
        if(list != null && list.size() > 0){
            for (OrderSetting orderSetting : list) {
                //檢查此資料（日期）是否存在
                long count = orderSettingDao.findCountByOrderDate(orderSetting.getOrderDate());
                if(count > 0){
                    //已經存在，執行更新操作
                    orderSettingDao.editNumberByOrderDate(orderSetting);
                }else{
                    //不存在，執行新增操作
                    orderSettingDao.add(orderSetting);
                }
            }
        }
    }
}

步驟六：編寫Dao介面和實現

實現完成，啟動專案執行測試批次匯入預約設定。