[Spring实战系列] - No.5 SpringMVC+Maven+Tomcat构建实例

69 阅读 0 评论 46 点赞

我是靠谱客的博主机智手链，最近开发中收集的这篇文章主要介绍[Spring实战系列] - No.5 SpringMVC+Maven+Tomcat构建实例，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

本篇文章，我们开始讲解关于SpringMVC框架的内容。在此之前应该还有关于企业级Spring的一些内容，我决定放在后边讲解，或者如果在Spring boot中有较好的替代方案，我会直接讲解Spring boot。在本文中，我会给大家展示什么是SpringMVC以及使用我们的intellij构建一个Spring MVC的实例。

1.什么是SpringMVC框架呢？简单的说，就是我们在使用Spring编写web项目时，使用MVC的架构。MVC框架大家应该并不陌生。写过java的朋友应该都用过例如struts之类的框架。MVC顾名思义由三部分组成：M代表model，V代表view，C代表controller。

这就是我们的SpringMVC在处理一个请求时候的过程。DispatcherServlet会收集所有的请求，然后进行分发给各个Controller。Controller进行映射以后，返回相应的视图。这就是最简单的一个处理过程。SpringMVC的内容还有很多很多，在这里我们来试着做一个最简单的MVC项目感受一下。

2.什么是maven？

在我们写java项目的时候，经常遇到的问题就是，我们需要手动导入一些jar包。如果我们的项目迁移或者运行环境改变，必须要做出相应的改变，否则我们的项目依然会无法正常运行。所以，我们需要一个项目管理工具。我只需要告诉他我需要哪些依赖，如果他能够按照我给的清单来每次都为我配置/下载依赖，会不会很方便呢？项目管理的工具很多，在这里，我们使用maven。intellij中自带maven。

3.创建一个我们的SpringMVC项目：

首先，在你的intellij中，新建一个Maven项目(为了方便配置maven，这里我们没有算则springMVC项目)：

点击Next，填写GroupId和ArtifactId

点击Next 填写相关信息

然后Next，填写项目名称。Finish！

接下来，我们要设置我们的项目结构。最后项目结构如图所示：

在main下设置java文件夹，并且按照如图结构布置文件夹。注意，此时我们在java文件夹下面不能新建包和Java类。我们需要设置java文件为Source 文件夹。设置方法为：点击左上角File，点击Project Structure 如图所示：

同理，设置resources为资源文件夹。

接下来要配置我们的pom.xml这个XML文件主要的目的就是我们所需要的依赖清单以及一些相关的配置。

<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.example</groupId>
  <artifactId>maven-springmvc</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>maven-springmvc Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <!--日志包-->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.21</version>
    </dependency>

    <!--j2ee相关包 servlet、jsp、jstl-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.2</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>

    <!--mysql驱动包-->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.35</version>
    </dependency>

    <!--spring相关包-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>

    <!--其他需要的包-->
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-lang3</artifactId>
      <version>3.4</version>
    </dependency>
  
  </dependencies>
  <build>
    <finalName>maven-springmvc</finalName>
    <resources>
      <!--表示把java目录下的有关xml文件,properties文件编译/打包的时候放在resource目录下-->
      <resource>
        <directory>${basedir}/src/main/java</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
        </includes>
      </resource>
      <resource>
        <directory>${basedir}/src/main/resources</directory>
      </resource>
    </resources>
  </build>
</project>

由于maven版本问题，某些朋友的maven自动生成的maven pom.xml可能会出现无法识别某些子节点的问题。建议

直接复制我的pom.xml。

接下来，如图所示点击你的maven project 的更新的按钮。

如果你的intellij界面上(默认在右边)没有maven project，你可以在view-tool button中将其打开。这样，maven就

会开始下载你的依赖。另外，如何找到版本稳定的依赖呢？可以登陆maven仓库，然后搜索你需要的以来，点击查看，

在下面会生成相应的以来code。具体操作很简单，在这里不展示了。至此，maven部分的以来就部署完了。我们开始

配置我们的Spring文件。在这里，我们依然采用的是web.xml的配置方式

1.web.xml

