QueryRoomsByOwnerCmd.java
8.15 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
/**
* 查询业主房屋信息命令类
*
* 该命令类用于处理查询业主房屋信息的请求，支持通过业主ID或业主姓名模糊查询房屋信息，
* 并返回包含房屋基本信息、欠费情况等详细数据的响应
*
* @author 吴学文
* @version 1.0
* @since 2023
*/
package com.java110.community.cmd.room;
import com.alibaba.fastjson.JSONObject;
import com.java110.community.bmo.room.IQueryRoomStatisticsBMO;
import com.java110.core.annotation.Java110Cmd;
import com.java110.core.context.ICmdDataFlowContext;
import com.java110.core.event.cmd.Cmd;
import com.java110.core.event.cmd.CmdEvent;
import com.java110.doc.annotation.*;
import com.java110.dto.room.RoomDto;
import com.java110.intf.community.IFloorInnerServiceSMO;
import com.java110.intf.community.IRoomInnerServiceSMO;
import com.java110.utils.exception.CmdException;
import com.java110.utils.util.Assert;
import com.java110.utils.util.BeanConvertUtil;
import com.java110.utils.util.StringUtil;
import com.java110.vo.api.ApiRoomDataVo;
import com.java110.vo.api.ApiRoomVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import java.util.List;
@Java110CmdDoc(title = "查询业主房屋",
description = "查询业主房屋信息",
httpMethod = "get",
url = "http://{ip}:{port}/app/room.queryRoomsByOwner",
resource = "communityDoc",
author = "吴学文",
serviceCode = "room.queryRoomsByOwner",
seq = 17
)
@Java110ParamsDoc(params = {
@Java110ParamDoc(name = "page", type = "int", length = 11, remark = "页数"),
@Java110ParamDoc(name = "row", type = "int", length = 11, remark = "行数"),
@Java110ParamDoc(name = "communityId", length = 30, remark = "项目ID"),
@Java110ParamDoc(name = "ownerId", length = 30, remark = "业主ID"),
})
@Java110ResponseDoc(
params = {
@Java110ParamDoc(name = "records", type = "int", length = 11, remark = "总页数"),
@Java110ParamDoc(name = "total", type = "int", length = 11, remark = "总数据"),
@Java110ParamDoc(name = "rooms", type = "Object", remark = "有效数据"),
@Java110ParamDoc(parentNodeName = "rooms", name = "roomName", type = "String", remark = "房屋名称"),
@Java110ParamDoc(parentNodeName = "rooms", name = "roomId", type = "String", remark = "房屋编号"),
}
)
@Java110ExampleDoc(
reqBody = "http://{ip}:{port}/app/room.queryRoomsByOwner?ownerId=123123&page=1&row=10&communityId=2022081539020475",
resBody = "{\"page\":0,\"records\":1,\"rooms\":[{\"apartment\":\"10101\",\"apartmentName\":\"一室一厅\",\"builtUpArea\":\"11.00\",\"endTime\":\"2037-01-01 00:00:00\",\"feeCoefficient\":\"1.00\",\"floorId\":\"732022081690440002\",\"floorNum\":\"D\",\"idCard\":\"\",\"layer\":\"1\",\"link\":\"18909711447\",\"ownerId\":\"772022082070860017\",\"ownerName\":\"张杰\",\"remark\":\"11\",\"roomArea\":\"11.00\",\"roomAttrDto\":[{\"attrId\":\"112022082081600012\",\"listShow\":\"Y\",\"page\":-1,\"records\":0,\"roomId\":\"752022082030880010\",\"row\":0,\"specCd\":\"9035007248\",\"specName\":\"精装修\",\"statusCd\":\"0\",\"total\":0,\"value\":\"20\",\"valueName\":\"20\"}],\"roomId\":\"752022082030880010\",\"roomName\":\"D-1-1001\",\"roomNum\":\"1001\",\"roomRent\":\"0.00\",\"roomSubType\":\"110\",\"roomSubTypeName\":\"住宅\",\"roomType\":\"1010301\",\"section\":\"1\",\"startTime\":\"2022-09-03 18:50:53\",\"state\":\"2001\",\"stateName\":\"已入住\",\"unitId\":\"742022082058950007\",\"unitNum\":\"1\"}],\"rows\":0,\"total\":2}"
)
@Java110Cmd(serviceCode = "room.queryRoomsByOwner")
public class QueryRoomsByOwnerCmd extends Cmd {
@Autowired
private IFloorInnerServiceSMO floorInnerServiceSMOImpl;
@Autowired
private IRoomInnerServiceSMO roomInnerServiceSMOImpl;
@Autowired
private IQueryRoomStatisticsBMO queryRoomStatisticsBMOImpl;
/**
* 请求参数验证方法
*
* 验证请求参数的有效性，确保必要的参数存在且不为空
*
* @param event 命令事件对象
* @param context 命令数据流上下文
* @param reqJson 请求的JSON数据
* @throws CmdException 当参数验证失败时抛出异常
*/
@Override
public void validate(CmdEvent event, ICmdDataFlowContext context, JSONObject reqJson) throws CmdException {
// 验证项目ID参数是否存在且不为空
Assert.hasKeyAndValue(reqJson, "communityId", "请求中未包含communityId信息");
//Assert.jsonObjectHaveKey(reqJson, "ownerId", "请求中未包含ownerId信息");
Assert.hasLength(reqJson.getString("communityId"), "项目ID不能为空");
//Assert.hasLength(reqJson.getString("ownerId"), "业主ID不能为空");
// 获取业主ID和业主姓名模糊查询参数
String ownerId = reqJson.getString("ownerId");
String ownerNameLike = reqJson.getString("ownerNameLike");
// 验证至少提供一种业主查询条件（业主ID或业主姓名模糊查询）
if (StringUtil.isEmpty(ownerId) && StringUtil.isEmpty(ownerNameLike)) {
throw new IllegalArgumentException("未包含业主信息");
}
}
/**
* 执行查询业主房屋命令
*
* 处理查询业主房屋信息的业务逻辑，包括：
* 1. 转换请求参数为RoomDto对象
* 2. 处理房屋编号参数
* 3. 查询房屋信息
* 4. 查询房屋欠费情况
* 5. 构建并返回响应结果
*
* @param event 命令事件对象
* @param context 命令数据流上下文
* @param reqJson 请求的JSON数据
* @throws CmdException 当命令执行过程中发生错误时抛出异常
*/
@Override
public void doCmd(CmdEvent event, ICmdDataFlowContext context, JSONObject reqJson) throws CmdException {
// 将请求JSON转换为RoomDto对象
RoomDto roomDto = BeanConvertUtil.covertBean(reqJson, RoomDto.class);
// 处理房屋编号参数，如果存在则解析为楼层号、单元号和房间号
hasRoomNum(reqJson, roomDto);
// 创建响应对象
ApiRoomVo apiRoomVo = new ApiRoomVo();
// 查询业主房屋信息
List<RoomDto> roomDtoList = roomInnerServiceSMOImpl.queryRoomsByOwner(roomDto);
// 查询房屋欠费情况
roomDtoList = queryRoomStatisticsBMOImpl.queryRoomOweFee(roomDtoList);
// 设置响应数据
apiRoomVo.setTotal(roomDtoList.size()); // 设置总记录数
apiRoomVo.setRooms(BeanConvertUtil.covertBeanList(roomDtoList, ApiRoomDataVo.class)); // 转换房屋数据列表
apiRoomVo.setRecords(1); // 设置总页数
// 构建HTTP响应
ResponseEntity<String> responseEntity = new ResponseEntity<String>(JSONObject.toJSONString(apiRoomVo), HttpStatus.OK);
context.setResponseEntity(responseEntity);
}
/**
* 处理房屋编号参数
*
* 如果请求中包含房屋编号参数，将其解析为楼层号、单元号和房间号
* 房屋编号格式应为：楼层号-单元号-房间号（例如：D-1-1001）
*
* @param reqJson 请求的JSON数据
* @param roomDto 房屋数据传输对象
*/
private void hasRoomNum(JSONObject reqJson, RoomDto roomDto) {
// 检查请求中是否包含房屋编号参数
if (!reqJson.containsKey("roomNum")) {
return;
}
// 获取房屋编号
String roomNum = reqJson.getString("roomNum");
if (StringUtil.isEmpty(roomNum)) {
return;
}
// 按"-"分割房屋编号，格式应为：楼层号-单元号-房间号
String[] roomNums = reqJson.getString("roomNum").split("-");
// 如果分割后得到3个部分，则分别设置到RoomDto对象中
if (roomNums != null && roomNums.length == 3) {
roomDto.setFloorNum(roomNums[0]); // 设置楼层号
roomDto.setUnitNum(roomNums[1]); // 设置单元号
roomDto.setRoomNum(roomNums[2]); // 设置房间号
}
}
}