json 如何自定义来自 spring @Valid 验证的默认错误消息？

How do I customize default error message from spring @Valid validation?

提问by Disp Hay

DTO:

DTO：

public class User {

    @NotNull
    private String name;

    @NotNull
    private String password;

    //..
}

Controller:

控制器：

@RequestMapping(value = "/user", method = RequestMethod.POST)
public ResponseEntity<String> saveUser(@Valid @RequestBody User user) {
    //..
    return new ResponseEntity<>(HttpStatus.OK);
}

Default json error:

默认 json 错误：

{"timestamp":1417379464584,"status":400,"error":"Bad Request","exception":"org.springframework.web.bind.MethodArgumentNotValidException","message":"Validation failed for argument at index 0 in method: public org.springframework.http.ResponseEntity<demo.User> demo.UserController.saveUser(demo.User), with 2 error(s): [Field error in object 'user' on field 'name': rejected value [null]; codes [NotNull.user.name,NotNull.name,NotNull.java.lang.String,NotNull]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [user.name,name]; arguments []; default message [name]]; default message [may not be null]],"path":"/user"}

I would like to have my custom json for each error occured. How do I accomplish that?

我想为发生的每个错误设置我的自定义 json。我如何做到这一点？

采纳答案by kswaughs

You can perform validation with Errors/BindingResult object. Add Errors argument to your controller method and customize the error message when errors found.

您可以使用 Errors/BindingResult 对象执行验证。将 Errors 参数添加到您的控制器方法中，并在发现错误时自定义错误消息。

Below is the sample example, errors.hasErrors()returns true when validation is failed.

下面是示例示例，errors.hasErrors()在验证失败时返回 true。

@RequestMapping(value = "/user", method = RequestMethod.POST)
@ResponseBody
public ResponseEntity<String> saveUser(@Valid @RequestBody User user, Errors errors) {
    if (errors.hasErrors()) {
        return new ResponseEntity(new ApiErrors(errors), HttpStatus.BAD_REQUEST);
    }
    return new ResponseEntity<>(HttpStatus.OK);
}

回答by Kamill Sokol

If you want full control over the response message in every controller write a ControllerAdvice. For example, that example transform MethodArgumentNotValidExceptioninto a custom json object:

如果您想完全控制每个控制器中的响应消息，请编写一个ControllerAdvice. 例如，该示例转换MethodArgumentNotValidException为自定义 json 对象：

import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.ResponseStatus;

import java.util.ArrayList;
import java.util.List;

import static org.springframework.http.HttpStatus.BAD_REQUEST;

/**
 * Kudos http://www.petrikainulainen.net/programming/spring-framework/spring-from-the-trenches-adding-validation-to-a-rest-api/
 *
 */
@Order(Ordered.HIGHEST_PRECEDENCE)
@ControllerAdvice
public class MethodArgumentNotValidExceptionHandler {

    @ResponseStatus(BAD_REQUEST)
    @ResponseBody
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Error methodArgumentNotValidException(MethodArgumentNotValidException ex) {
        BindingResult result = ex.getBindingResult();
        List<org.springframework.validation.FieldError> fieldErrors = result.getFieldErrors();
        return processFieldErrors(fieldErrors);
    }

    private Error processFieldErrors(List<org.springframework.validation.FieldError> fieldErrors) {
        Error error = new Error(BAD_REQUEST.value(), "validation error");
        for (org.springframework.validation.FieldError fieldError: fieldErrors) {
            error.addFieldError(fieldError.getField(), fieldError.getDefaultMessage());
        }
        return error;
    }

    static class Error {
        private final int status;
        private final String message;
        private List<FieldError> fieldErrors = new ArrayList<>();

        Error(int status, String message) {
            this.status = status;
            this.message = message;
        }

        public int getStatus() {
            return status;
        }

        public String getMessage() {
            return message;
        }

        public void addFieldError(String path, String message) {
            FieldError error = new FieldError(path, message);
            fieldErrors.add(error);
        }

        public List<FieldError> getFieldErrors() {
            return fieldErrors;
        }
    }
}

回答by Matan Lachmish

I know this is kind of old question,

我知道这是个老问题，

But I just run into it and I found some pretty good articlewhich has also a perfect example in github.

但我刚碰到它，我发现了一些非常好的文章，它在github 中也有一个完美的例子。

Basically it uses @ControllerAdviceas Spring documentation suggests.

基本上它@ControllerAdvice按照 Spring 文档的建议使用。

So for example catching 400 error will be achieved by overriding one function:

因此，例如通过覆盖一个函数来捕获 400 错误：

@ControllerAdvice
public class CustomRestExceptionHandler extends ResponseEntityExceptionHandler {

    @Override
    protected ResponseEntity<Object> handleMethodArgumentNotValid(final MethodArgumentNotValidException ex, final HttpHeaders headers, final HttpStatus status, final WebRequest request) {
        logger.info(ex.getClass().getName());
        //
        final List<String> errors = new ArrayList<String>();
        for (final FieldError error : ex.getBindingResult().getFieldErrors()) {
            errors.add(error.getField() + ": " + error.getDefaultMessage());
        }
        for (final ObjectError error : ex.getBindingResult().getGlobalErrors()) {
            errors.add(error.getObjectName() + ": " + error.getDefaultMessage());
        }
        final ApiError apiError = new ApiError(HttpStatus.BAD_REQUEST, ex.getLocalizedMessage(), errors);
        return handleExceptionInternal(ex, apiError, headers, apiError.getStatus(), request);
    }
}

(ApiError class is a simple object to hold status, message, errors)

（ApiError 类是一个简单的对象，用于保存状态、消息、错误）

回答by Foolish

One way to do it is adding message in @NotNull annotation.

一种方法是在@NotNull 注释中添加消息。

DTO:

DTO：

public class User {

    @NotNull(message = "User name cannot be empty")
    private String name;

    @NotNull(message = "Password cannot be empty")
    private String password;

    //..
}

Controller:

控制器：

@RequestMapping(value = "/user", method = RequestMethod.POST)
public ResponseEntity<String> saveUser(@Valid @RequestBody User user) {
    //..
    return new ResponseEntity<>(HttpStatus.OK);
}
// Add one 
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<List<YourErrorResponse>> handleException(MethodArgumentNotValidException ex) {
// Loop through FieldErrors in ex.getBindingResult();
// return *YourErrorReponse* filled using *fieldErrors*
}

回答by tongtianxiao

@ControllerAdvice(annotations = RestController.class)
public class GlobalExceptionHandler implements ApplicationContextAware {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.OK)
    @ResponseBody
    public ApplicationError validationException(MethodArgumentNotValidException e) {

        e.printStackTrace();
        return new ApplicationError(SysMessageEnum.MSG_005, e.getBindingResult().getAllErrors().get(0).getDefaultMessage());

    }

}

