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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/safe/pojo/SafeTraining.java

@@ -11,8 +11,7 @@
import java.time.LocalDateTime;

import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Getter;
import lombok.Setter;
import org.springframework.format.annotation.DateTimeFormat;
@@ -30,7 +29,7 @@
@Getter
@Setter
@TableName("safe_training")
@ApiModel(value = "SafeTraining对象", description = "安全生产--安全培训考核")
@Schema(name = "SafeTraining对象", description = "安全生产--安全培训考核")
public class SafeTraining implements Serializable {

    private static final long serialVersionUID = 1L;
@@ -38,68 +37,68 @@
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    @ApiModelProperty("课程编号")
    @Schema(description = "课程编号")
    private String courseCode;

    @ApiModelProperty("培训目标")
    @Schema(description = "培训目标")
    private String trainingObjectives;

    @ApiModelProperty("培训内容")
    @Schema(description = "培训内容")
    private String trainingContent;

    @ApiModelProperty("培训方式")
    @Schema(description = "培训方式")
    private String trainingMode;

    @ApiModelProperty("状态(0：未开始1：进行中；2：已结束)")
    @Schema(description = "状态(0：未开始1：进行中；2：已结束)")
    private Integer state;

    @ApiModelProperty("参加对象")
    @Schema(description = "参加对象")
    private String participants;

    @ApiModelProperty("培训地点")
    @Schema(description = "培训地点")
    private String placeTraining;

    @ApiModelProperty("培训讲师")
    @Schema(description = "培训讲师")
    private String trainingLecturer;

    @ApiModelProperty("培训日期")
    @Schema(description = "培训日期")
    @JsonFormat(pattern = "yyyy-MM-dd")
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    @NotBlank(message = "培训日期不能为空")
    private LocalDate trainingDate;

    @ApiModelProperty("开始时间(时分秒)")
    @Schema(description = "开始时间(时分秒)")
    @NotBlank(message = "开始时间不能为空")
    private String openingTime;

    @ApiModelProperty("结束时间(时分秒)")
    @Schema(description = "结束时间(时分秒)")
    @NotBlank(message = "结束时间不能为空")
    private String endTime;

    @ApiModelProperty("课题学分")
    @Schema(description = "课题学分")
    private String projectCredits;

    @ApiModelProperty("课时")
    @Schema(description = "课时")
    private Double classHour;

    @ApiModelProperty("考核方式")
    @Schema(description = "考核方式")
    private String assessmentMethod;

    @ApiModelProperty("本次培训综合评价")
    @Schema(description = "本次培训综合评价")
    private String comprehensiveAssessment;

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

    @ApiModelProperty("评价人id")
    @Schema(description = "评价人id")
    private Integer assessmentUserId;

    @ApiModelProperty("评价时间")
    @Schema(description = "评价时间")
    @JsonFormat(pattern = "yyyy-MM-dd")
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    private LocalDate assessmentDate;

    @ApiModelProperty("培训摘要")
    @Schema(description = "培训摘要")
    private String trainingAbstract;

    @TableField(fill = FieldFill.INSERT)