1. 接口文档自动输出

riku

2022-06-09 9867f6d5c5bccfe52b878c344c536905dd6b309e

 src/main/kotlin/cn/flightfeather/supervision/lightshare/web/DeviceController.kt

@@ -15,46 +15,47 @@
    @ApiOperation(value = "获取净化设备信息")
    @GetMapping("/purify/info")
    fun getPurifyDeviceInfo(
            @RequestParam("userId") userId: String
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String
    ) = deviceService.getPurifyDeviceInfo(userId)

    @ApiOperation(value = "获取监测设备信息")
    @GetMapping("/monitor/info")
    fun getMonitorDeviceInfo(
            @RequestParam("userId") userId: String
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String
    ) = deviceService.getMonitorDeviceInfo(userId)

    @ApiOperation(value = "获取用户监测设备的分钟数据", notes = "目前默认返回最新的15条数据，按时间升序排列")
    @GetMapping("/min/value")
    fun getLatestMinuteValue(
            @ApiParam(value = "用户id") @RequestParam("userId") userId: String
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String
    ) = deviceService.getLatestMinuteValue(userId)

    @ApiOperation(value = "获取用户监测设备的小时数据", notes = "默认返回最新的15小时数据, 按时间升序排列")
    @GetMapping("/hour/value")
    fun getLatestHourValue(
            @ApiParam(value = "用户id") @RequestParam("userId") userId: String
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String
    ) = deviceService.getLatestHourValue(userId)

    @ApiOperation(value = "获取月度均值数据")
    @PostMapping("/avg/mon/value")
    fun getMonAvgData(
            @ApiParam(value = "用户id") @RequestParam("userId") userId: String,
            @ApiParam(value = "时间") @RequestBody timeList: List<DateVo>
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String,
        @ApiParam(value = "时间") @RequestBody timeList: List<DateVo>
    ) = deviceService.getMonAvgData(userId, timeList)

    @ApiOperation(value = "获取用户监测设备的历史数据", notes = "")
    @GetMapping("/history/value")
    fun getHistoryValue(
            @ApiParam(value = "用户id") @RequestParam("userId") userId: String,
            @ApiParam(value = "开始时间", example = "yyyy-MM-dd HH:mm") @RequestParam("startTime") startTime: String,
            @ApiParam(value = "结束时间", example = "yyyy-MM-dd HH:mm") @RequestParam("endTime") endTime: String,
            @ApiParam(value = "采样周期, 0：分钟均值;1：小时均值;(目前只支持分钟均值)", allowableValues = "0") @RequestParam("period") period: Byte
        @ApiParam(value = "用户id") @RequestParam("userId") userId: String,
        @ApiParam(value = "开始时间", example = "yyyy-MM-dd HH:mm") @RequestParam("startTime") startTime: String,
        @ApiParam(value = "结束时间", example = "yyyy-MM-dd HH:mm") @RequestParam("endTime") endTime: String,
        @ApiParam(value = "采样周期", example = "0：分钟均值；1：小时均值;(目前只支持分钟均值)") @RequestParam("period") period: Byte
    ) = deviceService.getHistoryValue(userId, startTime, endTime, period)

    @ApiOperation(value = "获取每个监测设备的最新分钟数据", notes = "")
    @GetMapping("/min/value/real_time")
    fun getRealTimeData(
            @ApiParam(value = "页数") @RequestParam("page") page: Int,
            @ApiParam(value = "每页数据量") @RequestParam("per_page") perPage: Int
        @ApiParam(value = "页数") @RequestParam("page") page: Int,
        @ApiParam(value = "每页数据量") @RequestParam("per_page") perPage: Int
    ) = deviceService.getRealTimeData(page, perPage)
}