谷粒商城笔记+踩坑（4）——商品服务-品牌管理，阿里云云存储+JSR303数字校验+统一异常处理

2024-02-24 03:50
文章标签 阿里 服务 异常 校验 品牌 笔记 统一 管理 jsr303 处理 存储 商品 商城 数字 谷粒

本文主要是介绍谷粒商城笔记+踩坑（4）——商品服务-品牌管理，阿里云云存储+JSR303数字校验+统一异常处理，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

 导航：

谷粒商城笔记+踩坑汇总篇_谷粒商城笔记踩坑6_vincewm的博客-CSDN博客

目录

7、商品服务-品牌管理

7.1、添加“品牌管理”到人人后台管理系统

7.1.1、在人人后台管理系统中新增“品牌管理”菜单

7.1.2、人人生成的前端vue文件复制到前端工程

7.1.3、修改权限

7.1.4、测试增删改查基础功能

7.2、新增时显示状态开关（仅前端）

7.3、文件上传功能，阿里云云存储

7.3.1、分布式系统上传文件

7.3.2、开通阿里云OSS对象存储服务，创建新的Bucket

7.3.3、子账户创建和授权，获取Endpoint、AccessKey ID、AccessKey Secret

7.3.4、测试普通上传方式（不建议）

7.3.5、建立第三方服务模块，实现服务端签名后直传

7.3.6、测试上传文件功能

7.3.7、实现服务端签名后直传文件，新建OssController 

7.3.8、配置网关路由

7.3.9、启动网关、测试获取oss签名请求

7.3.10、前端联调，实现文件上传功能

7.3.11、在阿里云配置跨域规则

7.3.12、启动测试 

7.4、效果优化-显示图片（仅前端）

7.5、前端表单校验

7.6、JSR303数字校验

7.6.1、基本校验实现，@Valid

7.6.2、统一封装错误状态码

7.6.3、商品模块统一封装异常处理类，品牌参数校验异常

7.6.4、分组校验，增改校验分开，@Validated

7.6.5、编写自定义校验，必须提交指定数值

7.6.6、使用自定义校验，showStatus只能是0或1

7.6.8、最终校验的实体类和controller代码

7.6.9、postman测试校验

7、商品服务-品牌管理

7.1、添加“品牌管理”到人人后台管理系统

7.1.1、在人人后台管理系统中新增“品牌管理”菜单

菜单管理->新增菜单

image-20210927135437474

7.1.2、人人生成的前端vue文件复制到前端工程

前端代码路径\product\main\resources\src\views\modules\product

image-20210927135553792

7.1.3、修改权限

没有新增删除按钮： 修改权限，Ctrl+Shift+F查找isAuth后，

在src/utils/index.js修改isAuth，注释并全部返回为true

image-20210927135728379

image-20210927135749448

7.1.4、测试增删改查基础功能

运行项目， 可以发现增删改查都是成功的. 

注意：现在没有添加表单校验，新增时表单有非法输入会失败，例如状态设为汉字。 

http://localhost:8001/#/product-brand

7.2、新增时显示状态开关（仅前端）

1、在列表中添加自定义列：中间加<template></template>标签。可以通过 Scoped slot 可以获取到 row, column, $index 和 store（table 内部的状态管理）的数据

2、修改开关状态，发送修改请求

3、数据库中showStatus是01，开关默认值是true/false。 所以在开关中设置:active-value="1" 、:inactive-value="0"属性，与数据库同步

代码+注释：

<!--brand.vue中显示状态那一列--><el-table-columnprop="showStatus"header-align="center"align="center"label="显示状态"><template slot-scope="scope"><el-switchv-model="scope.row.showStatus"active-color="#13ce66"inactive-color="#ff4949":active-value="1" :inactive-value="0"@change="updateBrandStatus(scope.row)" ></el-switch></template></el-table-column><!--brand-add-or-update.vue中显示状态那一列--><el-form-item label="显示状态" prop="showStatus"><el-switchv-model="dataForm.showStatus"active-color="#13ce66"inactive-color="#ff4949":active-value="1":inactive-value="0"></el-switch></el-form-item>

//brand.vue中新增方法，用来修改状态
updateBrandStatus(data) {let { brandId, showStatus } = data;this.$http({url: this.$http.adornUrl("/product/brand/update"),method: "post",data: this.$http.adornData({ brandId, showStatus }, false),}).then(({ data }) => {this.$message({message: "状态修改成功",type: "success",});});},

7.3、文件上传功能，阿里云云存储

7.3.1、分布式系统上传文件

单体应用上传：上传文件到服务器，想获取文件时再向服务器发请求获取文件。

分布式系统上传： 因为有多台服务器，为防止负载均衡导致获取文件时没找到对应的服务器，所以使用专门的存读文件服务器，或者云存储。

