小结:Spring MVC 的 XML 的经典配置方式
在 Spring MVC 的基于 XML 的经典配置方式,如何让某个请求 URL 映射到 HelloController
的具体方法,是通过配置 HandlerMapping
来完成的
方式一:使用 BeanNameUrlHandlerMapping
(推荐 XML 配置方式)
1. 修改 HelloController
,为它指定一个 bean 名称(URL 映射路径)
// HelloController.java
public class HelloController implements Controller {public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {ModelAndView mv = new ModelAndView("hello");mv.addObject("msg", "Hello XML Controller");return mv;}
}
1.1 在 spring-servlet.xml
中配置 Controller bean 和 URL 映射
<!-- spring-servlet.xml -->
<context:component-scan base-package="com.example"/><!-- 配置 Controller bean -->
<bean id="/hello.htm" class="com.example.HelloController"/><!-- 配置 HandlerMapping -->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/><!-- 配置 ViewResolver -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/jsp/"/><property name="suffix" value=".jsp"/>
</bean>
🔍 效果说明:
- 当访问:
http://localhost:8080/your-app/hello.htm
- 就会调用
HelloController
的handleRequest
方法。 BeanNameUrlHandlerMapping
会将 bean 的id
视为 URL 路径进行匹配。
方式二:使用 SimpleUrlHandlerMapping
(更灵活的 URL 映射)
你也可以使用更显式的 URL 映射方式:
<bean id="helloController" class="com.example.HelloController"/><bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"><property name="mappings"><props><prop key="/hello.htm">helloController</prop></props></property>
</bean>
这种方式允许你将多个 URL 映射到不同的 Controller bean,结构更清晰。
方式三:使用注解(虽然你用的是 XML,但可以混合使用)
如果你希望使用 @RequestMapping
注解,也可以启用注解驱动(即使你用的是 XML 配置):
<mvc:annotation-driven />
<context:component-scan base-package="com.example"/>
然后修改 Controller:
@Controller
public class HelloController {@RequestMapping("/hello")public String sayHello(Model model) {model.addAttribute("msg", "Hello XML + Annotation Controller");return "hello"; // 映射到 /WEB-INF/jsp/hello.jsp}
}
这样你就可以通过 /hello
访问这个方法。
✅ 五、总结
方式 | 配置方式 | 特点 |
---|---|---|
BeanNameUrlHandlerMapping | XML | bean 的 id 就是 URL |
SimpleUrlHandlerMapping | XML | 更灵活,支持多个 URL 到 bean 的映射 |
注解 @RequestMapping + `` | XML + 注解 | 更现代,更简洁,推荐使用 |
🧩 示例:完整 spring-servlet.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context"xmlns:mvc="http://www.springframework.org/schema/mvc"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsd"><!-- 扫描 Controller --><context:component-scan base-package="com.example"/><!-- 启用注解驱动(可选) --><mvc:annotation-driven /><!-- 显式配置 Controller 和 URL 映射 --><bean id="/hello.htm" class="com.example.HelloController"/><!-- 使用 BeanNameUrlHandlerMapping --><bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/><!-- 或者使用 SimpleUrlHandlerMapping --><!--<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"><property name="mappings"><props><prop key="/hello.htm">helloController</prop></props></property></bean>--><!-- ViewResolver --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/jsp/"/><property name="suffix" value=".jsp"/></bean></beans>
在 Spring MVC 的经典 XML 配置方式中,如果你使用的是 传统的 Controller
接口(即 org.springframework.web.servlet.mvc.Controller
),那么:
❌ 不能直接为 HelloController
添加多个方法并分别映射到不同的 URL。
原因:
你当前的 HelloController
是这样定义的:
public class HelloController implements Controller {public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {...}
}
- 它实现了 Spring MVC 的
Controller
接口,该接口 只有一个方法:handleRequest()
。 - Spring MVC 会把整个类当作一个控制器,所有的请求都只会调用
handleRequest()
方法。 - 所以,即使你添加了多个方法,也无法通过 URL 映射到不同的方法上。
✅ 如何实现一个 Controller 多个方法?
✅ 方法一:使用 MultiActionController
(Spring 3.x 及以前支持)
这是 Spring 提供的一个旧版控制器类,允许你在同一个控制器中有多个处理方法。
示例:
public class HelloController extends MultiActionController {public ModelAndView sayHello(HttpServletRequest request, HttpServletResponse response) {ModelAndView mv = new ModelAndView("hello");mv.addObject("msg", "Hello from sayHello");return mv;}public ModelAndView sayHi(HttpServletRequest request, HttpServletResponse response) {ModelAndView mv = new ModelAndView("hello");mv.addObject("msg", "Hello from sayHi");return mv;}
}
XML 配置 URL 映射:
<bean name="/hello/*.htm" class="com.example.HelloController"><property name="methodNameResolver"><bean class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver"><property name="mappings"><props><prop key="/hello/sayHello.htm">sayHello</prop><prop key="/hello/sayHi.htm">sayHi</prop></props></property></bean></property>
</bean>
访问地址:
/hello/sayHello.htm
→sayHello()
方法/hello/sayHi.htm
→sayHi()
方法
⚠️ 注意:
MultiActionController
在 Spring 3.2 以后已被弃用(不推荐使用),建议使用基于注解的方式。
✅ 方法二:使用注解驱动(推荐)
如果你希望一个 Controller 有多个方法,并且每个方法映射不同的 URL,最推荐的方式是使用:
@Controller
@RequestMapping
示例:
@Controller
public class HelloController {@RequestMapping("/hello")public String sayHello(Model model) {model.addAttribute("msg", "Hello from sayHello");return "hello";}@RequestMapping("/hi")public String sayHi(Model model) {model.addAttribute("msg", "Hello from sayHi");return "hello";}
}
XML 中启用注解支持:
<context:component-scan base-package="com.example"/>
<mvc:annotation-driven />
访问地址:
/your-app/hello
→sayHello()
/your-app/hi
→sayHi()
✅ 方法三:混合使用 XML 和多个 Controller
如果你坚持使用 XML 配置方式,但又想支持多个方法,可以:
- 创建多个
Controller
类(每个类实现Controller
接口) - 每个类对应一个 URL
- 在 XML 中分别为它们配置 URL 映射
示例:
// HelloController.java
public class HelloController implements Controller {public ModelAndView handleRequest(...) {...}
}// HiController.java
public class HiController implements Controller {public ModelAndView handleRequest(...) {...}
}
XML 配置:
<bean id="/hello.htm" class="com.example.HelloController"/>
<bean id="/hi.htm" class="com.example.HiController"/><bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>