回答by Bala Bhaskar

You can do something like this

你可以做这样的事情

@ExceptionHandler(value = MethodArgumentNotValidException.class)
      protected ResponseEntity<Error> handleGlobalExceptions(MethodArgumentNotValidException ex,
          WebRequest request) {
        log.catching(ex);
        return new ResponseEntity<>(createErrorResp(HttpStatus.BAD_REQUEST,
            ex.getBindingResult().getFieldErrors().stream().map(err -> err.getDefaultMessage())
                .collect(java.util.stream.Collectors.joining(", "))),
            HttpStatus.BAD_REQUEST);
      }

回答by Ashok Parmar

For customized the error message in JSON format then do the below steps.

要自定义 JSON 格式的错误消息，请执行以下步骤。

- Create one @Component called CommonErrorHandler

- 创建一个名为 CommonErrorHandler 的@Component

@Component
public class CommonErrorHandler {
public  Map<String,Object> getFieldErrorResponse(BindingResult result){

        Map<String, Object> fielderror = new HashMap<>();
        List<FieldError>errors= result.getFieldErrors();
        for (FieldError error : errors) {
            fielderror.put(error.getField(), error.getDefaultMessage());
        }return fielderror;
    }

     public ResponseEntity<Object> fieldErrorResponse(String message,Object fieldError){
        Map<String, Object> map = new HashMap<>();
        map.put("isSuccess", false);
        map.put("data", null);
        map.put("status", HttpStatus.BAD_REQUEST);
        map.put("message", message);
        map.put("timeStamp", DateUtils.getSysDate());
        map.put("filedError", fieldError);
        return new ResponseEntity<Object>(map,HttpStatus.BAD_REQUEST);
    }
}