和传统的单体应用不同，这里我们选择将数据上传到分布式文件服务器上。

这里我们选择将图片放置到阿里云上，使用对象存储。

帮助文档：

  • https://github.com/alibaba/aliyun-spring-boot/blob/master/aliyun-spring-boot-samples/aliyun-oss-spring-boot-sample/README-zh.md
  • https://help.aliyun.com/document_detail/32009.html?spm=a2c4g.11186623.6.768.549d59aaWuZMGJ

上传策略：服务端签名后直传

image-20210927154406800

7.3.2、开通阿里云OSS对象存储服务，创建新的Bucket

尽管开通即可，oss是按量计费，开发阶段不会超过一块钱。 

注册、登录、实名认证、开通oss对象存储:

对象存储OSS_云存储服务_企业数据管理_存储-阿里云

点击立即开通 

点击“管理控制台” ：

oss基本概念：基本概念-Object-对象-存储-对象存储 OSS-阿里云

存储空间（Bucket）

存储空间是用户用于存储对象（Object）的容器，所有的对象都必须隶属于某个存储空间。存储空间具有各种配置属性，包括地域、访问权限、存储类型等。用户可以根据实际需求，创建不同类型的存储空间来存储不同的数据。

建议一个项目创建一个存储空间。 

对象（Object）

对象是OSS存储数据的基本单元，也被称为OSS的文件。和传统的文件系统不同，对象没有文件目录层级结构的关系。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成，并且由存储空间内部唯一的Key来标识。对象元信息是一组键值对，表示了对象的一些属性，比如最后修改时间、大小等信息，同时用户也可以在元信息中存储一些自定义的信息。

创建bucket： 

image-20210927154050990

手动上传任意文件测试：

点击文件详情、 复制url就能直接下载文件：

7.3.3、子账户创建和授权，获取Endpoint、AccessKey ID、AccessKey Secret

创建子账户

image-20210927154807136

点击创建用户

image-20210927154842396

新建成功后得到AccessKey ID、AccessKey Secret

对子账户分配权限，管理OSS对象存储服务

给oss完全权限： 

Endpoint。 （gulimall-xmh -> 概览 -> Endpoint（地域节点）)

image-20210927155403292

7.3.4、测试普通上传方式（不建议）

经过服务器不建议 

安装-gt-lt-Java-对象存储 OSS-阿里云

product模块导入依赖

<dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.15.0</version>
</dependency>

