创建一个可用的简单的SpringMVC项目，图文并茂

2022-05-02 23:57:42

转载请带上链接：http://www.cnblogs.com/silentdoer/articles/7134332.html。

最近在自学SpringMVC，百度了很多资料都是比较老的，而且里面很多都不能用，后来自己多方对比后终于弄出来了一个，在这里记录以及跟同是新手的你分享下。

首先说下我用的各种环境：

Windows10系统

SpringMVC用的是目前最新的4.3.4版本；

tomcat用的是8.0.45版本（大家可以下8.5的或更高版本的，我的是压缩包而非安装程序，个人觉得用压缩包更方便）；

JDK和JRE用的是1.8的；

IDE用的是Eclipse neon.2；

好了，搭建环境就自己弄下吧（比如安装JDK[和配置PATH之类的]和安装Eclipse[注意JDK如果是64位的Eclipse也必须是64位的]和下载tomcat和下载SpringMVC的jar包及设置Eclipse的工作区间），

接下来我会通过图片和文字的方式详细的给出创建一个简单的SpringMVC项目的步骤。

1、打开Eclipse，点击左上角File-New-Dynamic Web Project，如图：

2、弹出窗口：

Project name可以改成自己的项目名，图中用蓝笔画了的大家注意检查一下是不是一样（Tomcat可以是你们自己的版本，但是最好比8.0要高，而其它的就先按图中的来吧）；

接下来点击Next，弹出窗口：

然后将上图中的build\classes改成WebRoot\WEB-INF\classes，注意这里不改也行，但是为了和MyEclipse项目结构一致最好还是改下（而且个人觉得MyEclipse创建的Dynamic Web Project的项目结构更合理和易理解）；

点击Next弹出窗口：

注意，如果上一步改成了WebRoot\WEB-INF\classes则这一步就最最好将Content directory改成WebRoot（原先是WebContent），然后将蓝色圈中的勾打上，点击Finish。

2、进行完上面的步骤后得到项目结构如下图：

对着Java Resources下的src点击右键New-Package，弹出框如图：

写好Name后点击Finish。

然后对WEB-INF右键New-Folder，弹出如图：

点击Finish，（可忽略 ---> 注意，一般除主页以外的动态页面都是要放在WEB-INF文件夹内的（一般是WEB-INF的子文件夹里，用于分类，如我这里就是在子文件夹jsp中）。

此时项目的结构是：

3、将项目所需的SpringMVC包添加到项目中，步骤是先复制所有SpringMVC4.3.4版本的jar，然后对WEB-INF文件夹下的lib文件夹右键-粘贴（或Ctrl+v）即可（添加jar包到项目里据说有三种方法，我这里用最简单的方法添加），如图：

其实这个项目是不需要加入这么多jar包的，但是我懒得去测试哪些要哪些不要就都复制进去了（测试的方法可以是边删边运行，直到删到不能删为止）。

4、接下来对silentdoer.web.controller右键，New-Class新建一个类名为HelloWorldController，如图：

点击Finish后改写HelloWorldController.java的代码为：

package silentdoer.web.controller;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.ui.Model;

// 这里我写的注释要结合springmvc.xml里面的配置和index.jsp里面的内容一起看才容易理解

@Controller

public class HelloWorldController {

    // RequestMapping中的hello是要客户端请求时所映射的字符串（个人的理解，暂时找不到更好的说法），而helloWorld函数则是处理该映射

    @RequestMapping("/hello")

    public String helloWorld(Model model) {  // 通过Model对象可以将数据返回给动态页面/前端页面（由服务器处理）

        String viewArgValue = "Hello World, SpringMVC";

        model.addAttribute("message", viewArgValue);  // 这里的message就是动态页面中的参数名，即hello.jsp页面中${message}中的message，viewArgValue是参数值

        // 返回WEB-INF/jsp/hello.jsp文件给客户端（是经过服务端处理的），因为我们springmvc.xml里配置了prefix和suffix故这里前缀+逻辑视图名+后缀就得到了要返回文件的完整路径

        // 这里顺便说一下WEB-INF下的资源是客户端无法直接访问到的

        return "/hello";

    }

}

接下来配置web.xml文件，将其更改为：

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee"

    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"

    id="WebApp_ID" version="3.1">

    <display-name>FirstSpringMVCProj</display-name>

    <servlet>

        <servlet-name>springmvc</servlet-name>

        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <init-param>

            <param-name>contextConfigLocation</param-name>

            <!-- 设置SpringMVC配置文件的位置，注意该位置默认是src文件夹下 -->

            <param-value>classpath:springmvc.xml</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>springmvc</servlet-name>

        <!-- 据说是拦截所有静态文件的请求，如.js；.css文件等 -->

        <url-pattern>/</url-pattern>

    </servlet-mapping>

    <!-- 设置默认页面，注意这个页面是直接在WebRoot文件夹下的，如果是在WebRoot下的view文件夹下就要配置成view\index.jsp，但是默认页面不要放在WEB-INF内 -->

    <welcome-file-list>

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

    </welcome-file-list>

</web-app>

接下来在src下新建springmvc.xml文件，右键src文件夹New-Other，输入XML找到XML类型文件，如图：

点击Next，将名字改为springmvc.xml后点击Finish。

将springmvc.xml里面的配置改为：

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

    xmlns:tx="http://www.springframework.org/schema/tx"

    xmlns:context="http://www.springframework.org/schema/context"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

                                      http://www.springframework.org/schema/beans/spring-beans.xsd

                                      http://www.springframework.org/schema/context

                                      http://www.springframework.org/schema/context/spring-context.xsd">

                                      <!-- 注意上面的也可以写成spring-context-4.3.xsd，如果不写则默认是用当前的版本 -->

    <!-- 注意这里的base-package的值就是HelloWorldController.java所在的包名 -->

    <context:component-scan base-package="silentdoer.web.controller" />

    <!-- 注意prefix前后的/不要漏了，WebRoot类似是根目录 -->

    <bean id="viewResolver"

        class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix" value="/WEB-INF/jsp/" />

        <property name="suffix" value=".jsp" />

    </bean>

</beans>

接下来在jsp文件夹下新建一个JSP File，改名为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>Insert title here</title>

</head>

<body>

    <p>This is my message: ${message}</p>

</body>

</html>

然后对着WebRoot文件夹新建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>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title>Insert title here</title>

</head>

<body>

    <a href="hello.html">Hello World</a>

</body>

</html>

现在的项目结构如下：