-- Add InvalidException class

-- 添加 InvalidException 类

public class InvalidDataException extends RuntimeException {

/**
 * @author Ashok Parmar
 */
    private static final long serialVersionUID = -4164793146536667139L;

    private BindingResult result;

    public InvalidDataException(BindingResult result) {
        super();
        this.setResult(result);
    }

    public BindingResult getResult() {
        return result;
    }

    public void setResult(BindingResult result) {
        this.result = result;
    }

}

- Introduce @ControllerAdvice class

- 引入@ControllerAdvice 类

@ControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {

@ExceptionHandler(InvalidDataException.class)
    public ResponseEntity<?> invalidDataException(InvalidDataException ex, WebRequest request) {

        List<FieldError> errors = ex.getResult().getFieldErrors();
        for (FieldError error : errors) {
            logger.error("Filed Name ::: " + error.getField() + "Error Message :::" + error.getDefaultMessage());
        }
        return commonErrorHandler.fieldErrorResponse("Error", commonErrorHandler.getFieldErrorResponse(ex.getResult()));
    }
    }

-- Use in controller with @Valid and throw exception

-- 在控制器中使用@Valid 并抛出异常

public AnyBeans update(**@Valid** @RequestBody AnyBeans anyBeans ,
            BindingResult result) {
        AnyBeans resultStr = null;
        if (result.hasErrors()) {
            **throw new InvalidDataException(result);**
        } else {
                resultStr = anyBeansService.(anyBeans );
                return resultStr;
        }
    }

-- Output will be in JSON format

-- 输出将采用 JSON 格式

{
  "timeStamp": 1590500231932,
  "data": null,
  "message": "Error",
  "isSuccess": false,
  "status": "BAD_REQUEST",
  "filedError": {
    "name": "Name is mandatory"
  }
}

Hope this will be work. :-D

希望这会奏效。:-D

回答by Akshay Misal

@ControllerAdvice
@RestController
public class CustomizedResponseEntityExceptionHandler extends ResponseEntityExceptionHandler {

        @Override
        protected ResponseEntity<Object> handleMethodArgumentNotValid(
                MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {

           // ex.getBindingResult(): extract the bind result for default message. 
              String errorResult = ex.getBindingResult().toString();
             CustomizedExceptionHandlerResponse exceptionResponse = new CustomizedExceptionHandlerResponse(
                    errorResult, new Date(), request.getDescription(false));

            return new ResponseEntity<>(exceptionResponse, HttpStatus.BAD_REQUEST);
        }


}

class CustomizedExceptionHandlerResponse {

   private String message;
   private String status;
   private Date timestamp;

   // constuctor, setters, getters...
}

回答by Anton

Add some information too. If you use just @Valid, you need to catch BindException. If you use @Valid @RequestBodycatch MethodArgumentNotValidException

也补充一些信息。如果您使用 just @Valid，则需要 catch BindException。如果你使用@Valid @RequestBodycatchMethodArgumentNotValidException

Some sources:
HandlerMethodArgumentResolverComposite.getArgumentResolver(MethodParameter parameter):129- search which HandlerMethodArgumentResolver support such parameterRequestResponseBodyMethodProcessor.supportsParameter(MethodParameter parameter)- return true if parameter has annotation@RequestBody

一些来源：
HandlerMethodArgumentResolverComposite.getArgumentResolver(MethodParameter parameter):129-搜索哪个 HandlerMethodArgumentResolver 支持这样的参数RequestResponseBodyMethodProcessor.supportsParameter(MethodParameter parameter)-如果参数有注释，则返回 true@RequestBody

RequestResponseBodyMethodProcessor:139- throw MethodArgumentNotValidExceptionModelAttributeMethodProcessor:164- throw BindException

RequestResponseBodyMethodProcessor:139-抛出 MethodArgumentNotValidExceptionModelAttributeMethodProcessor:164-抛出 BindException

回答by Muhammad amirullah

{
  "message": "string",
  "errors": [
    {
      "field": "string",
      "message": "string",
      "error_code": "string"
    }
  ],
  "resource": "string",
  "description": "string"
}