经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » 程序设计 » 编程经验 » 查看文章
参数校验与国际化:提高代码稳定性和可维护性的重要方法
来源:cnblogs  作者:努力的小雨  时间:2023/12/15 9:08:49  对本文有异议

在我们日常的工作中,参数校验是一项非常重要的任务。它能够帮助我们确保代码的稳定性和可靠性,避免因为参数错误而导致的意外情况发生。参数校验通常包括对输入参数的合法性、格式的检查等。而为了提高代码的可维护性和可重用性,我们可以使用一些常见的参数校验方法。

另外,国际化也是一项非常重要的功能,尤其是在跨国项目中。通过国际化的配置,我们可以根据用户的语言环境,自动切换显示的语言,提供更好的用户体验。在参数校验中,我们也可以使用国际化配置来返回相应的提示信息,使得提示信息能够适应不同的语言环境。

  • RequestParam参数校验
  • NotEmpty等注解参数校验
  • 实体类增加参数校验
  • CustomException,自定义异常对参数异常进行国际化定制
  • NotEmptyField,自定义注解实现对参数异常进行国际化定制

好的,让我们一步一步来介绍参数校验的方法。除了上述提到的方法,如果还有一些其他的优秀方法可以用来进行参数校验,也可以提醒我一下!

RequestParam参数校验

RequestParam本身就有对参数进行的基础校验,比如required表示是否参数必填。可以通过在方法参数上使用@RequestParam注解来实现参数校验。以下是示例代码:

  1. @GetMapping("/hello-not-required")
  2. public String sayHelloByNotRequired(@RequestParam(required = false, name = "who") String who) {
  3. if (StrUtil.isBlank(who)) {
  4. who = "World";
  5. }
  6. return StrUtil.format("Hello, {}!", who);
  7. }

如果不传递参数,也不会有任何问题,这里不做演示就可以了,非常简单。

NotEmpty等注解参数校验

默认message

然而,虽然RequestParam只能指示参数是否被携带,但它并不负责检验参数值是否为空。因此,我们可以通过与NotEmpty注解结合使用来进行判断。

  1. @GetMapping("/hello-required")
  2. public String sayHelloByRequired(@RequestParam @NotEmpty String who) {
  3. return StrUtil.format("Hello, {}!", who);
  4. }

当访问http://localhost:8080/demo/hello-required?who=时,我们的程序是报错的,因为who字段不能为空

image

自定义message

如果你仔细阅读了NotEmpty注解的文档,你会发现它允许自定义报错提示信息。因此,我们可以尝试自定义提示信息,以满足我们的需求。

  1. @GetMapping("/hello-required-message")
  2. public String sayHelloByRequiredWithMessage(@RequestParam @NotEmpty(message = "who must be not null") String who) {
  3. return StrUtil.format("Hello, {}!", who);
  4. }

我再来为你演示一下,除了NotEmpty注解,还有许多其他已经内置的注解可供使用。我就不一一列举了,你可以自行探索更多的注解。

image

实体类增加参数校验

除了上面提到的简单校验方式,我们在实际开发中更常使用的是通过JSON传递参数,并使用实体类接收参数。下面是相关代码示例:

  1. @PostMapping("/hello-required-message-object")
  2. public String sayHelloByRequiredWithMessageForObject(@RequestBody @Valid MyTest test) {
  3. return StrUtil.format("Hello, {}!", test);
  4. }
  1. public class MyTest {
  2. @NotEmpty(message = "NotEmpty.message")
  3. private String test;
  4. public String getTest() {
  5. return test;
  6. }
  7. public void setTest(String test) {
  8. this.test = test;
  9. }
  10. }

加长优化语句:为了方便演示,我特意更换了一些提示信息,以便更清晰地展示给大家。接下来,我们再仔细观察一下。

image

自定义异常

其实在工作中,校验参数是一个常见的任务。我们通常会使用代码进行各种校验,因为我们对参数的要求远远超出了简单的非空检查。除了非空检查,我们还需要进行其他等值校验等。因此,如果在代码中进行校验,我们可以选择抛出异常或直接返回错误信息。举个例子,我可以使用自定义异常来说明这一点:

  1. @PostMapping("/hello-required-message-i18n")
  2. public String sayHelloByRequiredWithMessageFori18n() {
  3. throw new CustomException("notBlank.message");
  4. }

代码经过优化,已经去除了多余的逻辑,直接通过抛出异常来处理。让我来演示一下。

image

