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, 结果如下: