Skip to content

Commit 31cef85

Browse files
ClearAzureClearAzure
committed
DTO-增加了用户模块的增加/修改入参DTO
1 parent d77e589 commit 31cef85

14 files changed

Lines changed: 215 additions & 50 deletions

File tree

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/order/OrderAddDTO.java‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
package com.drawbluecup.dto.order;
2+
3+
//入参 DTO:前端新增订单时传，只含需要的字段
4+
5+
import io.swagger.v3.oas.annotations.media.Schema;
6+
import lombok.Data;
7+
8+
/**
9+
* 新增订单的入参DTO：只包含前端需要传递的字段
10+
*/
11+
@Data // 替代手动写getter/setter
12+
@Schema(name = "OrderAddDTO", description = "新增订单入参") // Swagger注解：文档里说明这个DTO的作用
13+
14+
public class OrderAddDTO {
15+
@Schema(description = "订单编号", required = true) // 文档里标注字段说明
16+
17+
private String orderNo; // 订单编号（前端生成/传递，唯一标识订单）
18+
19+
@Schema(description = "所属用户的id", required = true) // 文档里标注字段说明
20+
21+
private Integer userId;// 下单用户ID（关联用户表主键）
22+
23+
//DTO ，实体类的字段顺序、SQL 语句的字段顺序，三者之间互不影响，核心依赖 “字段名匹配”，和顺序无关。
24+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/order/OrderRespDTO.java‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
package com.drawbluecup.dto.order;
2+
3+
4+
import io.swagger.v3.oas.annotations.media.Schema;
5+
import lombok.Data;
6+
7+
/**
8+
* 订单出参DTO：只包含前端需要展示的字段（比如id+name）
9+
*/
10+
@Data
11+
@Schema(name = "ProductRespDTO", description = "商品信息出参")// Swagger注解：文档里说明这个DTO的作用
12+
13+
public class OrderRespDTO {
14+
15+
@Schema(description = "商品ID")// 文档里标注字段说明
16+
private Integer id; // 前端需要看的id
17+
18+
@Schema(description = "商品名称")
19+
private String name; // 前端需要看的name
20+
21+
// 没有其他字段（比如如果Product有price，不想暴露就不加）
22+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/order/OrderUpdateDTO.java‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
package com.drawbluecup.dto.order;
2+
3+
4+
import io.swagger.v3.oas.annotations.media.Schema;
5+
import lombok.Data;
6+
7+
8+
@Data
9+
@Schema(name = "OrderUpdateDTO",description = "更新商品入参")
10+
public class OrderUpdateDTO {
11+
12+
//WIP,尚未开发修改订单的功能
13+
14+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/user/UserAddDTO.java‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
package com.drawbluecup.dto.user;
2+
3+
//入参 DTO:前端传，只含需要的字段
4+
5+
import io.swagger.v3.oas.annotations.media.Schema;
6+
import lombok.Data;
7+
8+
/**
9+
* 新增用户的入参DTO：只包含前端需要传递的字段
10+
*/
11+
@Data // 替代手动写getter/setter
12+
@Schema(name = "UserAddDTO", description = "新增用户入参") // Swagger注解：文档里说明这个DTO的作用
13+
14+
public class UserAddDTO {
15+
@Schema(description = "用户名称", required = true) // 文档里标注字段说明
16+
17+
private String name; // 用户名
18+
19+
@Schema(description = "用户电话",required = true)
20+
21+
private String phone;
22+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/user/UserRespDTO.java‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
package com.drawbluecup.dto.user;
2+
3+
4+
import io.swagger.v3.oas.annotations.media.Schema;
5+
import lombok.Data;
6+
7+
/**
8+
* 商品出参DTO：只包含前端需要展示的字段（比如id+name）
9+
*/
10+
@Data
11+
@Schema(name = "ProductRespDTO", description = "商品信息出参")// Swagger注解：文档里说明这个DTO的作用
12+
13+
public class UserRespDTO {
14+
15+
//WIP
16+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/dto/user/UserUpdateDTO.java‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
package com.drawbluecup.dto.user;
2+
3+
4+
import io.swagger.v3.oas.annotations.media.Schema;
5+
import lombok.Data;
6+
7+
8+
@Data
9+
@Schema(name = "UserUpdateDTO",description = "更新用户入参")
10+
public class UserUpdateDTO {
11+
12+
@Schema(description = "用户主键id", required = true)
13+
private Integer id;
14+
15+
@Schema(description = "用户名称", required = true) // 文档里标注字段说明
16+
17+
private String name; // 用户名
18+
19+
@Schema(description = "用户电话", required = true)
20+
21+
private String phone;
22+
23+
24+
25+
}

‎drawbluecup-common/src/main/java/com/drawbluecup/result/Result.java‎

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ public class Result<T> {//给控制端作**返回对象**,从前端接收路径
55

66
//成员变量
77
private int code;
8-
private String msg;//提示信息
8+
private String message;//提示信息
99
private T data;//给前端的业务数据（查询/新增/修改后的实际数据，无数据时为null）// T是泛型，适配不同类型数据
1010

1111

@@ -16,15 +16,15 @@ public class Result<T> {//给控制端作**返回对象**,从前端接收路径
1616
public Result() {
1717

1818
}
19-
public Result(int code, String msg, T data) {
19+
public Result(int code, String message, T data) {
2020
this.code = code;
21-
this.msg = msg;
21+
this.message = message;
2222
this.data = data;
2323
}
2424

2525

2626

27-
27+
//------------------------------------------------------------------------------------------
2828
//成员方法-success
2929

3030
//无数据、固定提示：仅告知前端“操作成功”，无需返回业务数据
@@ -77,32 +77,29 @@ public static <T> Result<T> fail(Integer code, String message){
7777
private static <T> Result<T> build(int code, String message, T data){
7878
Result<T> result = new Result<>();
7979
result.setCode(code);
80-
result.setMsg(message);
80+
result.setMessage(message);
8181
result.setData(data);
8282
return result;
8383
}
8484

85-
85+
//------------------------------------------------------------------------------------------------------
8686

8787
public int getCode() {
8888
return code;
8989
}
9090
public void setCode(int code) {
9191
this.code = code;
9292
}
93-
public String getMsg() {
94-
return msg;
95-
}
96-
public void setMsg(String message) {
97-
this.msg = message;
98-
}
93+
94+
9995

10096
public String getMessage() {
101-
return msg;
97+
return message;
10298
}
10399
public void setMessage(String message) {
104-
this.msg = message;
100+
this.message = message;
105101
}
102+
106103
public T getData() {
107104
return data;
108105
}

‎drawbluecup-order/src/main/resources/mapper/OrderMapper.xml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,15 @@
2525
</collection>
2626
</resultMap>
2727

28+
<!--____________________________________________________________________________________________________________________-->
2829

2930

3031
<select id="findByUserId" resultType="com.drawbluecup.entity.Order">
3132
<!--根据id(订单外键user_id)查询订单,由于外键多为重复性,所以一般在服务层搭配主表一起输出-->
3233
select * from `order` where user_id = #{userId}
3334
</select>
3435

36+
3537
<select
3638
id="findByOrderNo"
3739
resultType="com.drawbluecup.entity.Order"
@@ -40,6 +42,7 @@
4042
SELECT * FROM `order` where order_no = #{orderNo}
4143
</select>
4244

45+
4346
<select
4447
id="findByOrderId"
4548
resultType="com.drawbluecup.entity.Order"
@@ -100,6 +103,7 @@
100103

101104

102105

106+
<!--____________________________________________________________________________________________________________________-->
103107

104108

105109

@@ -110,13 +114,22 @@
110114
delete from `order`
111115
</delete>
112116

117+
118+
119+
120+
<!--____________________________________________________________________________________________________________________-->
121+
122+
123+
124+
113125
<insert id="addOrder"
114126
parameterType="com.drawbluecup.entity.Order"
115127
>
116128
<!--新增订单-->
117129
INSERT INTO `order` (order_no,user_id,create_time) values (#{orderNo}, #{userId},NOW())
118130
</insert>
119131

132+
120133
<!--
121134
为订单添加商品（向中间表插入记录）
122135
实现订单与商品的多对多关联
@@ -127,6 +140,13 @@
127140
VALUES (#{orderId}, #{productId})
128141
</insert>
129142

143+
144+
145+
<!--____________________________________________________________________________________________________________________-->
146+
147+
148+
149+
130150
<!--
131151
从订单中移除商品（从中间表删除记录）
132152
-->

‎drawbluecup-user/src/main/resources/mapper/UserMapper.xml‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@
7070
<!--DATE_FORMAT(#{createTime}, '%Y-%m-%d') 的意思是：把前端传入的 createTime 参数（比如 2025-10-30T12:00:00），也格式化为 “年 - 月 - 日” 的字符串。-->
7171
<!--两者相等时，就表示 “数据库中 create_time 的日期部分和前端传入的 createTime 日期部分一致”，从而实现按天模糊查询（不管具体时间，只要日期相同就匹配）。-->
7272

73+
<!--____________________________________________________________________________________________________________________-->
7374

7475

7576
<insert
@@ -80,6 +81,8 @@
8081
INSERT INTO user (name, phone,create_time,update_time) values (#{name}, #{phone},NOW(), NOW())
8182
</insert>
8283

84+
<!--____________________________________________________________________________________________________________________-->
85+
8386

8487
<delete
8588
id="delete"
@@ -96,6 +99,7 @@
9699
</delete>
97100

98101

102+
<!--____________________________________________________________________________________________________________________-->
99103

100104

101105
<update

‎drawbluecup-web/src/main/java/com/drawbluecup/web/config/SpringDocConfig.java‎

Lines changed: 0 additions & 27 deletions
This file was deleted.

0 commit comments

Comments
 (0)