虽然在出错时会有报错信息返回,但是这些错误信息并不完全符合业务返回数据的格式。为了解决这个问题,我们需要定义一个全局异常处理类来统一处理异常情况。

  1. @RestControllerAdvice
  2. public class GlobalExceptionHandler {
  3. @Autowired
  4. private MessageSource messageSource;
  5. @ExceptionHandler(Exception.class)
  6. @ResponseStatus(HttpStatus.BAD_REQUEST)
  7. public ResponseEntity<ErrorResponse> handleCustomException(CustomException ex, Locale locale) {
  8. String errorMessage = messageSource.getMessage(ex.getMessage(), null, locale);
  9. ErrorResponse errorResponse = new ErrorResponse(500, errorMessage);
  10. return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
  11. }
  12. }

ErrorResponse是我单独定义的错误描述类,我就不写了,因为每个项目都会有自己的返回类。

国际化信息

让我们进一步探讨一下关于国际化信息的定制。首先,为了实现这一目标,你需要在应用程序中进行相关的配置,具体来说,就是在application.yaml文件中进行必要的设置。

  1. server:
  2. port: 8080
  3. servlet:
  4. context-path: /demo
  5. spring:
  6. messages:
  7. baseName: i18n/messages
  8. encoding: UTF-8
  9. mvc:
  10. locale: zh_CN

请注意,baseName在这里表示路径,而最后的messages并不代表包的含义,而是文件的前缀。如果无法找到messages_zh_CN文件,则会尝试查找messages_zh文件,如果还找不到,则会查找messages文件。因此,请不要再创建一个名为messages的包。

image

当所有准备工作完成后,我们可以检查演示结果是否已经改变了字段信息。

image

自定义注解

现在基本上已经存在了全局异常处理机制,不过我们还需要进一步优化。现在让我们来讨论一下自定义注解的使用。首先,我们注意到错误信息无法给出具体的字段值。显然,我们不能每次都手动写上每个字段的名称并提示不能为空。为了解决这个问题,我们需要自定义一个注解来实现自动化的校验。

  1. @Target(ElementType.FIELD)
  2. @Retention(RetentionPolicy.RUNTIME)
  3. public @interface NotEmptyField {
  4. String message() default "";
  5. }

有了注解后,下一步就是通过切面来获取并处理这个注解。接下来,我们来编写相应的代码来实现这个功能:

  1. @Aspect
  2. @Component
  3. public class NotEmptyFieldAspect {
  4. @Autowired
  5. private MessageSource messageSource;
  6. @Around("within(com.xkcoding..*)")
  7. public Object validateNotEmptyField(ProceedingJoinPoint joinPoint) throws Throwable {
  8. // 获取目标方法的参数列表
  9. Object[] args = joinPoint.getArgs();
  10. // 遍历参数列表
  11. for (Object arg : args) {
  12. // 获取参数实体类的属性
  13. Field[] fields = arg.getClass().getDeclaredFields();
  14. // 遍历属性列表
  15. for (Field field : fields) {
  16. // 判断属性是否被 @NotEmptyField 注解修饰
  17. if (field.isAnnotationPresent(NotEmptyField.class)) {
  18. // 获取注解信息
  19. NotEmptyField annotation = field.getAnnotation(NotEmptyField.class);
  20. field.setAccessible(true);
  21. // TODO: 进一步处理逻辑
  22. if (ObjectUtil.isEmpty(field.get(arg))) {
  23. String message = messageSource.getMessage(annotation.message(), null, Locale.getDefault());
  24. throw new CustomException(field.getName() + message);
  25. }
  26. // 输出属性和注解信息
  27. System.out.println("属性:" + field.getName());
  28. System.out.println("注解信息:" + annotation.message());
  29. System.out.println("值:" + field.get(arg));
  30. }
  31. }
  32. }
  33. // 调用目标方法
  34. Object result = joinPoint.proceed();
  35. return result;
  36. }
  37. }

我只是简单地写了一下实现逻辑,并没有进行优化操作,所以以上代码仅供参考。现在让我们来看一下外层代码:

  1. @PostMapping("/hello-required-message-i18n-object")
  2. public String sayHelloByRequiredWithMessageFori18nObject(@RequestBody @Valid MyTestForAspect myTestForAspect) {
  3. return "";
  4. }

当我们完成所有的准备工作之后,让我们来观察一下演示情况:

image

总结

在我们的工作中,参数校验是一项不可或缺的重要任务。因此,本文只是初步探讨了可以进行优化的方面,而并未详细阐述如何完美地进行优化。如果我遗漏了一些解决方案,也欢迎大家提供宝贵的建议和提醒。我的目的只是提供一些思路和引发讨论,以期能够共同进步。

原文链接:https://www.cnblogs.com/guoxiaoyu/p/17893081.html

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号