Blame view

service-acct/src/main/java/com/java110/acct/cmd/invoice/SaveOwnerInvoiceCmd.java 5.36 KB
88e030b7   王彪总   init project
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
  /*
   * Copyright 2017-2020 吴学文 and java110 team.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package com.java110.acct.cmd.invoice;
  
  import com.alibaba.fastjson.JSONObject;
  import com.java110.core.annotation.Java110Cmd;
  import com.java110.core.annotation.Java110Transactional;
  import com.java110.core.context.ICmdDataFlowContext;
  import com.java110.core.event.cmd.Cmd;
  import com.java110.core.event.cmd.CmdEvent;
  import com.java110.core.factory.GenerateCodeFactory;
  import com.java110.intf.acct.IOwnerInvoiceV1InnerServiceSMO;
  import com.java110.po.invoice.OwnerInvoicePo;
  import com.java110.utils.exception.CmdException;
  import com.java110.utils.util.Assert;
  import com.java110.utils.util.BeanConvertUtil;
  import com.java110.vo.ResultVo;
  import org.springframework.beans.factory.annotation.Autowired;
  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  
  /**
   * 类表述:保存业主发票信息命令类
   * 服务编码:ownerInvoice.saveOwnerInvoice
   * 请求路劲:/app/ownerInvoice.SaveOwnerInvoice
   * add by 吴学文 at 2023-10-08 16:21:23 mail: 928255095@qq.com
   * open source address: https://gitee.com/wuxw7/MicroCommunity
   * 官网:http://www.homecommunity.cn
   * 温馨提示:如果您对此文件进行修改 请不要删除原有作者及注释信息,请补充您的 修改的原因以及联系邮箱如下
   * // modify by 张三 at 2021-09-12 第10行在某种场景下存在某种bug 需要修复,注释10至20行 加入 20行至30行
   * 
   * 功能描述:处理业主发票信息保存的Cmd命令类,负责接收前端请求并保存业主发票信息
   * 主要职责:
   * 1. 验证请求参数的完整性
   * 2. 将请求数据转换为持久化对象
   * 3. 调用服务层保存发票信息
   * 4. 处理保存结果并返回响应
   */
  @Java110Cmd(serviceCode = "invoice.saveOwnerInvoice")
  public class SaveOwnerInvoiceCmd extends Cmd {
  
      /**
       * 日志记录器
       */
      private static Logger logger = LoggerFactory.getLogger(SaveOwnerInvoiceCmd.class);
  
      /**
       * ID生成前缀,用于生成发票记录的唯一标识
       */
      public static final String CODE_PREFIX_ID = "10";
  
      /**
       * 业主发票服务接口,用于调用发票相关的业务操作
       */
      @Autowired
      private IOwnerInvoiceV1InnerServiceSMO ownerInvoiceV1InnerServiceSMOImpl;
  
      /**
       * 参数验证方法
       * 验证请求参数是否完整和有效
       *
       * @param event Cmd事件对象,包含请求相关信息
       * @param cmdDataFlowContext 命令数据流上下文,用于获取和设置请求响应数据
       * @param reqJson 请求参数的JSON对象
       * @throws CmdException 当参数验证失败时抛出异常
       */
      @Override
      public void validate(CmdEvent event, ICmdDataFlowContext cmdDataFlowContext, JSONObject reqJson) {
          // 验证业主ID参数是否存在
          Assert.hasKeyAndValue(reqJson, "ownerId", "请求报文中未包含ownerId");
          // 验证业主姓名参数是否存在
          Assert.hasKeyAndValue(reqJson, "ownerName", "请求报文中未包含ownerName");
          // 验证发票类型参数是否存在
          Assert.hasKeyAndValue(reqJson, "invoiceType", "请求报文中未包含invoiceType");
9750b443   王彪总   fix(config): 更新配置...
88
          // 验证项目ID参数是否存在
88e030b7   王彪总   init project
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
          Assert.hasKeyAndValue(reqJson, "communityId", "请求报文中未包含communityId");
          // 验证发票名称参数是否存在
          Assert.hasKeyAndValue(reqJson, "invoiceName", "请求报文中未包含invoiceName");
          // 验证发票地址参数是否存在
          Assert.hasKeyAndValue(reqJson, "invoiceAddress", "请求报文中未包含invoiceAddress");
      }
  
      /**
       * 执行保存业主发票信息的核心方法
       * 将请求数据转换为持久化对象并保存到数据库
       *
       * @param event Cmd事件对象,包含请求相关信息
       * @param cmdDataFlowContext 命令数据流上下文,用于获取和设置请求响应数据
       * @param reqJson 请求参数的JSON对象
       * @throws CmdException 当保存数据失败时抛出异常
       */
      @Override
      @Java110Transactional
      public void doCmd(CmdEvent event, ICmdDataFlowContext cmdDataFlowContext, JSONObject reqJson) throws CmdException {
          // 将JSON请求参数转换为OwnerInvoicePo持久化对象
          OwnerInvoicePo ownerInvoicePo = BeanConvertUtil.covertBean(reqJson, OwnerInvoicePo.class);
          
          // 生成发票记录的唯一ID
          ownerInvoicePo.setOiId(GenerateCodeFactory.getGeneratorId(CODE_PREFIX_ID));
          
          // 调用服务层保存业主发票信息
          int flag = ownerInvoiceV1InnerServiceSMOImpl.saveOwnerInvoice(ownerInvoicePo);
  
          // 检查保存结果,如果影响行数小于1则认为保存失败
          if (flag < 1) {
              throw new CmdException("保存数据失败");
          }
  
          // 设置成功响应结果
          cmdDataFlowContext.setResponseEntity(ResultVo.success());
      }
  }