IDEA下创建一个Maven + SpringMVC项目

这几天就开始学习Spring框架了, 工欲善其事, 必先利其器, 所以就从搭建环境开始吧. 因为是刚开始学习, 所以对有些配置文件了解的不是很清楚, 这期间也参考了很多博客, 暂且将搭建步骤记录下来, 以免忘记.

---

创建Maven项目

首先是new一个Project, 选择创建Maven项目:

Project创建好之后, 进行IDEA的主页.
在右下角有Maven projects need to be imported, 点击第二个Enable Auto-Import将Maven需要的包都导入工程, 配置好Maven环境.

在配置好Maven环境之后, 先不要着急在pom.xml中导入常用包, 因为网上给出的大多数pom.xml文件的dependecy标签集中都含有Spring MVC框架的包, 但这往往并不是Spring的核心包, 如果你直接导入进pom.xml文件之后, Maven就会开始自动下载, 这会导致你在之后添加Spring MVC框架失败, 由于有与Spring相关的包被下载到当前工程, IDEA会认为你已经添加了Spring MVC框架, 所以在框架的选项中就不会再出现Spring框架了.
所以在将包导入pom.xml文件之前我们先来添加Spring MVC框架.

添加Spring MVC框架

右击左上角你的Project的名字, 点击Add Framework Support, 会出现下面这个框:

选择Spring MVC, 然后点击OK. 这样Spring MVC的框架就添加好了. 此时在webapp下的WEB-INF目录下会有三个XML文件, 分别为:web.xml/dispatcher-servlet.xml/applicationContext.xml, 这三个XML文件是Spring MVC的核心配置文件, 我们将稍后介绍到.

配置pom.xml文件

添加好了Spring MVC框架, 接下来就是配置pom.xml了. 将下面的代码复制粘贴至pom.xml中的dependencies标签之间, 然后静静的等待它们自动下载完成就好了.

    <!--测试-->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>test</scope>
    </dependency>
    <!--日志-->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.21</version>
    </dependency>
    <!--J2EE-->
    <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>
    <!--springframework-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>com.github.stefanbirkner</groupId>
      <artifactId>system-rules</artifactId>
      <version>1.16.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjweaver</artifactId>
      <version>1.8.9</version>
    </dependency>
    <!--其他需要的包-->
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-lang3</artifactId>
      <version>3.4</version>
    </dependency>
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.1</version>
    </dependency>

配置web.xml文件

接下来是web.xml. web.xml配置文件都是项目的核心配置, 比如对中文码的解析, 对加载本地资源的过滤属性等. IDEA下自动生成的web.xml的版本是2.3的, 这个版本太低导致有些配置结点IDEA会识别不出来, 所以我们重新添加一个3.1版本的, 你可以直接将下面的代码复制进web.xml中就好了.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

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

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

    <!--配置springmvc DispatcherServlet-->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!--配置dispatcher.xml作为mvc的配置文件-->
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/dispatcher-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!--把applicationContext.xml加入到配置文件中-->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

</web-app>

配置disptcher-servlet.xml文件

同样的, 将下面的代码复制进你的dispatcher-servlet文件中就可以了.
需要注意的是, 我将静态资源配置注释了起来, 因为当前的WEB-INF下还没有创建static目录及下面的css/js/image目录, 等到需要的时候再进行创建, 并取消注释就可以了.
还有就是代码最后的自动扫描配置, 这涉及到Spring框架的具体学习, 如果你继续学习Spring可以看我之后的博客, 再进行了解.
而它的base-package就是后面要运行出来的hello spring的MainController类所在的Controller包.

<?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.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--此文件负责整个mvc中的配置-->

    <!--启用spring的一些annotation -->
    <context:annotation-config/>

    <!-- 配置注解驱动 可以将request参数与绑定到controller参数上 -->
    <mvc:annotation-driven/>

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

    <!-- 对模型视图名称的解析，即在模型视图名称添加前后缀(如果最后一个还是表示文件夹,则最后的斜杠不要漏了) 使用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"/>
        <property name="exposeContextBeansAsAttributes" value="true"/>
    </bean>

    <!-- 自动扫描装配 -->
    <context:component-scan base-package="Controller"/>
</beans>

配置applicationContext.xml文件

当前这个XML文件里是不需要配置什么的, 你只需要让它保持Spring被创建之初的原样就可以了, 先不用去管它.

配置tomcat

最后就是配置tomcat了, Maven下的tomcat的配置还有一点点不一样.

先进入Edit, 进入配置.

然后添加tomcat->local

点击右下方的fix

选择exploded

tomcat配置完成!

hello Spring

到这里环境就准备好了, 就可以编写hello Spring了!
在main下创建java目录, 并将其设置为Sources(右击java目录, 然后选择mark derectory as, 然后选择sources就好了), 然后建一个Controller包, 并新建MainController类.
MainController类的内容如下:

@Controller
@RequestMapping(value = "/main")
public class MainController {

    @RequestMapping(method = RequestMethod.GET)
    @ResponseBody
    public String welcome(){
        return "hello Spring!";
    }
}

编写完成运行tomcat, 地址栏的localhost:8080后添加/main, 结果如下: