Spring MVC框架下的第一个Hello World程序

本程序是一个maven程序，使用maven方便管理jar包和程序，简化了操作步骤。本程序的目的是通过一个简单的程序，了解Spring MVC框架的基本工作流程，由简入繁的学习Spring MVC框架，而不是直白无聊的理论知识堆积。

新建maven项目

这里写图片描述

新建的maven项目一般会报这个错误，错误的原因也很简单，右击项目–>Properties–>Java Build Path–>Libraries–>Add Library–>Server Runtime 选择一个服务器即可,点击Finish。此时项目应该不会报错，下图就是正常情况下的maven项目列表
这里写图片描述

配置各种xml

即便是使用注解的方式，xml这种配置文件也是少不了的，本项目中使用到的xml文件有三个：spring-mvc.xml、web.xml、pom.xml。
（1）spring-mvc.xml
这个是spring的核心配置文件代码如下：

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

    <!-- 自动扫描该包，使SpringMVC认为包下用了@controller注解的类是控制器，记得换成自己的包名 -->
    <context:component-scan base-package="com.cn.test.controller" />

    <!-- 定义跳转的文件的前后缀 ，视图模式配置-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 将action的方法setview（）return的字符串加上前缀和后缀，变成一个 可用的url地址 -->
        <property name="prefix" value="/html/" />
        <property name="suffix" value=".html" />
     </bean>
   </beans>

（2）pom.xml文件，这个是maven的配置文件，最主要的作用就是通过相关配置自动引入我们所需要的jar包，代码如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.cn.EPhotoAlbum</groupId>
  <artifactId>EPhotoAlbum</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>EPhotoAlbum Maven Webapp</name>
  <url>http://maven.apache.org</url>
   <properties>
        <!-- spring版本号 -->
        <spring.version>4.0.2.RELEASE</spring.version>
        <!-- mybatis版本号 -->
        <mybatis.version>3.2.6</mybatis.version>
        <!-- log4j日志文件管理包版本 -->
        <slf4j.version>1.7.7</slf4j.version>
        <log4j.version>1.2.17</log4j.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
        <!-- spring核心包 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-oxm</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-tx</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${spring.version}</version>
        </dependency>
        <!-- mybatis核心包 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>${mybatis.version}</version>
        </dependency>
        <!-- mybatis/spring包 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.2.2</version>
        </dependency>
        <!-- 导入java ee jar 包 -->
        <dependency>
            <groupId>javax</groupId>
            <artifactId>javaee-api</artifactId>
            <version>7.0</version>
        </dependency>

        <!-- 导入dbcp的jar包，用来在applicationContext.xml中配置数据库 -->
        <dependency>
            <groupId>commons-dbcp</groupId>
            <artifactId>commons-dbcp</artifactId>
            <version>1.2.2</version>
        </dependency>
        <!-- JSTL标签类 -->
        <dependency>
            <groupId>jstl</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
        <!-- 日志文件管理包 -->
        <!-- log start -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>${log4j.version}</version>
        </dependency>
        <!-- 映入JSON -->
        <dependency>
            <groupId>org.codehaus.jackson</groupId>
            <artifactId>jackson-mapper-asl</artifactId>
            <version>1.9.13</version>
        </dependency>

    </dependencies>
  <build>
    <finalName>test</finalName>
  </build>
</project>

（3）web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">

    <!-- 配置DispatchcerServlet -->
    <servlet>
        <servlet-name>springDispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 配置Spring mvc下的配置文件的位置和名称 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>springDispatcherServlet</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
    <!-- 编码过滤器 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <async-supported>true</async-supported>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

创建Controller

controller文件的一个标志就是在类的前面有一个@Controller的注解，我们创建这些类的时候，可以先创建一个普通的类，然后在类中的类名前面加上@Controller，如下图所示：

这里写图片描述

此外在SSM框架中的service层和dao层都有它们各自的标志性注解（当然现在已经不分的那么清楚了），如service层的@Service，dao层的@Repository，这些注解将会在以后的博文中进行介绍。
从上图中我们也可以看到，紧接着@Controller的是@RequestMapping(value=”/test”)，这个注解的作用就是给我们的类标注一个访问地址，如果它出现在一个方法的前面，那就是给一个方法添加一个访问地址（访问时记得带上它所在类的访问地址）。
controller中的方法可以有三种返回类型ModelAndView、String和void，这几种方法都是经常使用到的。
（1）返回ModelAndView
ModelAndView，里面包含着model和view（名字起的就是这个直白），他是一个比较复杂的类，但是构造函数就有7个，今天我们只做hello world 所以就不详细讲解了，不过现在你可以将它理解为一个大容器，里面可以放许多你想要向前台传递的东西。

@Controller
@RequestMapping(value="/test")
public class UserController {
    public ModelAndView user(){
        //新建一个ModelAndView 
        ModelAndView mv = new ModelAndView();
        //返回的html页面的名字，对应配置文件
        mv.setViewName("hello");
        return mv;
    }
}

上述代码中，我们可以使用mv.setViewName(“hello”)，这个方法指定我们想要返回的页面。
（2）返回String

public String userString(){
        //在这里直接返回我们想要返回的页面名称
        return "hello";
    }

在return中就可以直接返回我们想要返回的页面。
（3）返回void
这个最直接，就是在这个方法执行完之后，什么都不返回，但我们任然可以做一些操作。

public void userVoid(){
        ModelAndView mv = new ModelAndView();
        //返回的html页面的名字，对应配置文件
        mv.setViewName("hello");
    }

我写的上述三个方法的作用都是将页面转到一个名叫“hello.html”的页面。为了方便以后的学习我们可以使用第一中方法。注意在方法上面追加了一个注解用于访问时作为访问路径。

@RequestMapping(value="/user")
    public ModelAndView user(){
    ModelAndView mv = new ModelAndView();
        //返回的html页面的名字，对应配置文件
        mv.setViewName("hello");
        return mv;
    }

创建html文件

在上面我们提到的hello.html文件将会在这里创建，首先我们在src–>webapp下面新建一个html文件夹，方便存放html文件，然后在html文件夹下面新建一个名叫hello.html的html文件，代码如下：

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>第一个springmvc项目</title>
</head>
<body>
<h1>Hello World!!!</h1>
</body>
</html>

就是这个简单，因为是刚刚学习，太复杂的话容易报错，从而降低我们的学习热情。
接下来就是我们新建项目的时候自动生成的index.jsp文件，它的作用只是点击之后就会转向hello页面，当然是通过controller跳转的。
index.jsp代码

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<html>
<body>
<a href="/test/test/user.do">点我就变</a>
</body>
</html>