package com.huimv.employment.config;

import com.huimv.employment.common.exception.BizException;
import com.huimv.employment.common.exception.ErrorCode;
import com.huimv.employment.common.web.R;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.validation.BindException;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

/**
 * 全局异常处理器。
 * <p>
 * 将所有 Controller 层抛出的异常统一转换为 {@link R} 格式的 JSON 响应，
 * 避免直接向客户端暴露堆栈信息。异常分类处理：
 * </p>
 * <ul>
 *   <li>{@link BizException} — 可预期业务错误，返回对应 code 和 msg</li>
 *   <li>参数校验异常 — 返回 400 + 第一个字段的错误提示</li>
 *   <li>JSON 解析失败 — 返回 400</li>
 *   <li>其他未捕获异常 — 返回 500，并记录完整堆栈到日志</li>
 * </ul>
 */
@RestControllerAdvice(basePackages = "com.huimv.employment.controller")
public class GlobalExceptionHandler {

    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    /** 业务异常：验证码错误、账号禁用、短信发送失败等 */
    @ExceptionHandler(BizException.class)
    public R<Void> handleBizException(BizException ex) {
        return R.fail(ex.getCode(), ex.getMessage());
    }

    /**
     * 参数校验失败（@Valid / @Validated 触发）。
     * 取第一个字段的错误 message 返回给前端。
     */
    @ExceptionHandler({MethodArgumentNotValidException.class, BindException.class})
    public R<Void> handleValidationException(Exception ex) {
        String message = ErrorCode.BAD_REQUEST.getMessage();
        if (ex instanceof MethodArgumentNotValidException) {
            MethodArgumentNotValidException validException = (MethodArgumentNotValidException) ex;
            if (validException.getBindingResult().getFieldError() != null) {
                message = validException.getBindingResult().getFieldError().getDefaultMessage();
            }
        } else if (ex instanceof BindException) {
            BindException bindException = (BindException) ex;
            if (bindException.getBindingResult().getFieldError() != null) {
                message = bindException.getBindingResult().getFieldError().getDefaultMessage();
            }
        }
        return R.fail(ErrorCode.BAD_REQUEST.getCode(), message);
    }

    /** 请求体 JSON 格式错误或字段类型不匹配 */
    @ExceptionHandler(HttpMessageNotReadableException.class)
    public R<Void> handleBadRequest(HttpMessageNotReadableException ex) {
        return R.fail(ErrorCode.BAD_REQUEST.getCode(), ErrorCode.BAD_REQUEST.getMessage());
    }

    /** 兜底：未预期的系统异常，记录日志但不暴露细节给客户端 */
    @ExceptionHandler(Exception.class)
    public R<Void> handleException(Exception ex) {
        log.error("Unhandled exception", ex);
        return R.fail(ErrorCode.INTERNAL_ERROR.getCode(), ErrorCode.INTERNAL_ERROR.getMessage());
    }
}
