refactor(swagger): 迁移Swagger注解到OpenAPI 3.0

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/waterrecord/pojo/WaterRecord.java

@@ -3,8 +3,7 @@
import com.baomidou.mybatisplus.annotation.*;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.ruoyi.framework.aspectj.lang.annotation.Excel;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

@@ -18,7 +17,7 @@
 */
@Data
@TableName("water_record")
@ApiModel
@Schema
public class WaterRecord {


@@ -30,21 +29,21 @@
    /**
     * 规格型号
     */
    @ApiModelProperty("规格型号")
    @Schema(description = "规格型号")
    @Excel(name = "规格型号")
    private String deviceModel;

    /**
     * 用水类型
     */
    @ApiModelProperty("用水类型")
    @Schema(description = "用水类型")
    @Excel(name = "用水类型", readConverterExp = "industrial=工业用水,domestic=生活用水,fire=消防用水,greening=绿化用水")
    private String type;

    /**
     * 设备名称
     */
    @ApiModelProperty("设备名称")
    @Schema(description = "设备名称")
    @Excel(name = "设备名称")
    @TableField(exist = false)
    private String deviceName;
@@ -54,21 +53,21 @@
    /**
     * 额定流量
     */
    @ApiModelProperty("额定流量")
    @Schema(description = "额定流量")
    @Excel(name = "额定流量")
    private String ratedRate;

    /**
     * 实际流量
     */
    @ApiModelProperty("实际流量")
    @Schema(description = "实际流量")
    @Excel(name = "实际流量")
    private String actualTraffic;

    /**
     * 运行时间
     */
    @ApiModelProperty("运行时间")
    @Schema(description = "运行时间")
    @Excel(name = "运行时间", width = 30, dateFormat = "yyyy-MM-dd")
    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
    @DateTimeFormat(pattern = "yyyy-MM-dd")
@@ -78,28 +77,28 @@
    /**
     * 当日用水量
     */
    @ApiModelProperty("当日用水量")
    @Schema(description = "当日用水量")
    @Excel(name = "当日用水量")
    private String waterDay;

    /**
     * 每日限制水量
     */
    @ApiModelProperty("每日限制水量")
    @Schema(description = "每日限制水量")
    @Excel(name = "每日限制水量")
    private String waterDayLimit;

    /**
     * 水费单价
     */
    @ApiModelProperty("水费单价")
    @Schema(description = "水费单价")
    @Excel(name = "水费单价")
    private String waterPrice;

    /**
     * 备注
     */
    @ApiModelProperty("备注")
    @Schema(description = "备注")
    private String remarks;

    /**
@@ -132,4 +131,7 @@
    @TableField(fill = FieldFill.INSERT)
    private Long tenantId;


    @TableField(fill = FieldFill.INSERT)
    private Long deptId;
}