From 5ccbc93d995ba688fc07f63eb3a8832b45adcbc6 Mon Sep 17 00:00:00 2001 From: caiyuchao Date: Tue, 1 Jul 2025 14:58:38 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20license=E7=AE=A1=E7=90=86=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E6=B7=BB=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../license/enums/ErrorCodeConstants.java | 1 + .../admin/license/LicenseController.java | 95 +++++++++++++++++++ .../admin/license/vo/LicensePageReqVO.java | 62 ++++++++++++ .../admin/license/vo/LicenseRespVO.java | 75 +++++++++++++++ .../admin/license/vo/LicenseSaveReqVO.java | 59 ++++++++++++ .../dal/dataobject/license/LicenseDO.java | 88 +++++++++++++++++ .../dal/mysql/license/LicenseMapper.java | 39 ++++++++ .../service/license/LicenseService.java | 55 +++++++++++ .../service/license/LicenseServiceImpl.java | 74 +++++++++++++++ .../mapper/license/LicenseMapper.xml | 12 +++ 10 files changed, 560 insertions(+) create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/LicenseController.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicensePageReqVO.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseRespVO.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseSaveReqVO.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/dataobject/license/LicenseDO.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/mysql/license/LicenseMapper.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseService.java create mode 100644 agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseServiceImpl.java create mode 100644 agt-module-license/agt-module-license-server/src/main/resources/mapper/license/LicenseMapper.xml diff --git a/agt-module-license/agt-module-license-api/src/main/java/org/agt/module/license/enums/ErrorCodeConstants.java b/agt-module-license/agt-module-license-api/src/main/java/org/agt/module/license/enums/ErrorCodeConstants.java index 60cfede..dca37de 100644 --- a/agt-module-license/agt-module-license-api/src/main/java/org/agt/module/license/enums/ErrorCodeConstants.java +++ b/agt-module-license/agt-module-license-api/src/main/java/org/agt/module/license/enums/ErrorCodeConstants.java @@ -14,4 +14,5 @@ public interface ErrorCodeConstants { ErrorCode PROJECT_NOT_EXISTS = new ErrorCode(1_100_002_001, "项目不存在"); ErrorCode PROJECT_NAME_DUPLICATE = new ErrorCode(1_100_001_002, "项目名称`{}`已存在"); ErrorCode PROJECT_CODE_DUPLICATE = new ErrorCode(1_100_001_003, "项目编号`{}`已存在"); + ErrorCode LICENSE_NOT_EXISTS = new ErrorCode(1_100_002_001, "License不存在"); } diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/LicenseController.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/LicenseController.java new file mode 100644 index 0000000..c470436 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/LicenseController.java @@ -0,0 +1,95 @@ +package org.agt.module.license.controller.admin.license; + +import org.springframework.web.bind.annotation.*; +import jakarta.annotation.Resource; +import org.springframework.validation.annotation.Validated; +import org.springframework.security.access.prepost.PreAuthorize; +import io.swagger.v3.oas.annotations.tags.Tag; +import io.swagger.v3.oas.annotations.Parameter; +import io.swagger.v3.oas.annotations.Operation; + +import jakarta.validation.constraints.*; +import jakarta.validation.*; +import jakarta.servlet.http.*; +import java.util.*; +import java.io.IOException; + +import org.agt.framework.common.pojo.PageParam; +import org.agt.framework.common.pojo.PageResult; +import org.agt.framework.common.pojo.CommonResult; +import org.agt.framework.common.util.object.BeanUtils; +import static org.agt.framework.common.pojo.CommonResult.success; + +import org.agt.framework.excel.core.util.ExcelUtils; + +import org.agt.framework.apilog.core.annotation.ApiAccessLog; +import static org.agt.framework.apilog.core.enums.OperateTypeEnum.*; + +import org.agt.module.license.controller.admin.license.vo.*; +import org.agt.module.license.dal.dataobject.license.LicenseDO; +import org.agt.module.license.service.license.LicenseService; + +@Tag(name = "管理后台 - License") +@RestController +@RequestMapping("/license/license") +@Validated +public class LicenseController { + + @Resource + private LicenseService licenseService; + + @PostMapping("/create") + @Operation(summary = "创建License") + @PreAuthorize("@ss.hasPermission('license:license:create')") + public CommonResult createLicense(@Valid @RequestBody LicenseSaveReqVO createReqVO) { + return success(licenseService.createLicense(createReqVO)); + } + + @PutMapping("/update") + @Operation(summary = "更新License") + @PreAuthorize("@ss.hasPermission('license:license:update')") + public CommonResult updateLicense(@Valid @RequestBody LicenseSaveReqVO updateReqVO) { + licenseService.updateLicense(updateReqVO); + return success(true); + } + + @DeleteMapping("/delete") + @Operation(summary = "删除License") + @Parameter(name = "id", description = "编号", required = true) + @PreAuthorize("@ss.hasPermission('license:license:delete')") + public CommonResult deleteLicense(@RequestParam("id") Long id) { + licenseService.deleteLicense(id); + return success(true); + } + + @GetMapping("/get") + @Operation(summary = "获得License") + @Parameter(name = "id", description = "编号", required = true, example = "1024") + @PreAuthorize("@ss.hasPermission('license:license:query')") + public CommonResult getLicense(@RequestParam("id") Long id) { + LicenseDO license = licenseService.getLicense(id); + return success(BeanUtils.toBean(license, LicenseRespVO.class)); + } + + @GetMapping("/page") + @Operation(summary = "获得License分页") + @PreAuthorize("@ss.hasPermission('license:license:query')") + public CommonResult> getLicensePage(@Valid LicensePageReqVO pageReqVO) { + PageResult pageResult = licenseService.getLicensePage(pageReqVO); + return success(BeanUtils.toBean(pageResult, LicenseRespVO.class)); + } + + @GetMapping("/export-excel") + @Operation(summary = "导出License Excel") + @PreAuthorize("@ss.hasPermission('license:license:export')") + @ApiAccessLog(operateType = EXPORT) + public void exportLicenseExcel(@Valid LicensePageReqVO pageReqVO, + HttpServletResponse response) throws IOException { + pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE); + List list = licenseService.getLicensePage(pageReqVO).getList(); + // 导出 Excel + ExcelUtils.write(response, "License.xls", "数据", LicenseRespVO.class, + BeanUtils.toBean(list, LicenseRespVO.class)); + } + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicensePageReqVO.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicensePageReqVO.java new file mode 100644 index 0000000..181edcd --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicensePageReqVO.java @@ -0,0 +1,62 @@ +package org.agt.module.license.controller.admin.license.vo; + +import lombok.*; +import java.util.*; +import io.swagger.v3.oas.annotations.media.Schema; +import org.agt.framework.common.pojo.PageParam; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; + +import static org.agt.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND; + +@Schema(description = "管理后台 - License分页 Request VO") +@Data +@EqualsAndHashCode(callSuper = true) +@ToString(callSuper = true) +public class LicensePageReqVO extends PageParam { + + @Schema(description = "客户ID", example = "31667") + private Long customerId; + + @Schema(description = "项目ID", example = "2496") + private Long projectId; + + @Schema(description = "sn") + private String sn; + + @Schema(description = "到期时间") + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) + private LocalDateTime[] expirationTime; + + @Schema(description = "网元开关") + private String neSwitch; + + @Schema(description = "用户数") + private Integer userNum; + + @Schema(description = "基站数") + private Integer baseStationNum; + + @Schema(description = "激活码") + private String activationCode; + + @Schema(description = "License内容") + private String licenseContent; + + @Schema(description = "申请人") + private Long applicant; + + @Schema(description = "审批人") + private Long approver; + + @Schema(description = "状态", example = "1") + private Integer status; + + @Schema(description = "备注", example = "随便") + private String remark; + + @Schema(description = "创建时间") + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) + private LocalDateTime[] createTime; + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseRespVO.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseRespVO.java new file mode 100644 index 0000000..02f8be2 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseRespVO.java @@ -0,0 +1,75 @@ +package org.agt.module.license.controller.admin.license.vo; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.*; +import java.util.*; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; +import com.alibaba.excel.annotation.*; +import org.agt.framework.excel.core.annotations.DictFormat; +import org.agt.framework.excel.core.convert.DictConvert; + +@Schema(description = "管理后台 - License Response VO") +@Data +@ExcelIgnoreUnannotated +public class LicenseRespVO { + + @Schema(description = "客户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "31667") + @ExcelProperty("客户ID") + private Long customerId; + + @Schema(description = "项目ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "2496") + @ExcelProperty("项目ID") + private Long projectId; + + @Schema(description = "sn", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("sn") + private String sn; + + @Schema(description = "到期时间") + @ExcelProperty("到期时间") + private LocalDateTime expirationTime; + + @Schema(description = "网元开关") + @ExcelProperty(value = "网元开关", converter = DictConvert.class) + @DictFormat("lic_ne_switch") // TODO 代码优化：建议设置到对应的 DictTypeConstants 枚举类中 + private String neSwitch; + + @Schema(description = "用户数") + @ExcelProperty("用户数") + private Integer userNum; + + @Schema(description = "基站数") + @ExcelProperty("基站数") + private Integer baseStationNum; + + @Schema(description = "激活码") + @ExcelProperty("激活码") + private String activationCode; + + @Schema(description = "License内容") + @ExcelProperty("License内容") + private String licenseContent; + + @Schema(description = "申请人") + @ExcelProperty("申请人") + private Long applicant; + + @Schema(description = "审批人") + @ExcelProperty("审批人") + private Long approver; + + @Schema(description = "状态", example = "1") + @ExcelProperty(value = "状态", converter = DictConvert.class) + @DictFormat("lic_license_status") // TODO 代码优化：建议设置到对应的 DictTypeConstants 枚举类中 + private Integer status; + + @Schema(description = "备注", example = "随便") + @ExcelProperty("备注") + private String remark; + + @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("创建时间") + private LocalDateTime createTime; + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseSaveReqVO.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseSaveReqVO.java new file mode 100644 index 0000000..6c57553 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/controller/admin/license/vo/LicenseSaveReqVO.java @@ -0,0 +1,59 @@ +package org.agt.module.license.controller.admin.license.vo; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.*; +import java.util.*; +import jakarta.validation.constraints.*; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; + +@Schema(description = "管理后台 - License新增/修改 Request VO") +@Data +public class LicenseSaveReqVO { + + @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "24876") + private Long id; + + @Schema(description = "客户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "31667") + @NotNull(message = "客户ID不能为空") + private Long customerId; + + @Schema(description = "项目ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "2496") + @NotNull(message = "项目ID不能为空") + private Long projectId; + + @Schema(description = "sn", requiredMode = Schema.RequiredMode.REQUIRED) + @NotEmpty(message = "sn不能为空") + private String sn; + + @Schema(description = "到期时间") + private LocalDateTime expirationTime; + + @Schema(description = "网元开关") + private String neSwitch; + + @Schema(description = "用户数") + private Integer userNum; + + @Schema(description = "基站数") + private Integer baseStationNum; + + @Schema(description = "激活码") + private String activationCode; + + @Schema(description = "License内容") + private String licenseContent; + + @Schema(description = "申请人") + private Long applicant; + + @Schema(description = "审批人") + private Long approver; + + @Schema(description = "状态", example = "1") + private Integer status; + + @Schema(description = "备注", example = "随便") + private String remark; + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/dataobject/license/LicenseDO.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/dataobject/license/LicenseDO.java new file mode 100644 index 0000000..1ef0449 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/dataobject/license/LicenseDO.java @@ -0,0 +1,88 @@ +package org.agt.module.license.dal.dataobject.license; + +import lombok.*; +import java.util.*; +import java.time.LocalDateTime; +import java.time.LocalDateTime; +import java.time.LocalDateTime; +import com.baomidou.mybatisplus.annotation.*; +import org.agt.framework.mybatis.core.dataobject.BaseDO; + +/** + * License DO + * + * @author 管理员 + */ +@TableName("lic_license") +@KeySequence("lic_license_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。 +@Data +@EqualsAndHashCode(callSuper = true) +@ToString(callSuper = true) +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class LicenseDO extends BaseDO { + + /** + * 主键 + */ + @TableId + private Long id; + /** + * 客户ID + */ + private Long customerId; + /** + * 项目ID + */ + private Long projectId; + /** + * sn + */ + private String sn; + /** + * 到期时间 + */ + private LocalDateTime expirationTime; + /** + * 网元开关 + * + * 枚举 {@link TODO lic_ne_switch 对应的类} + */ + private String neSwitch; + /** + * 用户数 + */ + private Integer userNum; + /** + * 基站数 + */ + private Integer baseStationNum; + /** + * 激活码 + */ + private String activationCode; + /** + * License内容 + */ + private String licenseContent; + /** + * 申请人 + */ + private Long applicant; + /** + * 审批人 + */ + private Long approver; + /** + * 状态 + * + * 枚举 {@link TODO lic_license_status 对应的类} + */ + private Integer status; + /** + * 备注 + */ + private String remark; + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/mysql/license/LicenseMapper.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/mysql/license/LicenseMapper.java new file mode 100644 index 0000000..cc05313 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/dal/mysql/license/LicenseMapper.java @@ -0,0 +1,39 @@ +package org.agt.module.license.dal.mysql.license; + +import java.util.*; + +import org.agt.framework.common.pojo.PageResult; +import org.agt.framework.mybatis.core.query.LambdaQueryWrapperX; +import org.agt.framework.mybatis.core.mapper.BaseMapperX; +import org.agt.module.license.dal.dataobject.license.LicenseDO; +import org.apache.ibatis.annotations.Mapper; +import org.agt.module.license.controller.admin.license.vo.*; + +/** + * License Mapper + * + * @author 管理员 + */ +@Mapper +public interface LicenseMapper extends BaseMapperX { + + default PageResult selectPage(LicensePageReqVO reqVO) { + return selectPage(reqVO, new LambdaQueryWrapperX() + .eqIfPresent(LicenseDO::getCustomerId, reqVO.getCustomerId()) + .eqIfPresent(LicenseDO::getProjectId, reqVO.getProjectId()) + .likeIfPresent(LicenseDO::getSn, reqVO.getSn()) + .betweenIfPresent(LicenseDO::getExpirationTime, reqVO.getExpirationTime()) + .eqIfPresent(LicenseDO::getNeSwitch, reqVO.getNeSwitch()) + .eqIfPresent(LicenseDO::getUserNum, reqVO.getUserNum()) + .eqIfPresent(LicenseDO::getBaseStationNum, reqVO.getBaseStationNum()) + .eqIfPresent(LicenseDO::getActivationCode, reqVO.getActivationCode()) + .eqIfPresent(LicenseDO::getLicenseContent, reqVO.getLicenseContent()) + .eqIfPresent(LicenseDO::getApplicant, reqVO.getApplicant()) + .eqIfPresent(LicenseDO::getApprover, reqVO.getApprover()) + .eqIfPresent(LicenseDO::getStatus, reqVO.getStatus()) + .eqIfPresent(LicenseDO::getRemark, reqVO.getRemark()) + .betweenIfPresent(LicenseDO::getCreateTime, reqVO.getCreateTime()) + .orderByDesc(LicenseDO::getId)); + } + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseService.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseService.java new file mode 100644 index 0000000..c13dfbd --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseService.java @@ -0,0 +1,55 @@ +package org.agt.module.license.service.license; + +import java.util.*; +import jakarta.validation.*; +import org.agt.module.license.controller.admin.license.vo.*; +import org.agt.module.license.dal.dataobject.license.LicenseDO; +import org.agt.framework.common.pojo.PageResult; +import org.agt.framework.common.pojo.PageParam; + +/** + * License Service 接口 + * + * @author 管理员 + */ +public interface LicenseService { + + /** + * 创建License + * + * @param createReqVO 创建信息 + * @return 编号 + */ + Long createLicense(@Valid LicenseSaveReqVO createReqVO); + + /** + * 更新License + * + * @param updateReqVO 更新信息 + */ + void updateLicense(@Valid LicenseSaveReqVO updateReqVO); + + /** + * 删除License + * + * @param id 编号 + */ + void deleteLicense(Long id); + + /** + * 获得License + * + * @param id 编号 + * @return License + */ + LicenseDO getLicense(Long id); + + /** + * 获得License分页 + * + * @param pageReqVO 分页查询 + * @return License分页 + */ + PageResult getLicensePage(LicensePageReqVO pageReqVO); + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseServiceImpl.java b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseServiceImpl.java new file mode 100644 index 0000000..0b512a9 --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/java/org/agt/module/license/service/license/LicenseServiceImpl.java @@ -0,0 +1,74 @@ +package org.agt.module.license.service.license; + +import org.springframework.stereotype.Service; +import jakarta.annotation.Resource; +import org.springframework.validation.annotation.Validated; +import org.springframework.transaction.annotation.Transactional; + +import java.util.*; +import org.agt.module.license.controller.admin.license.vo.*; +import org.agt.module.license.dal.dataobject.license.LicenseDO; +import org.agt.framework.common.pojo.PageResult; +import org.agt.framework.common.pojo.PageParam; +import org.agt.framework.common.util.object.BeanUtils; + +import org.agt.module.license.dal.mysql.license.LicenseMapper; + +import static org.agt.framework.common.exception.util.ServiceExceptionUtil.exception; +import static org.agt.module.license.enums.ErrorCodeConstants.*; + +/** + * License Service 实现类 + * + * @author 管理员 + */ +@Service +@Validated +public class LicenseServiceImpl implements LicenseService { + + @Resource + private LicenseMapper licenseMapper; + + @Override + public Long createLicense(LicenseSaveReqVO createReqVO) { + // 插入 + LicenseDO license = BeanUtils.toBean(createReqVO, LicenseDO.class); + licenseMapper.insert(license); + // 返回 + return license.getId(); + } + + @Override + public void updateLicense(LicenseSaveReqVO updateReqVO) { + // 校验存在 + validateLicenseExists(updateReqVO.getId()); + // 更新 + LicenseDO updateObj = BeanUtils.toBean(updateReqVO, LicenseDO.class); + licenseMapper.updateById(updateObj); + } + + @Override + public void deleteLicense(Long id) { + // 校验存在 + validateLicenseExists(id); + // 删除 + licenseMapper.deleteById(id); + } + + private void validateLicenseExists(Long id) { + if (licenseMapper.selectById(id) == null) { + throw exception(LICENSE_NOT_EXISTS); + } + } + + @Override + public LicenseDO getLicense(Long id) { + return licenseMapper.selectById(id); + } + + @Override + public PageResult getLicensePage(LicensePageReqVO pageReqVO) { + return licenseMapper.selectPage(pageReqVO); + } + +} \ No newline at end of file diff --git a/agt-module-license/agt-module-license-server/src/main/resources/mapper/license/LicenseMapper.xml b/agt-module-license/agt-module-license-server/src/main/resources/mapper/license/LicenseMapper.xml new file mode 100644 index 0000000..f5b6cae --- /dev/null +++ b/agt-module-license/agt-module-license-server/src/main/resources/mapper/license/LicenseMapper.xml @@ -0,0 +1,12 @@ + + + + + + + \ No newline at end of file