Tomcat 运行 Web 项目 Spring MVC 框架实例

在本文中，我们更近一步，利用 Tomcat 运行我们的 Web 项目。

如上图所示，我们进一步扩展了项目的结构，在java目录下新建了一系列的目录层级，并在annotation目录下建立一个名为AnnotationController的 Java 类，用于测试 Spring MVC 框架；在WEB-INF目录下，新建了一个pages目录，用于存放jsp页面，并新建了一个名为springmvc-servlet.xml的文件，用于书写 Spring MVC 框架的配置项。接下来，我们依次看看这些文件的内容：

控制类：AnnotationController

package com.hit.action.demo.annotation;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

/**
 * author:Charies Gavin
 * https:github.com/guobinhit
 */
@Controller
public class AnnotationController {

    // 请求映射地址 http://localhost:8080/gitcode/test，其中 8080 为默认端口
    @RequestMapping(value = "/test")
    public String goTest(HttpServletRequest request) {
        // 输出请求 URL 路径
        System.out.println(request.getRequestURL());
        // 返回逻辑名
        return "index";
    }
}

Spring MVC 配置文件：springmvc-servlet.xml

全局配置文件：web.xml

    
    
        contextConfigLocation
        /WEB-INF/springmvc-servlet.xml
    

    
    
        org.springframework.web.context.ContextLoaderListener
    

    
    
        springmvc
        org.springframework.web.servlet.DispatcherServlet

        
        
        
            contextConfigLocation
            /WEB-INF/springmvc-servlet.xml
        
        
        1
    
    
        springmvc
        
        /
    

    
    
        index.jsp
    

如上述代码以配置文件所示，我们对 Spring MVC 框架进行了简单的配置，其中有两点需要我们特别注意，分别是：

配置文件，如果不显示指定，则 Spring MVC 会自动扫描WEB-INF下以servlet-name标签声明的名称开头以servlet结尾的配置文件； 拦截请求，如果声明/*则会拦截所有请求，包括 action 返回的.jsp页面，因此一般声明/即可，可以防止请求重复拦截。

此外，因为我们这是 Maven 项目，自然不需要我们再手动导入jar啦，只需要在pom.xml文件中配置依赖即可：

    4.0.0

    com.hit
    gitcode
    1.0-SNAPSHOT
    war

    
        
            junit
            junit
            4.10
            test
        

        
            org.springframework
            spring-web
            RELEASE
        

        
            org.springframework
            spring-webmvc
            RELEASE
        
    

接下来，配置 Tomcat，运行 Web 项目：

如上图所示，依次对 Tomcat 进行配置，完成后，运行项目：

如上图所示，项目成功运行。在这里，很多同学可能会遇到如下错误：

造成上述错误的原因是jar包冲突，一般是servlet-api.jar和jsp-api.jar这个两个jar包冲突导致的。至于为什么会出现jar包冲突，很有可能是在写Controller的时候，需要导入javax.servlet.http.HttpServletRequest，这时看到项目中竟然没有引入该jar，自然是顺手就在pom.xml中添加了该jar的依赖，好吧，冲突种子就在这里种下啦！实际上，在 Tomcat 的lib目录中，已经包含上述两个jar包：

解决方法：如果是 Maven 项目，就删除pom.xml文件中对servlet-api.jar和jsp-api.jar的依赖；如果是非 Maven 项目，就手动排除这两个jar包。然后，进入 IntelliJ IDEA 的Project Structure -> Modules -> Dependencies配置页：

如上图所示，检查 Tomcat 是否引入；如果引入，则检查是否勾选 Tomcat 前的Export选项，实际上不勾选这个选项是正确的，勾选Export之后，会在项目启动后，将该 Tomcat 导出到本地仓库，从而导致两份 Tomcat，再次产生jar包冲突。除此之后，还要检查 JDK、Tomcat 以及 Maven 的版本，以防止版本不兼容的问题。如果还解决不了问题的话，呃，再检查检查 IntelliJ IDEA 的 Java 编译器的版本吧，囧！

---

温馨提示：上述的示例代码已上传至 GitHub 中的「gitcode」项目之中啦！