JavaController – JavaWeb框架的控制中心

一、默认作用域

JavaController是一个基于MVC架构的JavaWeb框架，它的默认作用域是request，这意味着，每一个请求都会创建一个新的JavaController实例，并在该请求处理完成后销毁。

同时，JavaController支持其他的作用域，如session和singleton，但需要在Controller类上进行标注。

@Controller
@SessionScope // 标注该Controller为session作用域
public class UserController {
    // ...
}

二、路由映射

JavaController支持通过@RequestMapping注解进行路由映射，该注解可以作用于类和方法上，使得请求可以被正确地分发到指定的Controller和方法中。

同时，@PathVariable注解也被广泛应用于JavaController中，可以在路由中包含参数，以便获得更多的请求信息。

@Controller
@RequestMapping("/users")
public class UserController {
    @GetMapping("/{id}")
    public String getUserById(@PathVariable Long id, Model model) {
        // ...
        return "user";
    }
}

三、模型绑定

JavaController支持将请求的参数自动绑定到Controller方法的参数上，以及支持通过Model对象向View层传递数据。

使用@RequestParam注解可以指定请求参数名和请求参数类型，同时支持默认值和必须性校验。

@Controller
@RequestMapping("/users")
public class UserController {
    @PostMapping("/")
    public String createUser(@RequestParam String username, 
                             @RequestParam(required = false, defaultValue = "18") Integer age,
                             Model model) {
        // ...
        model.addAttribute("user", newUser);
        return "userCreated";
    }
}

四、拦截器

JavaController支持拦截器，通过实现HandlerInterceptor接口可以实现在请求前、请求后和之后的视图渲染过程中执行特定的逻辑。

拦截器可以实现权限控制、日志记录等通用的逻辑，同时也非常适合对请求进行性能监控和统计。

public class LoggingInterceptor implements HandlerInterceptor {
    private static final Logger LOGGER = LoggerFactory.getLogger(LoggingInterceptor.class);
    
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        LOGGER.info("Received a request: {}, {}", request.getMethod(), request.getRequestURI());
        return true;
    }
    
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView) throws Exception {
        // ...
    }
    
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex) throws Exception {
        // ...
    }
}

五、异常处理

JavaController支持通过@ControllerAdvice注解的异常处理器来处理Controller中抛出的异常，同时也非常适合集中处理通用异常、进行日志记录等操作。

可以通过@ExceptionHandler注解指定处理特定异常类型的逻辑。

@ControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);
    
    @ExceptionHandler(BusinessException.class)
    public ResponseEntity handleBusinessException(HttpServletRequest request, BusinessException ex) {
        ResultModel result = new ResultModel(ResultStatus.FAILURE);
        result.setMessage(ex.getMessage());
        LOGGER.error("Failed to handle the request: {}", request.getRequestURI(), ex);
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(result);
    }
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity handleUnexpectedException(HttpServletRequest request, Exception ex) {
        ResultModel result = new ResultModel(ResultStatus.FAILURE);
        LOGGER.error("Failed to handle the request: {}", request.getRequestURI(), ex);
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(result);
    }
}