【苍穹外卖】项目实战Day13

🔥 本文由 程序喵正在路上 原创，CSDN首发！
💖 系列专栏：苍穹外卖项目实战
🌠 首发时间：2024年5月22日
🦋 欢迎关注🖱点赞👍收藏🌟留言🐾

工作台

需求分析和设计

工作台是系统运营的数据看板，并提供快捷操作入口，可以有效提高商家的工作效率。

工作台展示的数据有：

• 今日数据
• 订单管理
• 菜品总览
• 套餐总览
• 订单信息

名词解释：

• 营业额：已完成订单的总金额
• 有效订单：已完成订单的数量
• 订单完成率：有效订单数 / 总订单数 * 100%
• 平均客单价：营业额 / 有效订单数
• 新增用户：新增用户的数量

接口设计：

• 今日数据接口

  

• 订单管理接口

  

• 菜品总览接口

  

• 套餐总览接口

  

• 订单搜索（已完成）

• 各个状态的订单数量统计（已完成）

代码导入

由于这部分的代码比较简单，所以我们直接导入资料中的工作台模块功能代码即可：

功能测试

Apache POI

介绍

Apache POI 是一个处理 Miscrosoft Office 各种文件格式的开源项目。简单来说就是，我们可以使用 POI 在 Java 程序中对 Miscrosoft Office 各种文件进行读写操作。

一般情况下，POI 都是用于操作 Excel 文件。

Apache POI 的应用场景：

• 银行网银系统导出交易明细
• 各种业务系统导出 Excel 报表
• 批量导入业务数据

入门案例

使用 Apache POI 需要导入它的 maven 坐标（项目中已存在）：

<dependency>
	   <groupId>org.apache.poi</groupId>
	   <artifactId>poi</artifactId>
	   <version>${poi}</version>
</dependency>
<dependency>
	   <groupId>org.apache.poi</groupId>
	   <artifactId>poi-ooxml</artifactId>
	   <version>${poi}</version>
</dependency>

我们这里写了一个简单的测试类，里面包含了 POI 写入 excel 文件和 POI 读取 excel 文件两个方法：

import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;

/**
 * 使用POI操作Excel文件
 */
public class POITest {

    /**
     * 通过POI创建Excel文件并且写入文件内容
     */
    public static void write() throws Exception {
        //在内存中创建一个Excel文件
        XSSFWorkbook excel = new XSSFWorkbook();

        //在Excel文件中创建一个Sheet页
        XSSFSheet sheet = excel.createSheet("info");

        //在Sheet中创建行对象,rownum编号从0开始
        XSSFRow row = sheet.createRow(1);

        //创建单元格并且写入文件内容
        row.createCell(1).setCellValue("姓名");
        row.createCell(2).setCellValue("城市");

        //创建一个新行
        row = sheet.createRow(2);
        row.createCell(1).setCellValue("张三");
        row.createCell(2).setCellValue("北京");

        row = sheet.createRow(3);
        row.createCell(1).setCellValue("李四");
        row.createCell(2).setCellValue("南京");

        //通过输出流将内存中的Excel文件写入到磁盘
        FileOutputStream out = new FileOutputStream(new File("D:\\info.xlsx"));
        excel.write(out);

        //关闭资源
        out.close();
        excel.close();
    }


    /**
     * 通过POI读取Excel文件中的内容
     *
     * @throws Exception
     */
    public static void read() throws Exception {
        InputStream in = new FileInputStream(new File("D:\\info.xlsx"));

        //读取磁盘上已经存在的Excel文件
        XSSFWorkbook excel = new XSSFWorkbook(in);

        //读取Excel文件中的第一个Sheet页
        XSSFSheet sheet = excel.getSheetAt(0);

        //获取Sheet中最后一行的行号
        int lastRowNum = sheet.getLastRowNum();

        for (int i = 1; i <= lastRowNum; i++) {
            //获得某一行
            XSSFRow row = sheet.getRow(i);

            //获得单元格对象
            String cellValue1 = row.getCell(1).getStringCellValue();
            String cellValue2 = row.getCell(2).getStringCellValue();
            System.out.println(cellValue1 + " " + cellValue2);
        }

        //关闭资源
        in.close();
        excel.close();
    }

    public static void main(String[] args) throws Exception {
//        write();
        read();
    }
}

导出运营数据Excel报表

