如何从零开发JavaWeb框架？手把手教你搭建企业级轻量框架

核心模块实现

1. 请求处理中枢：Dispatcher
   这是框架的大脑，负责协调整个请求生命周期,它通常是一个单例或由Servlet初始化。

   • 初始化：在Servlet的init()方法中，Dispatcher进行关键初始化：
     • 扫描包路径：根据配置扫描指定的基础包（如com.example.controller），自动发现带有特定注解（如@Controller）的类。
     • 构建路由映射表：解析控制器类和方法上的路由注解（如@RequestMapping("/user"),@GetMapping("/{id}")），将URL模式、HTTP方法与对应的控制器方法建立映射关系，存储在内存（如Map<String,HandlerMapping>）中。
     • 初始化组件：创建或配置视图解析器、依赖注入容器（如果需要）等核心组件。
   publicclassDispatcher{privateMap<RequestKey,HandlerExecutionChain>handlerMappings=newHashMap<>();privateList<HandlerInterceptor>interceptors=newArrayList<>();privateViewResolverviewResolver;publicvoidinit(StringscanBasePackage){//1.使用反射工具（如ClassGraph）扫描scanBasePackage下的类//2.遍历类，查找@Controller注解//3.遍历Controller类的方法，查找@RequestMapping,@GetMapping等注解//4.解析注解值，构建RequestKey(包含method和pathPattern)和HandlerExecutionChain(包含目标方法、拦截器链)//5.将映射关系存入handlerMappings//6.初始化ViewResolver(e.g.,InternalResourceViewResolver)//7.初始化/加载拦截器(可选)}}

2. 路由映射与执行链：HandlerMapping&HandlerExecutionChain

   • RequestKey:封装HTTP请求方法（GET,POST等）和请求路径模式（如“/user/{id}”）,用于精确匹配请求。
   • HandlerMethod:封装最终要执行的目标控制器方法（java.lang.reflect.Method）及其所属的控制器实例。
   • HandlerExecutionChain:组合HandlerMethod和应用于该请求的HandlerInterceptor（拦截器）列表，它负责按顺序执行拦截器的前置处理、调用目标方法、执行拦截器的后置处理。
   publicclassHandlerExecutionChain{privatefinalHandlerMethodhandlerMethod;privatefinalList<HandlerInterceptor>interceptors;publicbooleanapplyPreHandle(HttpServletRequestrequest,HttpServletResponseresponse)throwsException{//顺序执行所有拦截器的preHandle方法//如果某个拦截器返回false，则中断执行链}publicvoidapplyPostHandle(HttpServletRequestrequest,HttpServletResponseresponse,ModelAndViewmav)throwsException{//逆序执行所有拦截器的postHandle方法}publicvoidtriggerAfterCompletion(HttpServletRequestrequest,HttpServletResponseresponse,Exceptionex)throwsException{//逆序执行所有拦截器的afterCompletion方法}publicModelAndViewhandle(HttpServletRequestrequest,HttpServletResponseresponse)throwsException{//核心：反射调用handlerMethod.invoke(controllerInstance,...)//需要处理参数绑定（见下文）//返回ModelAndView或直接写入Response}}

3. 参数绑定：HandlerMethodArgumentResolver
   控制器方法通常需要参数（如HttpServletRequest,@PathVariable,@RequestParam,@RequestBody），参数解析器负责将HTTP请求中的数据（路径变量、查询参数、表单数据、JSON体等）转换成方法参数需要的类型。

   • 定义接口： publicinterfaceHandlerMethodArgumentResolver{booleansupportsParameter(MethodParameterparameter);//判断是否支持该参数类型ObjectresolveArgument(MethodParameterparameter,HttpServletRequestrequest,HttpServletResponseresponse)throwsException;//解析参数值}
   • 常见实现：
     • RequestParamArgumentResolver:处理@RequestParam("name")Stringusername
     • PathVariableArgumentResolver:处理@PathVariable("id")LonguserId
     • RequestResponseBodyArgumentResolver:处理@RequestBodyUseruser(需要集成JSON库如Jackson/Gson)
     • ServletRequestArgumentResolver:处理HttpServletRequestrequest
     • ModelArgumentResolver:处理Modelmodel(用于向视图传递数据)
   • Dispatcher维护一个List<HandlerMethodArgumentResolver>，在执行HandlerMethod前，遍历解析器列表，找到支持的解析器来为每个参数赋值。

4. 视图解析：ViewResolver
   处理控制器方法返回的视图名称（如"user/list"），解析成具体的View对象（如JstlView），用于最终渲染输出（通常是JSP、Thymeleaf模板等）。

   publicinterfaceViewResolver{ViewresolveViewName(StringviewName,Localelocale)throwsException;}publicclassInternalResourceViewResolverimplementsViewResolver{privateStringprefix="/WEB-INF/views/";privateStringsuffix=".jsp";@OverridepublicViewresolveViewName(StringviewName,Localelocale){returnnewInternalResourceView(prefix+viewName+suffix);}}publicclassInternalResourceViewimplementsView{privateStringurl;publicInternalResourceView(Stringurl){this.url=url;}@Overridepublicvoidrender(Map<String,?>model,HttpServletRequestrequest,HttpServletResponseresponse)throwsException{//将model数据设置到request属性域for(Map.Entry<String,?>entry:model.entrySet()){request.setAttribute(entry.getKey(),entry.getValue());}//转发到JSP页面RequestDispatcherdispatcher=request.getRequestDispatcher(url);dispatcher.forward(request,response);}}

5. 依赖管理（简易版）：ApplicationContext
   要实现控制器等组件的自动注入（如@Autowired），需要一个简单的IoC容器，这是一个更高级的特性，核心是管理Bean的生命周期和依赖关系,简易实现可以：

   • 在扫描阶段，也识别@Component,@Service等注解的类。
   • 使用反射创建这些类的单例实例，并存储在一个Map(BeanFactory)中。
   • 在创建控制器实例时（或在HandlerMethod调用前），检查其字段或构造方法上的@Autowired注解，从BeanFactory中查找对应的Bean并注入。

流程串联：FrameworkServlet.service()