您的标准Spring MVC应用程序将通过DispatcherServlet
您在Servlet容器中注册的来处理所有请求。
它DispatcherServlet
查看其ApplicationContext
(如果有的话)并向其ApplicationContext
注册以注册ContextLoaderListener
特殊豆,它需要设置其请求服务逻辑。这些bean在文档中进行了描述。
可以说是最重要的HandlerMapping
map类型的bean
根据某些条件向处理程序传入的请求以及一系列预处理程序和后处理程序(处理程序拦截器),具体标准因HandlerMapping
实现而异。最受欢迎的实现支持带注释的控制器,但也存在其他实现。
的javadocHandlerMapping
进一步描述了实现必须如何表现。
在DispatcherServlet
发现这种类型的所有豆类和以某种顺序将它们登记(可定制)。在处理请求时,DispatcherServlet
循环遍历这些HandlerMapping
对象并对其进行测试,getHandler
以找到可以处理传入请求的对象(表示为standard)HttpServletRequest
。从4.3.x版本开始,如果找不到任何内容,它将记录您看到的警告
没有找到映射与URI HTTP请求[/some/path]
中DispatcherServlet
使用的名字SomeName
并且要么抛出一个NoHandlerFoundException
或立即提交一个404 Not Found状态码的响应。
为什么DispatcherServlet
找不到HandlerMapping
可以处理我的请求的?
最常见的HandlerMapping
实现是RequestMappingHandlerMapping
,该实现将@Controller
Bean注册为处理程序(实际上是其带@RequestMapping
注释的方法)。您可以自己声明这种类型的bean(使用@Bean
或<bean>
或其他机制),也可以使用内置的options。这些是:
- 使用注释您的
@Configuration
班级@EnableWebMvc
。
<mvc:annotation-driven />
在您的XML配置中声明一个成员。
正如上面的链接所描述的,这两个都将注册一个RequestMappingHandlerMapping
bean(以及其他一些东西)。但是,如果HandlerMapping
没有处理程序,a并不是很有用。RequestMappingHandlerMapping
期望有一些@Controller
bean,因此您也需要通过@Bean
Java配置中的方法或<bean>
XML配置中的声明,或者通过@Controller
对任一类中带注释的类的组件扫描来声明它们。确保这些豆存在。
如果您收到警告消息和404,并且已经正确配置了上述所有内容,那么您会将请求发送到错误的URI,该错误未由检测到的带@RequestMapping
注释的处理程序方法处理。
该spring-webmvc
库提供了其他内置的HandlerMapping
实现。例如,BeanNameUrlHandlerMapping
地图
从URL到名称以斜杠(“ /”)开头的bean
而且您总是可以自己编写。显然,您必须确保要发送的请求至少与注册HandlerMapping
对象的处理程序之一匹配。
如果您没有隐式或显式注册任何HandlerMapping
bean(或detectAllHandlerMappings
is true
),则DispatcherServlet
注册一些defaults。这些DispatcherServlet.properties
在与DispatcherServlet
类相同的包中定义。它们是BeanNameUrlHandlerMapping
和DefaultAnnotationHandlerMapping
(类似于RequestMappingHandlerMapping
但已弃用)。
调试
Spring MVC将记录通过注册的处理程序RequestMappingHandlerMapping
。例如,@Controller
喜欢
@Controller
public class ExampleController {
@RequestMapping(path = "/example", method = RequestMethod.GET, headers = "X-Custom")
public String example() {
return "example-view-name";
}
}
将在INFO级别记录以下内容
Mapped "{[/example],methods=[GET],headers=[X-Custom]}" onto public java.lang.String com.spring.servlet.ExampleController.example()
这描述了注册的映射。当您看到未找到任何处理程序的警告时,请将消息中的URI与此处列出的映射进行比较。@RequestMapping
必需中指定的所有限制都必须匹配,Spring MVC才能选择处理程序。
其他HandlerMapping
实现记录他们自己的语句,这些语句应该提示它们的映射和相应的处理程序。
同样,在DEBUG级别启用Spring日志记录以查看Spring注册了哪些bean。它应该报告找到的带注释的类,扫描的包以及初始化的bean。如果没有您期望的ApplicationContext
配置,请检查您的配置。
其他常见错误
ADispatcherServlet
只是典型的Java EE Servlet
。你与你的典型进行注册<web.xml>
<servlet-class>
和<servlet-mapping>
申报,或直接通过ServletContext#addServlet
在一个WebApplicationInitializer
或与任何机构弹簧开机使用。因此,您必须依赖Servlet规范中指定的url映射逻辑,请参阅第12章。另请参见
考虑到这一点,一个常见的错误是DispatcherServlet
使用的url映射注册/*
,从@RequestMapping
处理程序方法返回视图名称,并期望呈现JSP。例如,考虑一个处理程序方法,例如
@RequestMapping(path = "/example", method = RequestMethod.GET)
public String example() {
return "example-view-name";
}
带着 InternalResourceViewResolver
@Bean
public InternalResourceViewResolver resolver() {
InternalResourceViewResolver vr = new InternalResourceViewResolver();
vr.setPrefix("/WEB-INF/jsps/");
vr.setSuffix(".jsp");
return vr;
}
您可能希望将请求转发到该路径处的JSP资源/WEB-INF/jsps/example-view-name.jsp
。这不会发生。相反,假设上下文名称为Example
,DisaptcherServlet
则将报告
没有映射发现HTTP请求的URI与[/Example/WEB-INF/jsps/example-view-name.jsp]
在DispatcherServlet
名为“调度”
由于DispatcherServlet
被映射到/*
与/*
匹配的一切(除了精确匹配,其具有更高的优先级),则DispatcherServlet
将被选择以处理forward
来自JstlView
(通过返回InternalResourceViewResolver
)。在几乎每种情况下,DispatcherServlet
都不会配置来处理此类请求。
相反,在这种简单的情况下,您应该将DispatcherServlet
to注册为/
,将其标记为默认servlet。默认servlet是请求的最后一个匹配项。这将允许您的典型servlet容器在尝试使用默认servlet之前,选择一个内部Servlet实现,该实现映射到*.jsp
,以处理JSP资源(例如Tomcat具有JspServlet
)。
这就是您在示例中看到的。