Update DeliveryOrderParam.java

cyj
pbvfus8to 8 months ago
parent f96966b9e1
commit faf78b4efa

@ -8,52 +8,77 @@
*
*/
// 该类所属的包名表明其位于商城相关的Java Bean的参数param包下通常用于封装前端传递给后端的参数信息方便在业务逻辑中对这些参数进行统一的验证、获取和使用。
package com.yami.shop.bean.param;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
/**
* DeliveryOrderParamJava Bean便
* 使Jakarta Validation@NotBlank使Swagger@SchemaAPI
*
* @author lanhai
*/
public class DeliveryOrderParam {
@NotBlank(message="订单号不能为空")
@Schema(description = "订单号" ,required=true)
private String orderNumber;
@NotBlank(message="快递公司id不能为空")
@Schema(description = "快递公司" ,required=true)
private Long dvyId;
@NotBlank(message="物流单号不能为空")
@Schema(description = "物流单号" ,required=true)
private String dvyFlowId;
// 使用@NotBlank注解对orderNumber字段进行约束表明该字段不能为空字符串当验证不通过时即传入的订单号为空字符串会按照message属性中定义的提示信息“订单号不能为空”进行错误提示。
// 同时使用@Schema注解对该字段在Swagger生成的API文档中进行描述说明其代表“订单号”并且是必填项required=true方便接口使用者了解该参数的含义和要求。
@NotBlank(message = "订单号不能为空")
@Schema(description = "订单号", required = true)
private String orderNumber;
// 类似地对dvyId字段使用@NotBlank注解进行约束要求该字段不能为空验证不通过时提示“快递公司id不能为空”。
// 通过@Schema注解在API文档中描述其代表“快递公司”且为必填项这里的Long类型可能对应着快递公司在系统中的唯一标识符用于明确指定发货所使用的快递公司。
@NotBlank(message = "快递公司id不能为空")
@Schema(description = "快递公司", required = true)
private Long dvyId;
public Long getDvyId() {
return dvyId;
}
// 对dvyFlowId字段同样使用@NotBlank注解确保其不能为空不符合要求时提示“物流单号不能为空”并通过@Schema注解在API文档里说明其代表“物流单号”且是必填项
// 物流单号用于追踪货物运输的具体情况,是发货流程中必不可少的关键信息。
@NotBlank(message = "物流单号不能为空")
@Schema(description = "物流单号", required = true)
private String dvyFlowId;
public void setDvyId(Long dvyId) {
this.dvyId = dvyId;
}
/**
* IDGetter便使ID
*/
public Long getDvyId() {
return dvyId;
}
public String getDvyFlowId() {
return dvyFlowId;
}
/**
* IDSetterdvyIdID便使
*/
public void setDvyId(Long dvyId) {
this.dvyId = dvyId;
}
public void setDvyFlowId(String dvyFlowId) {
this.dvyFlowId = dvyFlowId;
}
/**
* Getter便
*/
public String getDvyFlowId() {
return dvyFlowId;
}
public String getOrderNumber() {
return orderNumber;
}
/**
* SetterdvyFlowId便
*/
public void setDvyFlowId(String dvyFlowId) {
this.dvyFlowId = dvyFlowId;
}
public void setOrderNumber(String orderNumber) {
this.orderNumber = orderNumber;
}
/**
* Getter
*/
public String getOrderNumber() {
return orderNumber;
}
}
/**
* SetterorderNumber便
*/
public void setOrderNumber(String orderNumber) {
this.orderNumber = orderNumber;
}
}
Loading…
Cancel
Save