diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/AppVersionsController.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/AppVersionsController.java new file mode 100644 index 0000000..dc27524 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/AppVersionsController.java @@ -0,0 +1,104 @@ +package com.yolo.keyboard.controller.admin.appversions; + +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 com.yolo.keyboard.framework.common.pojo.PageParam; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.pojo.CommonResult; +import com.yolo.keyboard.framework.common.util.object.BeanUtils; +import static com.yolo.keyboard.framework.common.pojo.CommonResult.success; + +import com.yolo.keyboard.framework.excel.core.util.ExcelUtils; + +import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog; +import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*; + +import com.yolo.keyboard.controller.admin.appversions.vo.*; +import com.yolo.keyboard.dal.dataobject.appversions.AppVersionsDO; +import com.yolo.keyboard.service.appversions.AppVersionsService; + +@Tag(name = "管理后台 - App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") +@RestController +@RequestMapping("/keyboard/app-versions") +@Validated +public class AppVersionsController { + + @Resource + private AppVersionsService appVersionsService; + + @PostMapping("/create") + @Operation(summary = "创建App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:create')") + public CommonResult createAppVersions(@RequestBody AppVersionsSaveReqVO createReqVO) { + return success(appVersionsService.createAppVersions(createReqVO)); + } + + @PutMapping("/update") + @Operation(summary = "更新App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:update')") + public CommonResult updateAppVersions(@RequestBody AppVersionsSaveReqVO updateReqVO) { + appVersionsService.updateAppVersions(updateReqVO); + return success(true); + } + + @DeleteMapping("/delete") + @Operation(summary = "删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") + @Parameter(name = "id", description = "编号", required = true) + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:delete')") + public CommonResult deleteAppVersions(@RequestParam("id") Long id) { + appVersionsService.deleteAppVersions(id); + return success(true); + } + + @DeleteMapping("/delete-list") + @Parameter(name = "ids", description = "编号", required = true) + @Operation(summary = "批量删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:delete')") + public CommonResult deleteAppVersionsList(@RequestParam("ids") List ids) { + appVersionsService.deleteAppVersionsListByIds(ids); + return success(true); + } + + @GetMapping("/get") + @Operation(summary = "获得App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。") + @Parameter(name = "id", description = "编号", required = true, example = "1024") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:query')") + public CommonResult getAppVersions(@RequestParam("id") Long id) { + AppVersionsDO appVersions = appVersionsService.getAppVersions(id); + return success(BeanUtils.toBean(appVersions, AppVersionsRespVO.class)); + } + + @GetMapping("/page") + @Operation(summary = "获得App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。分页") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:query')") + public CommonResult> getAppVersionsPage(@Valid AppVersionsPageReqVO pageReqVO) { + PageResult pageResult = appVersionsService.getAppVersionsPage(pageReqVO); + return success(BeanUtils.toBean(pageResult, AppVersionsRespVO.class)); + } + + @GetMapping("/export-excel") + @Operation(summary = "导出App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Excel") + @PreAuthorize("@ss.hasPermission('keyboard:app-versions:export')") + @ApiAccessLog(operateType = EXPORT) + public void exportAppVersionsExcel(@Valid AppVersionsPageReqVO pageReqVO, + HttpServletResponse response) throws IOException { + pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE); + List list = appVersionsService.getAppVersionsPage(pageReqVO).getList(); + // 导出 Excel + ExcelUtils.write(response, "App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。.xls", "数据", AppVersionsRespVO.class, + BeanUtils.toBean(list, AppVersionsRespVO.class)); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsPageReqVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsPageReqVO.java new file mode 100644 index 0000000..2ca4384 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsPageReqVO.java @@ -0,0 +1,65 @@ +package com.yolo.keyboard.controller.admin.appversions.vo; + +import lombok.*; +import java.util.*; +import io.swagger.v3.oas.annotations.media.Schema; +import com.yolo.keyboard.framework.common.pojo.PageParam; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; + +import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND; + +@Schema(description = "管理后台 - App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。分页 Request VO") +@Data +public class AppVersionsPageReqVO extends PageParam { + + @Schema(description = "应用标识（支持多App/多包名场景）；单App可固定为 main。", example = "10064") + private String appId; + + @Schema(description = "平台：android 或 ios（用 CHECK 约束限制取值）。") + private String platform; + + @Schema(description = "渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。") + private String channel; + + @Schema(description = "展示用版本号（语义版本字符串），如 1.2.3。", example = "芋艿") + private String versionName; + + @Schema(description = "比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。") + private Long versionCode; + + @Schema(description = "iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。") + private String buildNumber; + + @Schema(description = "最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。") + private Long minSupportedCode; + + @Schema(description = "是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。") + @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) + private Boolean[] isForceUpdate; + + @Schema(description = "是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。") + private Boolean isActive; + + @Schema(description = "更新说明（展示给用户的版本更新内容）。") + private String releaseNotes; + + @Schema(description = "下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。", example = "https://www.iocoder.cn") + private String downloadUrl; + + @Schema(description = "应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。", example = "https://www.iocoder.cn") + private String storeUrl; + + @Schema(description = "扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。") + private Object metadata; + + @Schema(description = "发布时间（对外宣布/上线时间），用于展示与排序。") + private LocalDateTime releasedAt; + + @Schema(description = "记录创建时间。") + private LocalDateTime createdAt; + + @Schema(description = "记录更新时间（建议配合触发器自动维护）。") + private LocalDateTime updatedAt; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsRespVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsRespVO.java new file mode 100644 index 0000000..75af227 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsRespVO.java @@ -0,0 +1,83 @@ +package com.yolo.keyboard.controller.admin.appversions.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 cn.idev.excel.annotation.*; + +@Schema(description = "管理后台 - App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Response VO") +@Data +@ExcelIgnoreUnannotated +public class AppVersionsRespVO { + + @Schema(description = "主键，自增版本记录ID。", requiredMode = Schema.RequiredMode.REQUIRED, example = "25012") + @ExcelProperty("主键，自增版本记录ID。") + private Long id; + + @Schema(description = "应用标识（支持多App/多包名场景）；单App可固定为 main。", requiredMode = Schema.RequiredMode.REQUIRED, example = "10064") + @ExcelProperty("应用标识（支持多App/多包名场景）；单App可固定为 main。") + private String appId; + + @Schema(description = "平台：android 或 ios（用 CHECK 约束限制取值）。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("平台：android 或 ios（用 CHECK 约束限制取值）。") + private String platform; + + @Schema(description = "渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。") + private String channel; + + @Schema(description = "展示用版本号（语义版本字符串），如 1.2.3。", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿") + @ExcelProperty("展示用版本号（语义版本字符串），如 1.2.3。") + private String versionName; + + @Schema(description = "比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。") + private Long versionCode; + + @Schema(description = "iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。") + @ExcelProperty("iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。") + private String buildNumber; + + @Schema(description = "最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。") + private Long minSupportedCode; + + @Schema(description = "是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。") + private Boolean isForceUpdate; + + @Schema(description = "是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。") + private Boolean isActive; + + @Schema(description = "更新说明（展示给用户的版本更新内容）。") + @ExcelProperty("更新说明（展示给用户的版本更新内容）。") + private String releaseNotes; + + @Schema(description = "下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。", example = "https://www.iocoder.cn") + @ExcelProperty("下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。") + private String downloadUrl; + + @Schema(description = "应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。", example = "https://www.iocoder.cn") + @ExcelProperty("应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。") + private String storeUrl; + + @Schema(description = "扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。") + private Object metadata; + + @Schema(description = "发布时间（对外宣布/上线时间），用于展示与排序。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("发布时间（对外宣布/上线时间），用于展示与排序。") + private LocalDateTime releasedAt; + + @Schema(description = "记录创建时间。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("记录创建时间。") + private LocalDateTime createdAt; + + @Schema(description = "记录更新时间（建议配合触发器自动维护）。", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("记录更新时间（建议配合触发器自动维护）。") + private LocalDateTime updatedAt; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsSaveReqVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsSaveReqVO.java new file mode 100644 index 0000000..2dff9ad --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/appversions/vo/AppVersionsSaveReqVO.java @@ -0,0 +1,74 @@ +package com.yolo.keyboard.controller.admin.appversions.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 = "管理后台 - App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。新增/修改 Request VO") +@Data +public class AppVersionsSaveReqVO { + + @Schema(description = "主键，自增版本记录ID。", requiredMode = Schema.RequiredMode.REQUIRED, example = "25012") + private Long id; + + @Schema(description = "应用标识（支持多App/多包名场景）；单App可固定为 main。", requiredMode = Schema.RequiredMode.REQUIRED, example = "10064") + @NotEmpty(message = "应用标识（支持多App/多包名场景）；单App可固定为 main。不能为空") + private String appId; + + @Schema(description = "平台：android 或 ios（用 CHECK 约束限制取值）。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotEmpty(message = "平台：android 或 ios（用 CHECK 约束限制取值）。不能为空") + private String platform; + + @Schema(description = "渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotEmpty(message = "渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。不能为空") + private String channel; + + @Schema(description = "展示用版本号（语义版本字符串），如 1.2.3。", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿") + @NotEmpty(message = "展示用版本号（语义版本字符串），如 1.2.3。不能为空") + private String versionName; + + @Schema(description = "比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。不能为空") + private Long versionCode; + + @Schema(description = "iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。") + private String buildNumber; + + @Schema(description = "最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。不能为空") + private Long minSupportedCode; + + @Schema(description = "是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。不能为空") + private Boolean isForceUpdate; + + @Schema(description = "是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。不能为空") + private Boolean isActive; + + @Schema(description = "更新说明（展示给用户的版本更新内容）。") + private String releaseNotes; + + @Schema(description = "下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。", example = "https://www.iocoder.cn") + private String downloadUrl; + + @Schema(description = "应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。", example = "https://www.iocoder.cn") + private String storeUrl; + + @Schema(description = "扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。", requiredMode = Schema.RequiredMode.REQUIRED) + private Object metadata; + + @Schema(description = "发布时间（对外宣布/上线时间），用于展示与排序。", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "发布时间（对外宣布/上线时间），用于展示与排序。不能为空") + private LocalDateTime releasedAt; + + @Schema(description = "记录创建时间。", requiredMode = Schema.RequiredMode.REQUIRED) + private LocalDateTime createdAt; + + @Schema(description = "记录更新时间（建议配合触发器自动维护）。", requiredMode = Schema.RequiredMode.REQUIRED) + private LocalDateTime updatedAt; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/appversions/AppVersionsDO.java b/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/appversions/AppVersionsDO.java new file mode 100644 index 0000000..2a6eac4 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/appversions/AppVersionsDO.java @@ -0,0 +1,97 @@ +package com.yolo.keyboard.dal.dataobject.appversions; + +import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;import lombok.*; +import java.util.*; +import java.time.LocalDateTime; +import java.time.LocalDateTime; +import java.time.LocalDateTime; +import com.baomidou.mybatisplus.annotation.*; +import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO; + +/** + * App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 DO + * + * @author ziin + */ +@TableName("keyboard_app_versions") +@KeySequence("keyboard_app_versions_id_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。 +@Data +@ToString(callSuper = true) +@Builder +@NoArgsConstructor +@AllArgsConstructor +@TenantIgnore +public class AppVersionsDO { + + /** + * 主键，自增版本记录ID。 + */ + @TableId + private Long id; + /** + * 应用标识（支持多App/多包名场景）；单App可固定为 main。 + */ + private String appId; + /** + * 平台：android 或 ios（用 CHECK 约束限制取值）。 + */ + private String platform; + /** + * 渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。 + */ + private String channel; + /** + * 展示用版本号（语义版本字符串），如 1.2.3。 + */ + private String versionName; + /** + * 比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。 + */ + private Long versionCode; + /** + * iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。 + */ + private String buildNumber; + /** + * 最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。 + */ + private Long minSupportedCode; + /** + * 是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。 + */ + private Boolean isForceUpdate; + /** + * 是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。 + */ + private Boolean isActive; + /** + * 更新说明（展示给用户的版本更新内容）。 + */ + private String releaseNotes; + /** + * 下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。 + */ + private String downloadUrl; + /** + * 应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。 + */ + private String storeUrl; + /** + * 扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。 + */ + private Object metadata; + /** + * 发布时间（对外宣布/上线时间），用于展示与排序。 + */ + private LocalDateTime releasedAt; + /** + * 记录创建时间。 + */ + private LocalDateTime createdAt; + /** + * 记录更新时间（建议配合触发器自动维护）。 + */ + private LocalDateTime updatedAt; + + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/appversions/AppVersionsMapper.java b/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/appversions/AppVersionsMapper.java new file mode 100644 index 0000000..41295ba --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/appversions/AppVersionsMapper.java @@ -0,0 +1,41 @@ +package com.yolo.keyboard.dal.mysql.appversions; + +import java.util.*; + +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX; +import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX; +import com.yolo.keyboard.dal.dataobject.appversions.AppVersionsDO; +import org.apache.ibatis.annotations.Mapper; +import com.yolo.keyboard.controller.admin.appversions.vo.*; + +/** + * App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Mapper + * + * @author ziin + */ +@Mapper +public interface AppVersionsMapper extends BaseMapperX { + + default PageResult selectPage(AppVersionsPageReqVO reqVO) { + return selectPage(reqVO, new LambdaQueryWrapperX() + .eqIfPresent(AppVersionsDO::getAppId, reqVO.getAppId()) + .eqIfPresent(AppVersionsDO::getPlatform, reqVO.getPlatform()) + .eqIfPresent(AppVersionsDO::getChannel, reqVO.getChannel()) + .likeIfPresent(AppVersionsDO::getVersionName, reqVO.getVersionName()) + .eqIfPresent(AppVersionsDO::getVersionCode, reqVO.getVersionCode()) + .eqIfPresent(AppVersionsDO::getBuildNumber, reqVO.getBuildNumber()) + .eqIfPresent(AppVersionsDO::getMinSupportedCode, reqVO.getMinSupportedCode()) + .betweenIfPresent(AppVersionsDO::getIsForceUpdate, reqVO.getIsForceUpdate()) + .eqIfPresent(AppVersionsDO::getIsActive, reqVO.getIsActive()) + .eqIfPresent(AppVersionsDO::getReleaseNotes, reqVO.getReleaseNotes()) + .eqIfPresent(AppVersionsDO::getDownloadUrl, reqVO.getDownloadUrl()) + .eqIfPresent(AppVersionsDO::getStoreUrl, reqVO.getStoreUrl()) + .eqIfPresent(AppVersionsDO::getMetadata, reqVO.getMetadata()) + .eqIfPresent(AppVersionsDO::getReleasedAt, reqVO.getReleasedAt()) + .eqIfPresent(AppVersionsDO::getCreatedAt, reqVO.getCreatedAt()) + .eqIfPresent(AppVersionsDO::getUpdatedAt, reqVO.getUpdatedAt()) + .orderByDesc(AppVersionsDO::getId)); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsService.java b/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsService.java new file mode 100644 index 0000000..fef3a0a --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsService.java @@ -0,0 +1,62 @@ +package com.yolo.keyboard.service.appversions; + +import java.util.*; +import jakarta.validation.*; +import com.yolo.keyboard.controller.admin.appversions.vo.*; +import com.yolo.keyboard.dal.dataobject.appversions.AppVersionsDO; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.pojo.PageParam; + +/** + * App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Service 接口 + * + * @author ziin + */ +public interface AppVersionsService { + + /** + * 创建App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + * + * @param createReqVO 创建信息 + * @return 编号 + */ + Long createAppVersions(@Valid AppVersionsSaveReqVO createReqVO); + + /** + * 更新App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + * + * @param updateReqVO 更新信息 + */ + void updateAppVersions(@Valid AppVersionsSaveReqVO updateReqVO); + + /** + * 删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + * + * @param id 编号 + */ + void deleteAppVersions(Long id); + + /** + * 批量删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + * + * @param ids 编号 + */ + void deleteAppVersionsListByIds(List ids); + + /** + * 获得App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + * + * @param id 编号 + * @return App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 + */ + AppVersionsDO getAppVersions(Long id); + + /** + * 获得App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。分页 + * + * @param pageReqVO 分页查询 + * @return App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。分页 + */ + PageResult getAppVersionsPage(AppVersionsPageReqVO pageReqVO); + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsServiceImpl.java b/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsServiceImpl.java new file mode 100644 index 0000000..00194e5 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/service/appversions/AppVersionsServiceImpl.java @@ -0,0 +1,84 @@ +package com.yolo.keyboard.service.appversions; + +import cn.hutool.core.collection.CollUtil; +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 com.yolo.keyboard.controller.admin.appversions.vo.*; +import com.yolo.keyboard.dal.dataobject.appversions.AppVersionsDO; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.pojo.PageParam; +import com.yolo.keyboard.framework.common.util.object.BeanUtils; + +import com.yolo.keyboard.dal.mysql.appversions.AppVersionsMapper; + +import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception; +import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList; +import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.APP_VERSIONS_NOT_EXISTS; + +/** + * App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Service 实现类 + * + * @author ziin + */ +@Service +@Validated +public class AppVersionsServiceImpl implements AppVersionsService { + + @Resource + private AppVersionsMapper appVersionsMapper; + + @Override + public Long createAppVersions(AppVersionsSaveReqVO createReqVO) { + // 插入 + AppVersionsDO appVersions = BeanUtils.toBean(createReqVO, AppVersionsDO.class); + appVersionsMapper.insert(appVersions); + + // 返回 + return appVersions.getId(); + } + + @Override + public void updateAppVersions(AppVersionsSaveReqVO updateReqVO) { + // 校验存在 + validateAppVersionsExists(updateReqVO.getId()); + // 更新 + AppVersionsDO updateObj = BeanUtils.toBean(updateReqVO, AppVersionsDO.class); + appVersionsMapper.updateById(updateObj); + } + + @Override + public void deleteAppVersions(Long id) { + // 校验存在 + validateAppVersionsExists(id); + // 删除 + appVersionsMapper.deleteById(id); + } + + @Override + public void deleteAppVersionsListByIds(List ids) { + // 删除 + appVersionsMapper.deleteByIds(ids); + } + + + private void validateAppVersionsExists(Long id) { + if (appVersionsMapper.selectById(id) == null) { + throw exception(APP_VERSIONS_NOT_EXISTS); + } + } + + @Override + public AppVersionsDO getAppVersions(Long id) { + return appVersionsMapper.selectById(id); + } + + @Override + public PageResult getAppVersionsPage(AppVersionsPageReqVO pageReqVO) { + return appVersionsMapper.selectPage(pageReqVO); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/resources/mapper/appversions/AppVersionsMapper.xml b/keyboard-server/src/main/resources/mapper/appversions/AppVersionsMapper.xml new file mode 100644 index 0000000..47ab1e9 --- /dev/null +++ b/keyboard-server/src/main/resources/mapper/appversions/AppVersionsMapper.xml @@ -0,0 +1,12 @@ + + + + + + + \ No newline at end of file diff --git a/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java b/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java index 0a19266..43d9b4a 100644 --- a/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java +++ b/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java @@ -96,4 +96,5 @@ public interface ErrorCodeConstants { ErrorCode TENANT_COMMISSION_NOT_EXISTS = new ErrorCode(1_001_202_022, "租户内购分成记录不存在"); ErrorCode AI_COMPANION_NOT_EXISTS = new ErrorCode(1_001_202_023, "AI陪聊角色表，用于定义恋爱/陪伴型虚拟角色的基础信息与人设不存在"); ErrorCode WARNING_MESSAGE_NOT_EXISTS = new ErrorCode(1_001_202_024, "用户注销提示信息不存在"); + ErrorCode APP_VERSIONS_NOT_EXISTS = new ErrorCode(1_001_202_025, "App 版本发布与更新检查表信息不存在"); }