<?xml version="1.0" encoding="UTF-8"?>
<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">
  <!--welcome pages-->
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>

  <!--配置springmvc DispatcherServlet-->
  <servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <!--Sources标注的文件夹下需要新建一个spring文件夹-->
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring/spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
    <async-supported>true</async-supported>
  </servlet>
  <servlet-mapping>
    <servlet-name>springMVC</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

下面，我们来讲解一下我们的代码。<welcome-file-list>标签，定义了我们的主页的位置。当我们项目部署完成后，在浏览器输入http：//localhost:8080，会自动跳转到一个欢迎页面，就是在这里设置的。我们定义了一个servlet，名叫springMVC，也就是我们之前讲到的DispatcherServlet。接下来，我们定义了一个contextConfiguration的变量，代表我们将这个servlet配置内容放置在了spring文件夹下的spring-mvc.xml中了。接下来我们就转到spring-mvc.xml。配置我们的servlet。

<?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-3.2.xsd
                         http://www.springframework.org/schema/context
                        http://www.springframework.org/schema/context/spring-context-3.2.xsd
                        http://www.springframework.org/schema/mvc
                        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--启用spring的一些annotation -->
    <context:annotation-config/>

    <!-- 自动扫描该包，使SpringMVC认为包下用了@controller注解的类是控制器 -->
    <context:component-scan base-package="com.example.controller">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!--HandlerMapping 无需配置，springmvc可以默认启动-->

    <!--静态资源映射-->
    <!--本项目把静态资源放在了WEB-INF的statics目录下，资源映射如下-->
    <mvc:resources mapping="/css/**" location="/WEB-INF/static/css/"/>
    <mvc:resources mapping="/js/**" location="/WEB-INF/static/js/"/>
    <mvc:resources mapping="/image/**" location="/WEB-INF/static/image/"/>

    <mvc:annotation-driven/>

    <!-- 对模型视图名称的解析，即在模型视图名称添加前后缀(如果最后一个还是表示文件夹,则最后的斜杠不要漏了) 使用JSP-->
    <!-- 默认的视图解析器 在上边的解析错误时使用 (默认使用html)- -->
    <bean id="defaultViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/view/"/><!--设置JSP文件的目录位置-->
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- springmvc文件上传需要配置的节点-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize" value="20971500"/>
        <property name="defaultEncoding" value="UTF-8"/>
        <property name="resolveLazily" value="true"/>
    </bean>
</beans>

Spring配置文件的部分到此结束。接下来，我们来构建我们的MVC部分。

在Spring中新建HomeController，来作为一个简单的Controller:

package com.example.controller;


import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Created by YanMing on 2017/2/24.
 */

@Controller
public class HomeController {
    private static final Logger logger = LoggerFactory.getLogger(HomeController.class);

    @RequestMapping("/hello")
    public String hello(){
        logger.info("the first jsp page");
        return "home";
    }
}

在webapp/WEB-INF/view(之前在spring-mvc.xm中设置过的路径)中，新建home.jsp。

<%--
  Created by IntelliJ IDEA.
  User: YanMing
  Date: 2017/2/25
  Time: 9:57
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <h1>hello nihao</h1>
    <p>This is the home page og this project</p>
</head>
<body>

</body>
</html>

页面也写好了呢，可以启动了么？NO！会不会发现你并没有配置tomcat？点击右上角的Edit configuration，配置

tomcat。

应用你的设置，tomcat配置完毕。

最后还有一点点东西，就是log4j的日志配置问题。在你的java文件夹下新建log4j.properties。

#配置根Logger 后面是若干个Appender
log4j.rootLogger=DEBUG,A1,R
#log4j.rootLogger=INFO,A1,R

# ConsoleAppender 输出
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

# File 输出 一天一个文件,输出路径可以定制,一般在根路径下
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
log4j.appender.R.File=D:\apache-tomcat-8.0.0-RC1\logs\app.log
log4j.appender.R.MaxFileSize=500KB
log4j.appender.R.MaxBackupIndex=10
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

注意更改你的log4j.appender.R.File=D:\apache-tomcat-8.0.0-RC1\logs\app.log选项。注意如果把tomcat放在c

盘会导致权限问题，log将无法写入。

接下来，我们的SpringMVC就配置完成了。启动你的tomcat，然后再浏览器输入http://localhost:8080/hello，查看

结果吧