需求分析和设计

产品原型：

导出的 Excel 报表格式：

业务规则：

• 导出 Excel 形式的报表文件
• 导出最近 30 天的运营数据

接口设计：

注意：当前接口没有返回数据，因为报表导出功能本质上是文件下载，服务端会通过输出流将 Excel 文件下载到客户端浏览器。

代码开发

实现步骤：

• 设计 Excel 模板文件

  虽然我们可以使用 POI 来设计 excel 报表的格式，但是当报表的格式比较复杂时，用 POI 来写还是有点麻烦的。所以我们一般都是先将 excel 文件的模板创建好，后面我们在这个基础上再填充数据即可。

  运营数据 Excel 报表的模板在资料中已给出：

  

• 查询近 30 天的运营数据

• 将查询到的运营数据写入模板文件

• 通过输出流将 Excel 文件下载到客户端浏览器

在 resources 下新建目录 template，将资料中的运营数据报表模板复制一份，粘贴到 template 下，记得改一个英文名，不然后面会报空指针异常，原因未知。

根据接口定义，在 ReportController 中创建 export 方法：

/**
 * 导出运营数据报表
 *
 * @param response
 */
@GetMapping("/export")
@ApiOperation("导出运营数据报表")
public void export(HttpServletResponse response) {
    reportService.exportBusinessData(response);
}

在 ReportService 接口中声明导出运营数据报表的方法：

/**
 * 导出近30天的运营数据报表
 *
 * @param response
 */
void exportBusinessData(HttpServletResponse response);

在 ReportServiceImpl 实现类中实现导出运营数据报表的方法：

/**
 * 导出近30天的运营数据报表
 *
 * @param response
 */
public void exportBusinessData(HttpServletResponse response) {
    LocalDate begin = LocalDate.now().minusDays(30);    //统计开始时间为30天前
    LocalDate end = LocalDate.now().minusDays(1);       //结束时间为昨天

    //查询概览运营数据
    BusinessDataVO businessData = workspaceService.getBusinessData(LocalDateTime.of(begin, LocalTime.MIN), LocalDateTime.of(end, LocalTime.MAX));

    InputStream in = this.getClass().getClassLoader().getResourceAsStream("template/reportTemplate.xlsx");
    try {
        //基于提供好的模板文件创建一个新的excel表格对象
        XSSFWorkbook excel = new XSSFWorkbook(in);

        //获取excel文件中的一个sheet页
        XSSFSheet sheet = excel.getSheet("sheet1");
        sheet.getRow(1).getCell(1).setCellValue(begin + "至" + end); //设置起止时间

        //填充运营概览数据
        //获得第4行
        XSSFRow row = sheet.getRow(3);
        row.getCell(2).setCellValue(businessData.getTurnover());                //设置营业额
        row.getCell(4).setCellValue(businessData.getOrderCompletionRate());     //设置订单完成率
        row.getCell(6).setCellValue(businessData.getNewUsers());                //设置新增用户数

        //获得第5行
        row = sheet.getRow(4);
        row.getCell(2).setCellValue(businessData.getValidOrderCount()); //设置有效订单
        row.getCell(4).setCellValue(businessData.getUnitPrice());       //设置平均客单价

        //填充运营明细数据
        for (int i = 0; i < 30; ++i) {
            LocalDate date = begin.plusDays(i);

            //准备明细数据
            businessData = workspaceService.getBusinessData(LocalDateTime.of(date, LocalTime.MIN), LocalDateTime.of(date, LocalTime.MAX));

            //获得这一天在表格中所处的行
            row = sheet.getRow(7 + i);
            row.getCell(1).setCellValue(date.toString());                       //设置日期
            row.getCell(2).setCellValue(businessData.getTurnover());            //设置营业额
            row.getCell(3).setCellValue(businessData.getValidOrderCount());     //设置有效订单
            row.getCell(4).setCellValue(businessData.getOrderCompletionRate()); //设置订单完成率
            row.getCell(5).setCellValue(businessData.getUnitPrice());           //设置平均客单价
            row.getCell(6).setCellValue(businessData.getNewUsers());            //设置新增用户数
        }

        //通过输出流将文件下载到客户端浏览器中
        ServletOutputStream out = response.getOutputStream();
        excel.write(out);

        //关闭资源
        out.flush();
        out.close();
        excel.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

功能测试