【Maven学习笔记】3：在Eclipse的Maven项目下pom.xml中添加Spring MVC的jar包构建项目

添加jar包

Maven的方便之处就在于不用手动下载依赖，只要在pom.xml中书写要用的jar包，就会连带它要使用的依赖一起下载。

---

在pom.xml文件中，<properties>标签内添加变量，用来保存后面要添加的jar包的版本：

<!-- 添加一个指示Spring版本的变量,在后面会引用到 -->
<springVersion>4.2.3.RELEASE</springVersion>

在<dependencies>标签内添加Spring MVC要使用的jar包，版本就使用前面定义的那个变量：

<!-- 添加springMVC的依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>${springVersion}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>${springVersion}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${springVersion}</version>
</dependency>

保存pom.xml文件，这时对于仓库中没有的依赖，Maven就会静默下载它们。下载好无误以后，这个pom.xml文件将不再报错，这时到之前配置的Maven仓库中可以看到各个jar包都下载好了，并且在仓库中在/groupId/artifactId/version/位置存储jar包：

即使版本写错了，似乎也会建立相应的文件夹，虽然里面的东西不过2KB，还是让强迫症比较难受。

书写代码

简述目录结构

Maven项目的约定目录结构和以前学的不太一样：

这里src/main/java/相当于之前学的src/目录，即写Java代码的地方；src/main/webapp/相当于之前学的WebContent/或是WebRoot/目录，即写网页相关代码和放置资源的地方。

比较方便的是，可以在工程的Java Resource这里直接操作这个目录，方便书写Java代码：

后面的src/test/java则是用来写测试代码的目录。

webapp/WEB-INF/web.xml

Maven构建的web项目，它的部署描述符文件默认是2.3版本的这个样子：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
</web-app>

换成3.0版本的，并添加Spring MVC的前端控制器：

<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    version="3.0">
    <display-name>HelloSpringMVC</display-name>

    <!-- Spring MVC的前端控制器 -->
    <servlet>
        <servlet-name>spring-mvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 设置前端控制器的路径,默认路径为/WEB-INF/[servlet-name]-servlet.xml -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-mvc-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!-- 拦截所有请求 -->
    <servlet-mapping>
        <servlet-name>spring-mvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

</web-app>

webapp/WEB-INF/spring-mvc-servlet.xml

这里是Spring MVC前端控制器的配置文件。

<?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:p="http://www.springframework.org/schema/p" 
    xmlns:context="http://www.springframework.org/schema/context" 
    xmlns:mvc="http://www.springframework.org/schema/mvc" 
    xmlns:task="http://www.springframework.org/schema/task"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd 
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-4.2.xsd 
        http://www.springframework.org/schema/mvc 
        http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd 
        http://www.springframework.org/schema/task 
        http://www.springframework.org/schema/task/spring-task-4.2.xsd">

    <!-- 扫描存控制器的包 -->
    <context:component-scan base-package="org.controller" >
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!-- 添加默认的基于注解的各项配置  -->
    <mvc:annotation-driven />

    <!-- 静态资源一般配置在/WEB-INF/assets/目录下,包括js,css,img等 -->
    <mvc:resources location="/assets/" mapping="/assets/**"></mvc:resources>

    <!-- 视图层配置,配置前缀和后缀,会和控制器的返回值组装成完整视图路径 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

java/org.controller.MyController类

这里提供一个控制器类，里面有一个写入一些欢迎信息到Model对象，并转发到某个JSP页面的方法：

package org.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/go")
public class MyController {

    @RequestMapping("/hello")
    // 传入要使用的参数(Model对象)
    public String SayHello(Model model) {
        // 将信息写进Model对象里,以在转发后页面上可见
        model.addAttribute("myMsg", "你好啊啊啊");

        // 最终会加上前缀和后缀组装成视图路径
        return "hello";
    }

}

webapp/WEB-INF/jsp/hello.jsp

即前缀是/WEB-INF/jsp/，控制器的返回值是hello，后缀是.jsp。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>跳转后的页面</title>
</head>
<body>
    <h3>用EL表达式语言从Model对象中获取信息：</h3>
    <br>
    <h3>${ myMsg }</h3>
</body>
</html>

webapp/index.jsp

这里是主页，在主页上提供一个访问刚刚设置的控制器方法的链接：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<body>
    <h2>测试使用Maven</h2>
    <a href="/testMvn/go/hello">去另一个页面</a>
</body>
</html>

最终的项目结构

配置运行

先移除多余的发布，右键项目->Properties：

暂时还不太明白这样做是为什么。它后面的从Maven依赖到WEB-INF/lib的发布即是项目能使用设置了依赖的Maven仓库中的jar包的关键。

---

部署到Tomcat，浏览器访问主页：

点击链接访问到控制器写入信息并跳转：