上传文件流，将下面代码中String都改成自己的信息：

    @Testpublic void testOss(){String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";// 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。String accessKeyId = "yourAccessKeyId";String accessKeySecret = "yourAccessKeySecret";// 填写Bucket存储空间名称，例如gulimall-hello。String bucketName = "examplebucket";// 填写存储对象Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。String objectName = "exampledir/exampleobject.txt";// 填写本地文件的完整路径，例如D:\\localpath\\examplefile.txt。// 如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件流。String filePath= "D:\\localpath\\examplefile.txt";// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);try {InputStream inputStream = new FileInputStream(filePath);// 创建PutObject请求。ossClient.putObject(bucketName, objectName, inputStream);} catch (OSSException oe) {System.out.println("Caught an OSSException, which means your request made it to OSS, "+ "but was rejected with an error response for some reason.");System.out.println("Error Message:" + oe.getErrorMessage());System.out.println("Error Code:" + oe.getErrorCode());System.out.println("Request ID:" + oe.getRequestId());System.out.println("Host ID:" + oe.getHostId());} catch (ClientException ce) {System.out.println("Caught an ClientException, which means the client encountered "+ "a serious internal problem while trying to communicate with OSS, "+ "such as not being able to access the network.");System.out.println("Error Message:" + ce.getMessage());} finally {if (ossClient != null) {ossClient.shutdown();}}}

运行，上传成功：

复制文件url在浏览器也是可以打开的。 

7.3.5、建立第三方服务模块，实现服务端签名后直传

删除前面测试时引入的依赖和测试类，以后导入starter依赖。 

官方演示示例 ：

aliyun-spring-boot/aliyun-spring-boot-samples/aliyun-oss-spring-boot-sample at master · alibaba/aliyun-spring-boot · GitHub

  • 新建springboot模块,gulimall-third-party

  • 第三方模块引入common、oss依赖和alibaba管理依赖
    <properties><java.version>11</java.version><spring-cloud.version>2021.0.4</spring-cloud.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>com.vince.gulimall</groupId><artifactId>gulimall-common</artifactId><version>0.0.1-SNAPSHOT</version></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alicloud-oss</artifactId><version>2.2.0.RELEASE</version></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>${spring-cloud.version}</version><type>pom</type><scope>import</scope></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-dependencies</artifactId><version>2021.0.1.0</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>

  • nacos新建命名空间third-party

  • 命名空间中新建配置文件oss.yml

 

spring:cloud:alicloud:oss:endpoint: xxxbucket: xxxaccess-key: xxxsecret-key: xxx
  • 项目新建bootstrap.yml
spring:application:name: gulimall-third-partycloud:nacos:config:server-addr: 127.0.0.1:8848file-extension: yamlnamespace: de0e12ff-8fc4-45a0-bdee-5b5618f4054fextension-configs:- data-id: oss.ymlgroup: DEFAULT_GROUPrefresh: true

坑点：报错没有配置endpoint：

在SpringBoot 2.4.x的版本之后，对于bootstrap.properties/bootstrap.yaml配置文件(我们合起来成为Bootstrap配置文件)的支持，需要导入如下的依赖

这里在common中导入：

        <dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId><version>3.1.4</version></dependency>

  • 项目新建application.yml
spring:cloud:nacos:discovery:server-addr: 127.0.0.1:8848application:name: gulimall-third-party
server:port: 30000
  • 主启动类注解@EnableDiscoveryClient开启nacos注册
@SpringBootApplication
@EnableDiscoveryClient
public class GulimallThirdPartyApplication {public static void main(String[] args) {SpringApplication.run(GulimallThirdPartyApplication.class, args);}
}

7.3.6、测试上传文件功能

在第三方模块的pom里排除mybatisplus依赖：

		<dependency><groupId>com.vince.gulimall</groupId><artifactId>gulimall-common</artifactId><version>0.0.1-SNAPSHOT</version><exclusions><exclusion><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId></exclusion></exclusions></dependency>

编写测试类：

注意修改bucket 

@SpringBootTest
class GulimallThirdPartyApplicationTest {@AutowiredOSSClient ossClient;@Testpublic void testUpload() throws FileNotFoundException {//上传文件流。InputStream inputStream = new FileInputStream("E:\\SystemDefault\\桌面\\1.jpg");ossClient.putObject("改成自己bucketName例如gulimall-xmh", "hahaha1.jpg", inputStream);// 关闭OSSClient。ossClient.shutdown();System.out.println("上传成功.");}}

7.3.7、实现服务端签名后直传文件，新建OssController 

在第三方模块controller.OssController 

代码来源：简单上传-上传-文件-OSS-对象存储 OSS-阿里云 

这里主要是从yml里注入oss需要的关键属性，删去了跨域相关的代码，因为跨域我们之前在网关模块的配置类里已经统一配置了跨域规则。

@RestController
public class OssController {@AutowiredOSS ossClient;  //注意不是OssClient//从nacos配置的yml里注入阿里云云存储的关键属性@Value("${spring.cloud.alicloud.oss.endpoint}")String endpoint;@Value("${spring.cloud.alicloud.oss.bucket}")String bucket;@Value("${spring.cloud.alicloud.access-key}")String accessId;@Value("${spring.cloud.alicloud.secret-key}")String accessKey;@RequestMapping("/oss/policy")public R policy(){String host = "https://" + bucket + "." + endpoint; // host的格式为 bucketname.endpoint// 用户上传文件时指定的前缀String dir = new SimpleDateFormat("yyyy-MM-dd").format(new Date());Map<String, String> respMap=null;try {long expireTime = 30;long expireEndTime = System.currentTimeMillis() + expireTime * 1000;Date expiration = new Date(expireEndTime);PolicyConditions policyConds = new PolicyConditions();policyConds.addConditionItem(PolicyConditions.COND_CONTENT_LENGTH_RANGE, 0, 1048576000);policyConds.addConditionItem(MatchMode.StartWith, PolicyConditions.COND_KEY, dir);String postPolicy = ossClient.generatePostPolicy(expiration, policyConds);byte[] binaryData = postPolicy.getBytes("utf-8");String encodedPolicy = BinaryUtil.toBase64String(binaryData);String postSignature = ossClient.calculatePostSignature(postPolicy);respMap= new LinkedHashMap<String, String>();respMap.put("accessid", accessId);respMap.put("policy", encodedPolicy);respMap.put("signature", postSignature);respMap.put("dir", dir);respMap.put("host", host);respMap.put("expire", String.valueOf(expireEndTime / 1000));} catch (Exception e) {// Assert.fail(e.getMessage());System.out.println(e.getMessage());} finally {ossClient.shutdown();}return R.ok().put("data",respMap);}}

文件真正访问地址：https://bucket名.endpoint名/文件名

例如：

启动访问获取签名：

7.3.8、配置网关路由

#        oss等第三方模块路由- id: third_party_routeuri: lb://gulimall-third-partypredicates:- Path=/api/thirdparty/**filters:
#            http://localhost:88/api/thirdparty/oss/policy--->http://localhost:30000/oss/policy- RewritePath=/api/thirdparty/(?<segment>.*),/$\{segment}

注意：位置要放到/api的上面

 

7.3.9、启动网关、测试获取oss签名请求

访问http://localhost:88/api/thirdparty/oss/policy测试

7.3.10、前端联调，实现文件上传功能

  • 将资料里的upload文件夹cv在/renren-fast-vue/src/components中
  • 修改multiUpload.vue和singeUplad.vue组件中el-upload中的action属性，替换成自己的Bucket域名

image-20210927155622860

  • 修改\src\views\modules\productbrand-add-or-update.vue，把单个文件上传组件应用到brand-add-or-update.vue
//在<script>标签中导入组件
import singleUpload from "@/components/upload/singleUpload"//在export default中声明要用到的组件components:{singleUpload},

      <!--用新的组件替换原来的输入框--><el-form-item label="品牌logo地址" prop="logo"><singleUpload v-model="dataForm.logo"></singleUpload></el-form-item>

7.3.11、在阿里云配置跨域规则

因为是直接从前端8001端口转到阿里云的bucket域名，所以会有跨域问题： 

image-20210927160130001

跨域都是目标地址需要配置规则，所以在阿里云网页配置规则。

进入oss：阿里云登录 - 欢迎登录阿里云，安全稳定的云计算服务平台 

点击概述，下拉基础设置，配置跨域访问：

创建新规则

image-20210927160222082

image-20210927160251145

7.3.12、启动测试 

启动人人后台管理模块、网关、product、第三方模块 

http://localhost:8001/#/product-brand

点击添加品牌-图片上传，进行测试。

image-20210927160510961

测试成功！

原图片名c02d81be9ae5405ea13e31e9f5b22375!400x400 (1) .jpeg

7.4、效果优化-显示图片（仅前端）

原效果：

新增品牌后，发现在品牌logo下面显示的是地址。应该显示图片。

image-20210927160838866

 目标效果：

需要组件：elementUI里的table-自定义模板（自定义显示某一列，用于获取url）和others-Image。

在品牌logo下添加图片标签

      <el-table-columnprop="logo"header-align="center"align="center"label="品牌logo"><template slot-scope="scope"><img :src="scope.row.logo" style="width: 100px; height: 80px"></template></el-table-column>

7.5、前端表单校验

  • 首字母只能为a-z或者A-Z的一个字母
  • 排序必须是大于等于0的一个整数

el-form中rules表示校验规则

<!--排序加上.number表示要接受一个数字        -->
<el-input v-model.number="dataForm.sort" placeholder="排序"></el-input>

//首字母校验规则firstLetter: [{validator: (rule, value, callback) => {if (value == '') {callback(new Error("首字母必须填写"));} else if (!/^[a-zA-Z]$/.test(value)) {callback(new Error("首字母必须在a-z或者A-Z之间"));} else {callback();}},trigger: "blur",},],//排序字段校验规则sort: [{validator: (rule, value, callback) => {if (value == '') {callback(new Error("排序字段必须填写"));} else if (!Number.isInteger(value) || value < 0) {callback(new Error("排序字段必须是一个大于等于0的整数"));} else {callback();}},trigger: "blur",},],

7.6、JSR303数字校验

JSR303： Java数据校验规范提案。

jsr，是Java Specification Requests的缩写，意思是Java规范提案，是指向JCP(Java Community Process)提出新增一个标准化技术规范的正式请求。

303号规定了数据校验的标准。 

7.6.1、基本校验实现，@Valid

  • springboot2.3.0以上需要手动引入依赖,引入到common模块中
        <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-validation --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId><version>2.3.2.RELEASE</version></dependency>
  • 给实体类添加校验注解，并自定义提示message

product模块 

@Data
@TableName("pms_brand")
public class BrandEntity implements Serializable {private static final long serialVersionUID = 1L;/*** 品牌id*/@TableId
//	@NotNull(message = "修改必须有id",groups = {UpdateGroup.class})	//分组校验
//	@Null(message = "新增id必须为null",groups = {AddGroup.class})private Long brandId;/*** 品牌名*/@NotBlank(message = "品牌名必须提交")    //不能是null和""和"  "private String name;/*** 品牌logo地址。非空并且是url*/@NotEmpty    //不能是null和""@URL(message = "logo必须是一个合法的url地址")private String logo;/*** 介绍*/private String descript;/*** 显示状态[0-不显示；1-显示]*/private Integer showStatus;/*** 检索首字母*/@NotEmpty@Pattern(regexp = "/^[a-zA-Z]$/", message = "检索首字母必须是一个字母")private String firstLetter;/*** 排序*/@NotNull@Min(value = 0, message = "排序必须大于等于0")private Integer sort;}

@NotEmpty和@NotBlank区别：

@NotEmpty非空，不能是null和""

@NotBlank 非空白，不能是null和""和"  "

  • 在需要校验的controller参数添加@Valid注解，并返回提示信息
    /*** 保存*/@RequestMapping("/save")public R save(@RequestBody @Valid BrandEntity brand){brandService.save(brand);return R.ok();}
  • 规范校验错误时返回结果，BindingResult 参数

了解即可，后面用异常类抛出异常，返回R.error()

    @RequestMapping("/save")//@RequiresPermissions("product:brand:save")public R save(@Valid @RequestBody BrandEntity brand, BindingResult result){if (result.hasErrors()){Map<String, String> map = new HashMap<>();//1、获取校验的结果result.getFieldErrors().forEach((item)->{//获取到错误提示String message = item.getDefaultMessage();//获取到错误属性的名字String field = item.getField();map.put(field, message);});return R.error().put("data", map);}else{brandService.save(brand);}return R.ok();}

启动product和网关，测试：

POST http://localhost:88/api/product/brand/save
Content-Type: application/json{"name": "aa", "logo": "avc"}

测试结果：

7.6.2、统一封装错误状态码

  • 正规开发过程中，错误状态码有着严格的定义规则

错误码和错误信息定义类：
1. 错误码定义规则为五位数字
2. 前两位表示业务场景，最后三位表示错误码。例如：100001。10:通用 001:系统未知异常
3. 维护错误码后需要维护错误描述，将他们定义为枚举形式


错误码列表（前两位业务场景）：
 10: 通用
     如10001：参数格式校验失败
 11: 商品
 12: 订单
 13: 购物车
 14: 物流

为了定义这些错误状态码，我们可以单独定义一个常量类，用来存储这些错误状态码。

在common模块的exception包中新建BizCodeEnum枚举用来存储状态码


//错误码和错误信息定义类：
//        1. 错误码定义规则为五位数字
//        2. 前两位表示业务场景，最后三位表示错误码。例如：100001。10:通用 001:系统未知异常
//        3. 维护错误码后需要维护错误描述，将他们定义为枚举形式
//
//
//        错误码列表（前两位业务场景）：
//         10: 通用
//             如10001：参数格式校验失败
//         11: 商品
//         12: 订单
//         13: 购物车
//         14: 物流
public enum BizCodeEnum {UNKNOW_EXEPTION(10000,"系统未知异常"),VALID_EXCEPTION( 10001,"参数格式校验失败");private int code;private String msg;BizCodeEnum(int code, String msg) {this.code = code;this.msg = msg;}public int getCode() {return code;}public String getMsg() {return msg;}
}

7.6.3、商品模块统一封装异常处理类，品牌参数校验异常

  • 在product模块exception包下新建类GulimallExceptionControllerAdvice，用来集中处理此模块所有异常

为什么不放进common模块？

因为品牌参数校验异常具有个性化，例如状态字段只能是1和0，所以只处理product模块异常，而不是放进common模块检测全局异常。

@RestControllerAdvice(basePackages = "com.xmh.gulimall.product.controller")
public class GulimallExceptionControllerAdvice {// 处理数据校验异常@ExceptionHandler(value = MethodArgumentNotValidException.class)public R handleVaildException(MethodArgumentNotValidException e){BindingResult bindingResult = e.getBindingResult();Map<String, String> errorMap = new HashMap<>();bindingResult.getFieldErrors().forEach((fieldError)->{errorMap.put(fieldError.getField(), fieldError.getDefaultMessage());});return R.error(BizCodeEnume.VALID_EXCEPTION.getCode(),BizCodeEnume.VALID_EXCEPTION.getMsg()).put("data", errorMap);}//处理全局异常@ExceptionHandler(value = Throwable.class)    //Exception和Error继承自Throwablepublic R handleException(Throwable throwable){return R.error(BizCodeEnume.UNKNOW_EXEPTION.getCode(), BizCodeEnume.UNKNOW_EXEPTION.getMsg());}}

BrandController改回来，以后都用捕获异常

    /*** 保存*/@RequestMapping("/save")public R save(@Valid @RequestBody BrandEntity brand, BindingResult result) {brandService.save(brand);return R.ok();}
  • 测试

7.6.4、分组校验，增改校验分开，@Validated

场景：新增时id必须为空，修改时id必须非空，这样实体类注解就凌乱了，这时就必须用到分组校验。

注意：

  • 实体类变量注解分组，代表此变量支持这些分组的校验。
  • controller参数对象注解分组，代表这个对象只校验有配置这个分组的成员变量。

  • 在common模块中valid包里新建空接口AddGroup,UpdateGroup用来分组

  • 实体类的id进行分组校验

    Brand实体类：

    @Data
@TableName("pms_brand")
public class BrandEntity implements Serializable {private static final long serialVersionUID = 1L;/*** 品牌id*/@NotNull(message = "修改必须指定品牌id",groups = {UpdateGroup.class})@Null(message = "新增不能指定id",groups = {AddGroup.class})@TableIdprivate Long brandId;/*** 品牌名*/@NotBlank(message = "品牌名必须提交",groups = {AddGroup.class,UpdateGroup.class})private String name;/*** 品牌logo地址*/@NotBlank(groups = {AddGroup.class})@URL(message = "logo必须是一个合法的url地址",groups={AddGroup.class,UpdateGroup.class})private String logo;/*** 介绍*/private String descript;/*** 显示状态[0-不显示；1-显示]。自定义校验*/
//	@Pattern()@NotNull(groups = {AddGroup.class, UpdateStatusGroup.class})@ListValue(vals={0,1},groups = {AddGroup.class, UpdateStatusGroup.class})private Integer showStatus;/*** 检索首字母*/@NotEmpty(groups={AddGroup.class})@Pattern(regexp="^[a-zA-Z]$",message = "检索首字母必须是一个字母",groups={AddGroup.class,UpdateGroup.class})private String firstLetter;/*** 排序*/@NotNull(groups={AddGroup.class})@Min(value = 0,message = "排序必须大于等于0",groups={AddGroup.class,UpdateGroup.class})private Integer sort;}

    在这种情况下，没有指定分组的校验注解，默认是不起作用的。想要起作用就必须要加groups。

注意：没有指定分组的校验，默认是不起作用的，所以要给所有属性都指定分组。

  • @Valid改为@Validated注解，值为group接口数组，标记当前校验是哪个组

    /*** 保存*/@RequestMapping("/save")public R save(@Validated({AddGroup.class}) @RequestBody BrandEntity brand) {  // BindingResult resultbrandService.save(brand);return R.ok();}/*** 修改*/@RequestMapping("/update")public R update(@RequestBody @Validated({UpdateGroup.class}) BrandEntity brand) {brandService.updateById(brand);return R.ok();}

  • 测试：

http://localhost:88/api/product/brand/save

post请求，{"name": "aaa", "logo": "m","brandId":32}

7.6.5、编写自定义校验，必须提交指定数值

此步骤其实是画蛇添足的，因为前端状态字段是状态栏，值只能是0和1 

步骤：

  • 编写一个自定义校验注解ListValue
  • 新建配置文件ValidationMessages.properties保存注解信息
  • 编写一个自定义校验器ListValueConstraintValidator
  • 关联自定义的校验器和自定义的校验注解（可以指定多个不同的校验器，适配不同类型的校验）

common模块引入依赖（已完成） ：

        <dependency><groupId>jakarta.validation</groupId><artifactId>jakarta.validation-api</artifactId><version>2.0.2</version></dependency>

自定义校验注解@ListValue：

这里可以ctrl+b参考其他@NotNull等注解编写。

common模块的valid包下：

@Documented
//约束。同一个注解可以指定多个不同的校验器，适配不同类型的校验。这里ListValueConstraintValidator.class是数值校验器
@Constraint(validatedBy = {ListValueConstraintValidator.class})
//可以标注在哪些位置。方法、字段等。
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
//注解的时机。这里是可以在运行时获取校验
@Retention(RetentionPolicy.RUNTIME)
public @interface ListValue {
//    校验出错后，错误信息去哪取。前缀一般是当前全类名，在ValidationMessages.properties配置文件里设置com.atguigu.common.valid.ListValue.message=必须提交指定的值String message() default "{com.vince.common.valid.ListValue.message}";
//    支持分组校验的功能Class<?>[] groups() default {};
//    自定义负载信息Class<? extends Payload>[] payload() default {};
//    自定义注解里的属性int[] vals() default {};
}

配置校验注解提示信息： 

common模块创建配置文件ValidationMessages.properties：

com.atguigu.common.valid.ListValue.message=必须提交指定的值

编写自定义校验器， 数值必须包含在vals范围内

校验器实现ConstraintValidator接口。common模块的valid包下： 

//第一个泛型是校验注解，第二个泛型是校验数据类型
public class ListValueConstraintValidator implements ConstraintValidator<ListValue,Integer> {private Set<Integer> set=new HashSet<>();
//    初始化方法,ListValue是自定义的注解.@Overridepublic void initialize(ListValue constraintAnnotation) {int[] value = constraintAnnotation.vals();for (int i : value) {set.add(i);}}/*** 判断是否校验成功* @param value 需要校验的值* @param context* @return*/@Overridepublic boolean isValid(Integer value, ConstraintValidatorContext context) {return  set.contains(value);}
}

 关联校验器和校验注解：

在校验注解的@Constraint的validateBy属性中加入校验器

@Constraint(validatedBy = {ListValueConstraintValidator.class})

7.6.6、使用自定义校验，showStatus只能是0或1

 common模块的valid包下：

public interface UpdateStatus {
}

实体类：

	@NotNull(groups = {AddGroup.class, UpdateStatusGroup.class})@ListValue(vals={0,1},groups = {AddGroup.class, UpdateStatusGroup.class})private Integer showStatus;

BrandController 

    /*** 修改状态* @param brand* @return*/@RequestMapping("/update/status")public R updateStatus(@RequestBody @Validated({UpdateGroup.class}) BrandEntity brand) {brandService.updateById(brand);return R.ok();}

修改前端路径：

7.6.8、最终校验的实体类和controller代码

实体类：

@Data
@TableName("pms_brand")
public class BrandEntity implements Serializable {private static final long serialVersionUID = 1L;/*** 品牌id*/@NotNull(message = "修改必须指定品牌id",groups = {UpdateGroup.class,UpdateStatusGroup.class})@Null(message = "新增不能指定id",groups = {AddGroup.class})@TableIdprivate Long brandId;/*** 品牌名*/@NotBlank(message = "品牌名必须提交",groups = {AddGroup.class,UpdateGroup.class})private String name;/*** 品牌logo地址*/@NotBlank(groups = {AddGroup.class,UpdateGroup.class})@URL(message = "logo必须是一个合法的url地址",groups={AddGroup.class,UpdateGroup.class})private String logo;/*** 介绍*/private String descript;/*** 显示状态[0-不显示；1-显示]*/@NotNull(groups = {AddGroup.class,UpdateGroup.class, UpdateStatusGroup.class})@ListValue(vals={0,1},groups = {AddGroup.class, UpdateStatusGroup.class})private Integer showStatus;/*** 检索首字母*/@NotEmpty(groups={AddGroup.class,UpdateGroup.class})@Pattern(regexp="^[a-zA-Z]$",message = "检索首字母必须是一个字母",groups={AddGroup.class,UpdateGroup.class})private String firstLetter;/*** 排序*/@NotNull(groups={AddGroup.class,UpdateGroup.class})@Min(value = 0,message = "排序必须大于等于0",groups={AddGroup.class,UpdateGroup.class})private Integer sort;}

controller：

    /*** 保存*/@RequestMapping("/save")//校验有注解AddGroup的字段，基本每个字段都有，主要是必须id为nullpublic R save(@Validated({AddGroup.class}) @RequestBody BrandEntity brand) {  // BindingResult resultbrandService.save(brand);return R.ok();}/*** 修改*/@RequestMapping("/update")//校验有注解UpdateGroup的字段，基本每个字段都有，主要是必须id不为nullpublic R update(@RequestBody @Validated({UpdateGroup.class}) BrandEntity brand) {brandService.updateById(brand);return R.ok();}/*** 仅修改状态* @param brand* @return*/@RequestMapping("/update/status")//校验传来对象的status属性，只能是0或者1。public R updateStatus(@RequestBody @Validated({UpdateStatusGroup.class}) BrandEntity brand) {   //只校验状态brandService.updateById(brand);return R.ok();}

7.6.9、postman测试校验

增： 

http://localhost:88/api/product/brand/save

post 

{"name": "aaa", "logo": "m","brandId":32}

改：

http://localhost:88/api/product/brand/update

post

{"name": "aaa", "logo": "m"} 

只改状态 ：

http://localhost:88/api/product/brand/update/status

 post

{"brandId":1,"showStatus":2}

这篇关于谷粒商城笔记+踩坑（4）——商品服务-品牌管理，阿里云云存储+JSR303数字校验+统一异常处理的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/740873。

相关文章

无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

墙体画线地图切分方案 针对问题：墙体两侧特征混淆误匹配，导致建图和定位偏差，表现为过门跳变、外月台走歪等 ·解决思路：预期的根治方案IGICP需要较长时间完成上线，先使用切分地图的工程化方案，即墙体两侧切分为不同地图，在某一侧只使用该侧地图进行定位 方案思路 切分原理：切分地图基于关键帧位置，而非点云。 理论基础：光照是直线的，一帧点云必定只能照射到墙的一侧，无法同时照到两侧实践考虑：关
阅读更多...
异构存储（冷热数据分离）

异构存储（冷热数据分离）

异构存储主要解决不同的数据，存储在不同类型的硬盘中，达到最佳性能的问题。 异构存储Shell操作 （1）查看当前有哪些存储策略可以用 [lytfly@hadoop102 hadoop-3.1.4]$ hdfs storagepolicies -listPolicies （2）为指定路径（数据存储目录）设置指定的存储策略 hdfs storagepolicies -setStoragePo
阅读更多...
HDFS—存储优化（纠删码）

HDFS—存储优化（纠删码）

纠删码原理 HDFS 默认情况下，一个文件有3个副本，这样提高了数据的可靠性，但也带来了2倍的冗余开销。 Hadoop3.x 引入了纠删码，采用计算的方式，可以节省约50％左右的存储空间。 此种方式节约了空间，但是会增加 cpu 的计算。 纠删码策略是给具体一个路径设置。所有往此路径下存储的文件，都会执行此策略。 默认只开启对 RS-6-3-1024k
阅读更多...
从去中心化到智能化：Web3如何与AI共同塑造数字生态

从去中心化到智能化：Web3如何与AI共同塑造数字生态

在数字时代的演进中，Web3和人工智能（AI）正成为塑造未来互联网的两大核心力量。Web3的去中心化理念与AI的智能化技术，正相互交织，共同推动数字生态的变革。本文将探讨Web3与AI的融合如何改变数字世界，并展望这一新兴组合如何重塑我们的在线体验。 Web3的去中心化愿景 Web3代表了互联网的第三代发展，它基于去中心化的区块链技术，旨在创建一个开放、透明且用户主导的数字生态。不同于传统
阅读更多...
综合安防管理平台LntonAIServer视频监控汇聚抖动检测算法优势

综合安防管理平台LntonAIServer视频监控汇聚抖动检测算法优势

LntonAIServer视频质量诊断功能中的抖动检测是一个专门针对视频稳定性进行分析的功能。抖动通常是指视频帧之间的不必要运动，这种运动可能是由于摄像机的移动、传输中的错误或编解码问题导致的。抖动检测对于确保视频内容的平滑性和观看体验至关重要。 优势 1. 提高图像质量 - 清晰度提升：减少抖动，提高图像的清晰度和细节表现力，使得监控画面更加真实可信。 - 细节增强：在低光条件下，抖
阅读更多...
阿里开源语音识别SenseVoiceWindows环境部署

阿里开源语音识别SenseVoiceWindows环境部署

SenseVoice介绍 SenseVoice 专注于高精度多语言语音识别、情感辨识和音频事件检测多语言识别： 采用超过 40 万小时数据训练，支持超过 50 种语言，识别效果上优于 Whisper 模型。富文本识别：具备优秀的情感识别，能够在测试数据上达到和超过目前最佳情感识别模型的效果。支持声音事件检测能力，支持音乐、掌声、笑声、哭声、咳嗽、喷嚏等多种常见人机交互事件进行检测。高效推
阅读更多...
usaco 1.2 Name That Number（数字字母转化）

usaco 1.2 Name That Number（数字字母转化）

巧妙的利用code[b[0]-'A'] 将字符ABC...Z转换为数字 需要注意的是重新开一个数组 c [ ] 存储字符串 应人为的在末尾附上 ‘ \ 0 ’ 详见代码： /*ID: who jayLANG: C++TASK: namenum*/#include<stdio.h>#include<string.h>int main(){FILE *fin = fopen (
阅读更多...
【区块链 + 人才服务】可信教育区块链治理系统 | FISCO BCOS应用案例

【区块链 + 人才服务】可信教育区块链治理系统 | FISCO BCOS应用案例

伴随着区块链技术的不断完善，其在教育信息化中的应用也在持续发展。利用区块链数据共识、不可篡改的特性， 将与教育相关的数据要素在区块链上进行存证确权，在确保数据可信的前提下，促进教育的公平、透明、开放，为教育教学质量提升赋能，实现教育数据的安全共享、高等教育体系的智慧治理。 可信教育区块链治理系统的顶层治理架构由教育部、高校、企业、学生等多方角色共同参与建设、维护，支撑教育资源共享、教学质量评估、
阅读更多...
【生成模型系列（初级）】嵌入（Embedding）方程——自然语言处理的数学灵魂【通俗理解】

【生成模型系列（初级）】嵌入（Embedding）方程——自然语言处理的数学灵魂【通俗理解】

【通俗理解】嵌入（Embedding）方程——自然语言处理的数学灵魂 关键词提炼 #嵌入方程 #自然语言处理 #词向量 #机器学习 #神经网络 #向量空间模型 #Siri #Google翻译 #AlexNet 第一节：嵌入方程的类比与核心概念【尽可能通俗】 嵌入方程可以被看作是自然语言处理中的“翻译机”，它将文本中的单词或短语转换成计算机能够理解的数学形式，即向量。 正如翻译机将一种语言
阅读更多...
软考系统规划与管理师考试证书含金量高吗？

软考系统规划与管理师考试证书含金量高吗？

2024年软考系统规划与管理师考试报名时间节点： 报名时间：2024年上半年软考将于3月中旬陆续开始报名 考试时间：上半年5月25日到28日，下半年11月9日到12日 分数线：所有科目成绩均须达到45分以上（包括45分）方可通过考试 成绩查询：可在“中国计算机技术职业资格网”上查询软考成绩 出成绩时间：预计在11月左右 证书领取时间：一般在考试成绩公布后3~4个月，各地领取时间有所不同
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2