首页 文章 精选 留言 我的

精选列表

搜索[API集成],共10000篇文章
优秀的个人博客,低调大师

SpringBoot开发秘籍 - 集成参数校验及高阶技巧

对于 web服务来说,为防止非法参数对业务造成影响,在 Controller层一定要对参数进行校验!本章我们以SpringBoot项目为例,介绍参数校验的基本用法以及一些高级技巧,希望能对你有所帮助。 简单使用 要在Springboot项目中加入参数校验功能首先得加入 spring-boot-starter-validation依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> 然后给需要校验的字段添加上约束性注解,如我们对实体类参数进行校验 @Data publicclassValidEntity{ privateintid; @NotBlank privateStringappId; @NotBlank privateStringname; @Email privateStringemail; } 常见约束注解如下: 注解 功能 @AssertFalse 可以为null,如果不为null的话必须为false @AssertTrue 可以为null,如果不为null的话必须为true @DecimalMax 设置不能超过最大值 @DecimalMin 设置不能超过最小值 @Digits 设置必须是数字且数字整数的位数和小数的位数必须在指定范围内 @Future 日期必须在当前日期的未来 @Past 日期必须在当前日期的过去 @Max 最大不得超过此最大值 @Min 最大不得小于此最小值 @NotNull 不能为null,可以是空 @Null 必须为null @Pattern 必须满足指定的正则表达式 @Size 集合、数组、map等的size()值必须在指定范围内 @Email 必须是email格式 @Length 长度必须在指定范围内 @NotBlank 字符串不能为null,字符串trim()后也不能等于“” @NotEmpty 不能为null,集合、数组、map等size()不能为0;字符串trim()后可以等于“” @Range 值必须在指定范围内 @URL 必须是一个URL 注:此表格只是简单的对注解功能的说明,并没有对每一个注解的属性进行说明;可详见源码。 在Controller层对需要参数校验的方法加上@Validated注解 参数校验一般分为两类:在Controller使用模型接收数据时, @Validated注解直接放在该模型参数前即可。 @PostMapping(value="test1") publicStringtest1(@Validated@RequestBodyValidEntityvalidEntity){ return"test1validsuccess"; } @PostMapping(value="test3") publicStringtest3(@ValidatedValidEntityvalidEntity){ return"test3validsuccess"; } 当我们是直接在Controller层中的参数前,使用约束注解时,@Validated要直接放在类上 @PostMapping(value="test2") publicStringtest2(@EmailStringemail){ return"test2validsuccess"; } 此时需要在主类上增加@Validated注解 @Validated @RestController @RequestMapping("/demo/valid") publicclassValidController{ ... } 在参数校验时我们既可以使用@Validated也可以使用@Valid注解,两者功能大部分类似; 主要区别在于: @Valid属于javax下的,而@Validated属于spring下; @Valid支持嵌套校验、而@Validated不支持,@Validated支持分组,而@Valid不支持。 统一异常处理 如果参数校验未通过Spring会抛出三种类型的异常 当对@RequestBody需要的参数进行校验时会出现 org.springframework.web.bind.MethodArgumentNotValidException 当直接校验具体参数时会出现 javax.validation.ConstraintViolationException,也属于 ValidationException异常 当直接校验对象时会出现 org.springframework.validation.BindException 在SpringBoot中统一拦截处理只需要在配置类上添加 @RestControllerAdvice注解,然后在具体方法中通过 @ExceptionHandler指定需要处理的异常,具体代码如下: @RestControllerAdvice @Slf4j publicclassGlobalExceptionHandler{ publicstaticfinalStringERROR_MSG="系统异常,请联系管理员。"; @ExceptionHandler(value={BindException.class,ValidationException.class,MethodArgumentNotValidException.class}) publicResponseEntity<Result<String>>handleValidatedException(Exceptione){ Result<String>resp=null; if(einstanceofMethodArgumentNotValidException){ //BeanValidationexception MethodArgumentNotValidExceptionex=(MethodArgumentNotValidException)e; resp=newResult<>(Integer.toString(HttpStatus.BAD_REQUEST.value()), ex.getBindingResult().getAllErrors().stream().map(ObjectError::getDefaultMessage).collect(Collectors.joining(",")) ,getStackTrace(ex)); }elseif(einstanceofConstraintViolationException){ //BeanValidationGETsimpleparam ConstraintViolationExceptionex=(ConstraintViolationException)e; resp=newResult<>(Integer.toString(HttpStatus.BAD_REQUEST.value()), ex.getConstraintViolations().stream().map(ConstraintViolation::getMessage).collect(Collectors.joining(",")) ,getStackTrace(ex)); }elseif(einstanceofBindException){ //BeanValidationGETobjectparam BindExceptionex=(BindException)e; resp=newResult<>(Integer.toString(HttpStatus.BAD_REQUEST.value()), ex.getAllErrors().stream().map(ObjectError::getDefaultMessage).collect(Collectors.joining(",")) ,getStackTrace(ex)); } returnnewResponseEntity<>(resp,HttpStatus.BAD_REQUEST); } privateStringgetStackTrace(Exceptione){ //打印日志开关,可通过配置读取 booleanprintStrackTrace=false; if(printStrackTrace){ StringWritersw=newStringWriter(); e.printStackTrace(newPrintWriter(sw)); returnsw.toString(); }else{ returnERROR_MSG; } } } 最终实现效果如下: 参数分组 有下面一个实体类,我们需要对其进行参数校验。 @Data publicclassValidEntity{ privateintid; @NotBlank privateStringappId; @NotBlank privateStringname; @Email privateStringemail; } 但是实际业务是在编辑的时候 appId才是必填,在新增的时候 name必填,这时候可以用groups分组功能来实现:同一个模型在不同场景下,动态区分校验模型中的不同字段。 使用方式 首先我们定义一个分组接口ValidGroup,再在分组接口总定义出多个不同的操作类型,Create,Update,Query,Delete publicinterfaceValidGroupextendsDefault{ interfaceCrudextendsValidGroup{ interfaceCreateextendsCrud{ } interfaceUpdateextendsCrud{ } interfaceQueryextendsCrud{ } interfaceDeleteextendsCrud{ } } } 这里的 ValidGroup继承了Default,当然也可以不继承,具体区别我们后面再说。 在模型中给校验参数分配分组 @Data @ApiModel(value="ValidEntity") publicclassValidEntity{ privateintid; @NotBlank(groups=ValidGroup.Crud.Update.class) privateStringappId; @NotBlank(groups=ValidGroup.Crud.Create.class) privateStringname; @Email privateStringemail; } tips:这里@Email注解未指定分组,默认会属于Default分组,appId和name指定了分组就不会再属于Default分组了。 在参数校验时通过value属性指定分组 这里通过 @Validated(value = ValidGroup.Crud.Update.class)指定了具体的分组,上面提到的是否继承Default的区别在于: 如果继承了Default,@Validated标注的注解也会校验未指定分组或者Default分组的参数,比如email 如果不继承Default则不会校验未指定分组的参数,需要加上 @Validated(value = {ValidGroup.Crud.Update.class, Default.class}才会校验 快速失败(Fali Fast) 默认情况下在对参数进行校验时Spring Validation会校验完所有字段然后才抛出异常,可以通过配置开启 Fali Fast模式,一旦校验失败就立即返回。 @Configuration publicclassValidatedConfig{ @Bean publicValidatorvalidator(){ ValidatorFactoryvalidatorFactory=Validation.byProvider(HibernateValidator.class) .configure() //快速失败模式 .failFast(true) .buildValidatorFactory(); returnvalidatorFactory.getValidator(); } } 以上,希望对你有所帮助! 这里为大家准备了一份小小的礼物,关注公众号,输入如下代码,即可获得百度网盘地址,无套路领取! 001:《程序员必读书籍》 002:《从无到有搭建中小型互联网公司后台服务架构与运维架构》 003:《互联网企业高并发解决方案》 004:《互联网架构教学视频》 006:《SpringBoot实现点餐系统》 007:《SpringSecurity实战视频》 008:《Hadoop实战教学视频》 009:《腾讯2019Techo开发者大会PPT》 010:微信交流群 本文分享自微信公众号 - JAVA日知录(javadaily)。 如有侵权,请联系 support@oschina.cn 删除。 本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

优秀的个人博客,低调大师

spring boot 集成RabbitMQ 接收消息及其高级特性

基本用法 连接和资源管理 管理MQ的核心类:ConnectionFactory ConnectionFactory封装了com.rabbitmq.client.Connection,官方提供的实现类为CachingConnectionFactory,它缓存了创建的信道(Channel),默认为25个,可以通过setChannelCacheSize来更改数量。 @Bean(name="cwagConnectionFactory") public ConnectionFactory cwagConnectionFactory(){ CachingConnectionFactory connectionFactory = new CachingConnectionFactory(); connectionFactory.setHost(host); connectionFactory.setPort(5672); connectionFactory.setUsername("guest"); connectionFactory.setPassword("guest"); return connectionFactory; } @RabbitListener的那些配置 从1.4版本开始,@RabbitListener(queues = "myQueue")可以接收来自myQueue队列的消息,但是这个队列必须在路由里面存在。 从1.5版本开始,queue可以自动声明和绑定。 一个配置的列子: @RabbitListener(bindings = @QueueBinding( value = @Queue(value = "myQueue", durable = "true"), exchange = @Exchange(value = "auto.exch", ignoreDeclarationExceptions = "true"), key = "orderRoutingKey") ) public void processOrder(String data) { ... } 其中,@QueueBinding包含有以下参数: value:类型为@Queue,如果只配置为@Queue,没有配置value属性,则会创建一个匿名队列(exclusive, auto-delete)例如: @RabbitListener(bindings = @QueueBinding( value = @Queue, exchange = @Exchange(value = "auto.exch", ignoreDeclarationExceptions = "true")) ) exchange:类型为@Exchange,Exchange支持的类型为DIRECT, FANOUT, TOPIC and HEADERS,例如: exchange = @Exchange(value = "auto.exch",type = ExchangeTypes.TOPIC,autoDelete = "tue",durable = "true"), 可能遇到的问题: 如何动态设置Qeueu的名称? @Queue支持properties或者SpEL表达式定义: 通过property定义:${...} @RabbitListener(queues = { "${queue1}", "${queue2}" } ) @RabbitListener(queues = "#{'${property.with.comma.delimited.queue.names}'.split(',')}" ) 通过SpEL表达式定义:#{...} @RabbitListener(queues = "#{queueName}" ) .... //在Bean中声明 @Bean public String queueName(){ return "helloQueue"; } 如何通过Exchange,RoutingKey进行连接绑定? @RabbitListener(bindings = @QueueBinding( value = @Queue,//设置一个匿名队列 exchange = @Exchange(value = "auto.exch"),key="routingKey") ) 自己手动配置MQ连接,例如:系统中要连接多个MQ地址;需要配置多个线程处理消息 ConnectionFactory:配置MQ连接 @Bean(name="cwagConnectionFactory") public ConnectionFactory cwagConnectionFactory(){ CachingConnectionFactory connectionFactory = new CachingConnectionFactory(); connectionFactory.setHost(host); connectionFactory.setPort(5672); connectionFactory.setUsername("guest"); connectionFactory.setPassword("guest"); return connectionFactory; } RabbitListenerContainerFactory 构造ListenerContainerFactory @Bean(name="myListenerFactory") public SimpleRabbitListenerContainerFactory firstFactory( SimpleRabbitListenerContainerFactoryConfigurer configurer, @Qualifier("myConnectionFactory") ConnectionFactory connectionFactory ) { SimpleRabbitListenerContainerFactory factory = new SimpleRabbitListenerContainerFactory(); factory.setConcurrentConsumers(3);//默认开启3个线程的线程池 factory.setMaxConcurrentConsumers(10);//最大线程为10个 configurer.configure(factory, connectionFactory); return factory; } 引用构造ListenerContainerFactory: @RabbitHandler @RabbitListener(queues = "MyQueue",containerFactory = "myListenerFactory") public void receiveApply(@Payload byte[] msg) throws IOException { log.info("received from MyQueue" ); } 高级特性 队列长度 如何设置队列长度:设置最大消息数量(x-max-length)或者最大容量(x-max-length-bytes) Map<String,Object> map = new HashMap<>(); //设置最大长度 map.put("x-max-length",5); return new Queue("5-length",false,false,false,map); 投递消息数量超多队列长度 默认情况下(overflow:drop-head),当消息数量超多最大容量后,队列头部(最老的消息)消息会被丢弃或者变为死信(死信路由存在的时候才会发到对应的路由)。可以通过overflow来设置默认规则。 overflow的规则 drop-head reject-publish:最新发布的消息被丢弃。 死信队列 消息变为死信的情况: 消息被拒绝 消息过期 队列长度达到最大长度 如何设置死信队列 创建队列时设置队列的死信路由键即可。订阅此路由的队列就可以收到死信消息。 Map<String,Object> map = new HashMap<>(); //设置最大长度 map.put("x-max-length",5); //设置死信路由 map.put("x-dead-letter-exchange","my-dead-exchange"); map.put("x-dead-letter-routing-key","dead-r-5"); return new Queue("5-length",false,false,false,map); 延迟队列 延迟队列就是某个时间段过后消息被投递到此队列。可以利用消息超时后被进入到死信队列这个特点来实现。 如上图所示,绑定了x-dead-letter-exchage,x-dead-letter-routing-key的队列就是延迟队列。 Tips: 对于使用过程中存在的问题,仔细阅读官方文档是最有效的方法, 参考文档:https://docs.spring.io/spring-amqp/reference/html/_reference.html#broker-configuration 注解配置:https://docs.spring.io/spring-amqp/docs/1.7.11.RELEASE/reference/html/_reference.html#async-annotation-driven

资源下载

更多资源
Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题,腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构,目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Rocky Linux

Rocky Linux

Rocky Linux(中文名:洛基)是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版,作为CentOS稳定版停止维护后与RHEL(Red Hat Enterprise Linux)完全兼容的开源替代方案,由社区拥有并管理,支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性,采用模块化包装和SELinux安全架构,默认包含GNOME桌面环境及XFS文件系统,支持十年生命周期更新。

用户登录
用户注册