Java Web开发中Integer类型参数非数字输入处理策略与验证实践

public class MyRequest {
    @NotNull(message = "年份不能为空")
    @Digits(integer = 4, fraction = 0, message = "年份必须是四位数字")
    @Min(value = 1900, message = "年份必须大于1900")
    private Integer year;

    // Getters and Setters
}

"Failed to convert property value of type 'java.lang.String' to required type 'java.lang.Integer' for property 'year'; nested exception is java.lang.NumberFormatException: For input string: "20c15""

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MethodArgumentTypeMismatchException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

import java.util.HashMap;
import java.util.Map;

@ControllerAdvice
public class GlobalExceptionHandler {

    /**
     * 处理方法参数类型不匹配异常，例如将非数字字符串传递给Integer类型参数
     */
    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
    public ResponseEntity<Map<String, String>> handleMethodArgumentTypeMismatch(MethodArgumentTypeMismatchException ex) {
        String parameterName = ex.getName(); // 获取参数名
        String requiredType = ex.getRequiredType() != null ? ex.getRequiredType().getSimpleName() : "未知类型"; // 获取所需类型
        String invalidValue = ex.getValue() != null ? ex.getValue().toString() : "空值"; // 获取无效值

        Map<String, String> errorResponse = new HashMap<>();
        errorResponse.put("error", "参数类型转换失败");
        errorResponse.put("message", String.format("参数 '%s' 的值 '%s' 无法转换为预期的 '%s' 类型。请提供有效输入。",
                parameterName, invalidValue, requiredType));
        errorResponse.put("field", parameterName);

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

    // 可以根据需要添加其他异常处理器，例如处理 HttpMessageNotReadableException
    // @ExceptionHandler(HttpMessageNotReadableException.class)
    // public ResponseEntity<Map<String, String>> handleHttpMessageNotReadable(HttpMessageNotReadableException ex) {
    //     // ... 处理请求体解析失败，如JSON格式错误或类型不匹配
    //     // Map<String, String> errorResponse = new HashMap<>();
    //     // errorResponse.put("error", "请求体解析失败");
    //     // errorResponse.put("message", "请求体格式不正确或包含无效数据。");
    //     // return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
    // }
}

import javax.validation.constraints.Pattern;
import javax.validation.constraints.NotNull;

public class MyRequestWithStringUtils {

    // 使用 @Pattern 校验字符串是否只包含数字，且长度为4
    @NotNull(message = "年份字符串不能为空")
    @Pattern(regexp = "^\d{4}$", message = "年份必须是四位数字字符串")
    private String yearString;

    // 提供一个getter方法，用于将字符串转换为Integer
    public Integer getYear() {
        if (yearString == null || yearString.isEmpty()) {
            return null; // 或者抛出异常，取决于业务需求
        }
        try {
            // 在这里可以添加额外的业务逻辑校验，例如年份范围
            Integer parsedYear = Integer.parseInt(yearString);
            if (parsedYear < 1900) {
                // 例如，抛出自定义业务异常
                throw new IllegalArgumentException("年份必须大于1900");
            }
            return parsedYear;
        } catch (NumberFormatException e) {
            // 理论上，如果 @Pattern 校验通过，这里不应该发生。
            // 但作为防御性编程，可以捕获并处理，以防万一。
            throw new IllegalArgumentException("年份格式无效，无法转换为数字", e);
        } catch (IllegalArgumentException e) {
            // 处理业务逻辑校验失败的情况
            throw e;
        }
    }

    // Setter for yearString
    public void setYearString(String yearString) {
        this.yearString = yearString;
    }

    // 通常还会有一个用于直接获取原始字符串的getter
    public String getYearString() {
        return yearString;
    }
}