SpringMVC入门

• 介绍

　　本文主要介绍SpringMVC的入门知识，搭建一个可运行的 SpringMVC Hello Word 程序。使用到的技术有：SpringMVC, Maven, Log4j。之所以采用 Maven 是为了方便我们对项目的 jar 进行管理，我们只需要将项目所需要的 jar 的版本信息配置到 pom.xml 文件中，其他依赖的 jar Maven 会自动帮我们关联构建到项目中来。这里推荐一个我个人比较喜欢的 Maven 库 mvnrepository ，在这上面，我们可以找到大多数 jar 的 Maven 依赖信息。采用的 Log4j 也是目前使用比较广泛的日志记录工具，方便我们打印调试信息。开发环境：Eclipse，Tomcat6，JDK6。项目源代码

• 项目目录结构

　　

• 项目搭建

　　右键->New->Maven Project

　　

　　把“Create a simple project(skip archetype selection)”选项勾选上，创建一个简单的项目，点击 Next 继续。

　　

　　在 Group Id 和 Artifact Id 的输入框输入对应的内容，点击 Finish 完成 Maven 项目的创建。

　　

　　初步创建好的项目结构如下图所示：

　　

　　选择项目，右键选择 Properties 选项，进入项目属性设置页面。

　　

　　在项目属性窗口，选择 Resource 选项，设置项目编码，默认编码为GBK，设置为UTF-8，点击 Apply 应用到项目上，此步骤非常重要，采用UTF-8的编码，可以避免中文乱码带来的一系列问题。

　　

　　在项目属性窗口，选择 Java Build Path 选项，并切换到 Libraries 选项卡，检查项目使用的 JRE，如果不是 JRE6 ,可以先 Remove 旧的 JRE, 再把 JRE6 添加进来。

　　

　　

　　

　　

　　

　　在项目属性窗口，选择 Java Compiler 选项，把项目的编译级别调整为1.6。

　　

　　在项目属性窗口，选择 Project Facets 选项，点击 “Convert to faceted form...”，对项目进行进一步的配置，具体配置项的值，如下图所示：

　　

　　

　　项目右键-> Build Path -> Add Libraries...

　　

　　选择 Server Runtime , 添加 Tomcat 依赖库。

　　

　　

　　到目前位置，一个基本的 Maven 项目已经搭建好了，接下来我们需要把项目所需要的 jar 引进来。项目所需要的 jar 如下图所示：

　　

　　pom.xml 配置文件的详细信息如下（配置好 pom 文件后，可以更新项目的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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>springmvc_helloword</groupId>
    <artifactId>springmvc_helloword</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-expression</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>4.0.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>
</project>

　　在项目属性窗口，选择 Deployment Assembly 选项，点击右边的 Add 按钮，把 Maven 依赖 jar 添加进来，否则 Tomcat 启动时，不会把 Maven 依赖的 jar 编译到 lib 目录下，导致项目无法正常启动。

　　

　　

　　

　　

　　配置 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_2_5.xsd"
    id="WebApp_ID" version="2.5">
    <display-name>springmvc_helloword</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>

    <!-- 指定日志配置文件 -->
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>classpath:log4j.properties</param-value>
    </context-param>

    <!-- 配置日志Spring监听时间间隔， 单位为毫秒 -->
    <context-param>
        <param-name>log4jRefreshInterval</param-name>
        <param-value>60000</param-value>
    </context-param>

    <!-- 配置 Log4j 日志监听 -->
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>

    <!-- 配置 DispatcherServlet -->
    <servlet>
        <servlet-name>springDispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 配置 DispatcherServlet 初始化参数 -->
        <init-param>
            <!-- 配置 SpringMVC 配置文件的位置和名称 -->
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!-- 配置 DispatcherServlet 需要处理的 URL -->
    <servlet-mapping>
        <servlet-name>springDispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

　　配置 SpringMVC 配置文件 springmvc.xml

<?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: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.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">

    <!-- 配置自定义扫描的包 -->
    <context:component-scan base-package="rex.springmvc"></context:component-scan>

    <!--
        配置视图解析器，把 Handler 的返回值解析为实际的物理视图。
        InternalResourceViewResolver 通过  prefix + 返回值 + suffix 的方式得到实际的物理视图，
        并将处理结果转发给实际物理视图。
    -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>
</beans>

　　配置 log4j.properties

### 设置###
log4j.rootLogger = debug,stdout,D,E

### 输出信息到控制抬 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 输出DEBUG 级别以上的日志到=D://work/logs/log.log ###
log4j.appender.D = org.apache.log4j.FileAppender
log4j.appender.D.File = D://work/logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 输出ERROR 级别以上的日志到=D://work/logs/error.log  ###
log4j.appender.E = org.apache.log4j.FileAppender
log4j.appender.E.File =D://work/logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

　　创建一个简单的 handler 

package rex.springmvc.handlers;

import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWordHandler {
    private static final Logger logger = Logger.getLogger(HelloWordHandler.class);
    private static final String SUCCESS = "success";

    /**
     * 使用 RequestMapping 注解来映射请求
     * @return
     */
    @RequestMapping(value="/sayHello")
    public String sayHello(){
        logger.debug("Running in sayHello");
        return SUCCESS;
    }

}

　　创建 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>Hello SpringMVC</title>
</head>
<body>
    <a href="sayHello">Hello Word</a>
</body>
</html>

　　创建 success.jsp 页面，用于接收 handler 的处理结果，即物理视图。

<%@ 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>Hello Word Success Page</title>
</head>
<body>
    <h1>Hello Word Success Page</h1>
</body>
</html>

　　将项目部署到 Tomcat 并启动 Tomcat，然后在浏览器输入：http://localhost:8080/springmvc_helloword，项目能够正常访问，handler 也能正常触发，到此一个简单的 SpringMVC 的 Hello Word 就写好了。

 　　

　　

出处，知名博主：https://www.cnblogs.com/rexfang/p/6582469.html