springboot i18n 国际化配置

创建文件

创建配置类

import cn.mbdoge.jyx.exception.LocalServiceException;
import cn.mbdoge.jyx.exception.RequestLimitException;
import cn.mbdoge.jyx.web.model.RespResult;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.context.support.MessageSourceAccessor;
import org.springframework.context.support.ReloadableResourceBundleMessageSource;
import org.springframework.http.HttpStatus;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.validation.BindException;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.HttpMediaTypeNotSupportedException;
import org.springframework.web.HttpRequestMethodNotSupportedException;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.MissingServletRequestParameterException;
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 org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import org.springframework.web.multipart.MaxUploadSizeExceededException;
import org.springframework.web.multipart.MultipartException;
import org.springframework.web.servlet.NoHandlerFoundException;

import java.nio.charset.StandardCharsets;
import java.util.Objects;

@ConditionalOnClass({MessageSourceAccessor.class})
@ControllerAdvice
@ResponseBody
public class ControllerHandlerAdvice {
    private static final Logger log = LoggerFactory.getLogger(cn.mbdoge.jyx.web.handler.ControllerHandlerAdvice.class);
    protected final MessageSourceAccessor messageSourceAccessor;

    public ControllerHandlerAdvice() {
        ReloadableResourceBundleMessageSource reloadableResourceBundleMessageSource = new ReloadableResourceBundleMessageSource();
        reloadableResourceBundleMessageSource.setBasenames("classpath:i18n/messages");
        reloadableResourceBundleMessageSource.setCacheSeconds(3600);
        reloadableResourceBundleMessageSource.setDefaultEncoding(StandardCharsets.UTF_8.name());
        this.messageSourceAccessor = new MessageSourceAccessor(reloadableResourceBundleMessageSource);
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({MissingServletRequestParameterException.class})
    public RespResult<?> handleMissingServletRequestParameterException(MissingServletRequestParameterException e) {
        log.trace("MissingServletRequestParameterException 缺少请求参数 getParameterName = {} type = {}", e.getParameterName(), e.getParameterType());
        return RespResult.warning(this.messageSourceAccessor.getMessage("controller.parameter.MissingServletRequest", new Object[]{e.getParameterName()}));
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({HttpMessageNotReadableException.class})
    public RespResult<?> handleHttpMessageNotReadableException(HttpMessageNotReadableException e) {
        log.trace("HttpMessageNotReadableException 请求体解析失败 = {}", e.getMessage());
        return RespResult.warning(this.messageSourceAccessor.getMessage("controller.parameter.HttpMessageNotReadable"));
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({MethodArgumentNotValidException.class})
    public RespResult<?> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        log.trace("MethodArgumentNotValidException 参数验证失败 = {}", e.getMessage());
        return this.parseBindingResult(e.getBindingResult());
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({BindException.class})
    public RespResult<?> handleBindException(BindException e) {
        log.trace("BindException 参数验证失败 = {}", e.getMessage());
        return this.parseBindingResult(e.getBindingResult());
    }

    private RespResult<?> parseBindingResult(BindingResult result) {
        if (result.hasFieldErrors()) {
            FieldError fieldError = result.getFieldError();

            assert fieldError != null;

            String field = fieldError.getField();
            return RespResult.warning(fieldError.getDefaultMessage(), field);
        } else {
            return RespResult.warning(this.messageSourceAccessor.getMessage("controller.parameter.MethodArgumentNotValid.empty"));
        }
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({MethodArgumentTypeMismatchException.class})
    public RespResult<?> handleMethodArgumentTypeMismatchException(MethodArgumentTypeMismatchException ex) {
        log.trace("MethodArgumentTypeMismatchException 参数类型出错 = {}", ex.getMessage());
        String type = Objects.requireNonNull(ex.getRequiredType()).getSimpleName();
        Object value = ex.getValue();
        return RespResult.error(this.messageSourceAccessor.getMessage("controller.parameter.ArgumentTypeMismatch", new Object[]{type, value}));
    }

    @ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
    @ExceptionHandler({HttpRequestMethodNotSupportedException.class})
    public RespResult<?> handleHttpRequestMethodNotSupportedException(HttpRequestMethodNotSupportedException e) {
        log.trace("不支持的请求方法 = {} ", e.getMethod());
        return RespResult.error(this.messageSourceAccessor.getMessage("controller.MethodNotSupported", new Object[]{e.getMethod()}));
    }

    @ResponseStatus(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
    @ExceptionHandler({HttpMediaTypeNotSupportedException.class})
    public RespResult<?> handleHttpMediaTypeNotSupportedException(HttpMediaTypeNotSupportedException e) {
        log.trace("不支持当前媒体类型 = {}", e.getContentType());
        return RespResult.info(this.messageSourceAccessor.getMessage("controller.HttpMediaTypeNotSupported", new Object[]{e.getContentType()}));
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({MultipartException.class})
    public RespResult<?> handleMultipartException(MultipartException e) {
        log.trace("上传文件失败", e);
        String message = "upload.fail";
        if (e instanceof MaxUploadSizeExceededException) {
            message = "upload.fail.exceeded.max.size";
        }

        return RespResult.warning(this.messageSourceAccessor.getMessage(message));
    }

    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler({LocalServiceException.class})
    public RespResult<?> handleServiceException(LocalServiceException e) {
        return RespResult.info(this.messageSourceAccessor.getMessage(e.getMessage(), e.getParams()), "zh_CN");
    }

    @ResponseStatus(HttpStatus.FORBIDDEN)
    @ExceptionHandler({RequestLimitException.class})
    public RespResult<?> handleRequestLimitException(RequestLimitException e) {
        String message = e.getMessage();
        if (message == null) {
            message = "request.limit";
        }

        return RespResult.warning(this.messageSourceAccessor.getMessage(message));
    }

    @ResponseStatus(HttpStatus.NOT_FOUND)
    @ExceptionHandler({NoHandlerFoundException.class})
    public RespResult<?> noHandlerFoundException(NoHandlerFoundException e) {
        log.trace("Not Found = {}", e.getRequestURL());
        return RespResult.info(this.messageSourceAccessor.getMessage("controller.404"));
    }

    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    @ExceptionHandler({Exception.class})
    public RespResult<?> handleException(Exception e) {
        log.error("通用异常 = e.class = {} message = {}", e.getClass(), e.getMessage(), e);
        return RespResult.error(this.messageSourceAccessor.getMessage("controller.500"));
    }
}

public class LocalServiceException extends RuntimeException {
    private Object data;
    private Object[] params;

    public LocalServiceException(String message) {
        this(message, new Object[0]);
    }

    public LocalServiceException(String message, Throwable cause) {
        this(message, (Object[])null, cause);
    }

    public LocalServiceException(String message, Object[] params) {
        this(message, params, (Throwable)null);
    }

    public LocalServiceException(String message, Object[] params, Throwable cause) {
        super(message, cause);
        this.params = params;
    }

    public Object[] getParams() {
        return this.params;
    }

    public Object getData() {
        return this.data;
    }

    public void setData(Object data) {
        this.data = data;
    }
}

使用

new LocalServiceException("user.id.no-found", new Object[]{uid})