IDEA用maven创建springMVC项目和配置（XML配置和Java配置）(修正版)

分手后的思念是犯贱 2024-02-18 16:31 37阅读 0赞

这段时间在学习javaweb的一些知识，然后接触到了springmvc框架。框架的创建和配置一直是新手入门的一个难题，所以我就写一下我的配置过程，以供参考，另外因为spring4的新特性可以用java来配置，网上相关资料较少，所以我参考了很多博文后，把xml和java两种配置方式都试了一下。  
工具准备：IDEA2016.3 Java jdk 1.8  
1、DEA创建项目  
新建一个maven project，并且选择webapp原型。  
![这里写图片描述][SouthEast]  
然后点击next  
![这里写图片描述][SouthEast 1]

这里的GroupId和ArtifactID随意填写，但是ArtifactID最好和你的项目一名一样然后next

![这里写图片描述][SouthEast 2]

为了快一点创建，我们添加一个属性值，如图中亮的所示，点右边的加号，name=archetypeCatalog value=internal。  
这里我们选择使用IDEA自带的maven，下面的两个分别是你的maven配置文件和你的仓库地址，我记得idea的maven一开始是没有setting.xml的，所以你要去maven的目录里面拷一份setting.xml到你的仓库中。idea的maven在安装路径的plugins文件夹下，即X:\\xxx\\JetBrains\\IntelliJ IDEA 2016.3.2\\plugins\\plugins\\maven\\lib\\maven3\\conf\\setting.xml拷贝到你的用户文件夹下的.m2文件夹下，为了之后能够快速的下载依赖包，我们要加一个官方库的镜像，因为maven的官方仓库在国外，太慢了。  
我们在你的.m2文件夹下的setting.xml中添加如下代码：

<mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
          <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
    </mirror>
       
       
        
         1 
         2 
         3 
         4 
         5 
         6

具体位置如下图所示

![这里写图片描述][SouthEast 3]

这个是阿里的库，所以很快。做完之后我们回到idea，点击next，然后填写项目名，然后finish。  
接下来idea开始创建项目，这里你要把maven自动导入打开。

![这里写图片描述][SouthEast 4]

然后等待maven创建项目成功

![这里写图片描述][SouthEast 5]

这样我们的项目初始的框架就弄好了。

2、添加pom依赖  
创建好之后的项目目录如图所示  
![这里写图片描述][SouthEast 6]

我们打开其中的pom.xml，添加我们的依赖。这里我把我的依赖全部放出来，复制到你的pom.xml的dependencies标签之间就可以了，pom文件中也会给你一个示例。  
我的依赖如下

<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>
        
        <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>
        
        <dependency>
          <groupId>mysql</groupId>
          <artifactId>mysql-connector-java</artifactId>
          <version>5.1.35</version>
        </dependency>
        
        <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>
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12 
         13 
         14 
         15 
         16 
         17 
         18 
         19 
         20 
         21 
         22 
         23 
         24 
         25 
         26 
         27 
         28 
         29 
         30 
         31 
         32 
         33 
         34 
         35 
         36 
         37 
         38 
         39 
         40 
         41 
         42 
         43 
         44 
         45 
         46 
         47 
         48 
         49 
         50 
         51 
         52 
         53 
         54 
         55 
         56 
         57 
         58 
         59 
         60 
         61 
         62 
         63 
         64 
         65 
         66 
         67 
         68 
         69 
         70 
         71 
         72 
         73 
         74 
         75 
         76 
         77 
         78 
         79 
         80 
         81 
         82 
         83

一旦你复制过去之后，maven就会开始下载相应的jar文件，等待下载完成即可。可能包有点多，不过用了阿里的镜像之后还是挺快的。

3、添加框架支持  
配置完pom.xml之后，我们在idea中要添加一下框架的支持。  
右击我们的项目文件夹，选择add framework support  
![这里写图片描述][SouthEast 7]

然后在窗口中分别选中spring和springmvc，并且选择spring是，记得勾选springconfig.xml

如果没有看见spring相关选项,说明系统已经默认,可以到Project StruStructure---Mudules--删掉Spring项...然后回头再来选一次即可看见

![这里写图片描述][SouthEast 8]

因为我们之前下载过相应的文件，所以这里直接用我们下载好的spring文件。  
点击ok之后，我们会发现WEB-INF文件夹下多出了两个文件  
![这里写图片描述][SouthEast 9]

这个就是我们之后要配置的文件，先不用管。

4、完善目录结构  
首先我们在src/main文件夹下创建java文件夹，你会发现这个文件夹不能创建java的类文件和package，别急，先把必须的文件夹全部创建好。请按照下图创建文件夹  
![这里写图片描述][SouthEast 10]

然后我们进入project structure选择文件夹的作用，在界面的右上角进入project structure![这里写图片描述][SouthEast 11]  
然后在module中选择设置各个模块，其中java文件夹是 sources，test是Test，改完之后，点ok，文件夹会变色，那就成功了。  
![这里写图片描述][SouthEast 12]  
然后仔仔java文件夹中添加需要的包。最后的完整目录如下  
![这里写图片描述][SouthEast 13]

这样我们配置前的工作就完成了，接下来就是对springmvc进行配置。我把两种配置的方法分成两部分，以供参考。

5、基于XML 的配置

5.1、配置web.xml  
  idea创建的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-file-list>
            <welcome-file>index.jsp</welcome-file>
        </welcome-file-list>
    
        
        <servlet>
            <servlet-name>springMVC</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            <init-param>
                
                <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>springMVC</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>
        
        <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>
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12 
         13 
         14 
         15 
         16 
         17 
         18 
         19 
         20 
         21 
         22 
         23 
         24 
         25 
         26 
         27 
         28 
         29 
         30 
         31 
         32 
         33 
         34 
         35 
         36 
         37 
         38

上面代码的意思主要就是创建一个中央的控制器，都有简单的注释，如果有需要，请自行百度。

5.2 配置dispatcher-servlet.xml  
  这个文件负责mvc的配置。

<?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">
        
    
        
        <context:annotation-config/>
    
        
        <mvc:annotation-driven/>
    
        
        
        <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/"/>
    
        
        
        <bean id="defaultViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
    	<property name="prefix" value="/"/>
            <property name="suffix" value=".jsp"/>
            <property name="exposeContextBeansAsAttributes" value="true"/>
        </bean>
    
        
        <context:component-scan base-package="example.controller"/>
    </beans>
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12 
         13 
         14 
         15 
         16 
         17 
         18 
         19 
         20 
         21 
         22 
         23 
         24 
         25 
         26 
         27 
         28 
         29 
         30 
         31 
         32

直接复制即可，都有注释，如果有需要，请自行百度。

5.3、 配置applicationContext.xml  
 其实这个文件没什么好配置的，这个文件主要负责一些非mvc组件（或者其他组件）的配置，暂时没有，所以是空的，但你也可以扫描一下。

5.4、 测试  
 三个配置文件配置好之后，就可以测试了。首先在controller文件夹下创建一个IndexController，代码如下：

@Controller
    @RequestMapping("/home")
    public class IndexController {
          
    
        @RequestMapping("/index")
        public String index() {
            return "index";
        }
    }
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10

views文件夹下创建index.jsp，statics/css/下创建test.css

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>Index</title>
        <link rel="stylesheet" type="text/css" href="<c:url value="/css/test.css"/> "/>
    </head>
    <body>
    <p>Spring MVC based on XML config success!</p>
    </body>
    </html>
    
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12

p
    {
        background-color: brown;
        font-family: "Courier New";
        font-size:100px;
    }
       
       
        
         1 
         2 
         3 
         4 
         5 
         6

接下来配置tomcat，如果没有，去官网下载tomcat7以上的版本。  
右上角  
![这里写图片描述][SouthEast 14]  
然后选择tomcat  
![这里写图片描述][SouthEast 15]  
配置相关信息  
![这里写图片描述][SouthEast 16]  
还有deployment  
![这里写图片描述][SouthEast 17]  
选择第二个  
![这里写图片描述][SouthEast 18]  
这里的名称和项目名一样。  
![这里写图片描述][SouthEast 19]  
然后点击ok完成。

最后运行tomcat，在浏览器输入[http://localhost:8080/Demo/home/index][http_localhost_8080_Demo_home_index] 即可。  
![这里写图片描述][SouthEast 20]  
运行成功。

6、基于Java配置  
java配置也是参考spring in action 第四版这个书，所以具体的原理不去详解，所以我这里更加倾向于把java配置和xml配置中的相同功能的部分进行比较，也是能对java配置又以有一个更加直观的认识。  
首先我们先完成准备工作，也就是本文的前四个直到文件目录完成，但是目录需要一点小的修改，因为多了配置类，如下图。  
![这里写图片描述][SouthEast 21]  
可以看到我们多了一个config包，这个里面就是放配置类的。

6.1 、去除web.xml  
web.xml里面的内容可以删掉了。  
在config中创建WebXml类

public class WebXml extends AbstractAnnotationConfigDispatcherServletInitializer {
        /*
         <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>
          */
        @Override
        protected Class<?>[] getRootConfigClasses() {
            return new Class<?>[] {ApplicationContextXml.class};
        }
    
        /*
        <servlet>
            <servlet-name>springMVC</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            <init-param>
                
                <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>
         */
        @Override
        protected Class<?>[] getServletConfigClasses() {
           
            return new Class<?>[] {DispatcherServletXml.class};
        }
    
        /*
        <servlet-mapping>
            <servlet-name>springMVC</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>
         */
        @Override
        protected String[] getServletMappings() {
            return new String[] {"/"};
        }
    }
    
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12 
         13 
         14 
         15 
         16 
         17 
         18 
         19 
         20 
         21 
         22 
         23 
         24 
         25 
         26 
         27 
         28 
         29 
         30 
         31 
         32 
         33 
         34 
         35 
         36 
         37 
         38 
         39 
         40 
         41 
         42 
         43 
         44 
         45

6.2、去除dispatcher-servle.xml

@Configuration
    @EnableWebMvc
    @ComponentScan("web.example.controller")
    public class DispatcherServletXml extends WebMvcConfigurerAdapter{
          
        /*
        <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/"/>
            <property name="suffix" value=".jsp"/>
            <property name="exposeContextBeansAsAttributes" value="true"/>
        </bean>
         */
        @Bean
        public ViewResolver viewResolver() {
            InternalResourceViewResolver resolver = new InternalResourceViewResolver();
            resolver.setViewClass(org.springframework.web.servlet.view.JstlView.class);
            resolver.setPrefix("/WEB-INF/views/");
            resolver.setSuffix(".jsp");
            resolver.setExposeContextBeansAsAttributes(true);
            return resolver;
        }
    
        @Override
        public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
            configurer.enable();
            super.configureDefaultServletHandling(configurer);
        }
        // 静态资源配置
        /*
        <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/"/>
         */
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            registry.addResourceHandler("/css/**").addResourceLocations("/WEB-INF/statics/css/");
            registry.addResourceHandler("/js/**").addResourceLocations("/WEB-INF/statics/js/");
            registry.addResourceHandler("/image/**").addResourceLocations("WEB-INF/statics/image/");
            super.addResourceHandlers(registry);
        }
    }
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8 
         9 
         10 
         11 
         12 
         13 
         14 
         15 
         16 
         17 
         18 
         19 
         20 
         21 
         22 
         23 
         24 
         25 
         26 
         27 
         28 
         29 
         30 
         31 
         32 
         33 
         34 
         35 
         36 
         37 
         38 
         39 
         40 
         41

6.3、去除applicationContext.xml

@Configuration
    @ComponentScan(basePackages = {
         "web"},
            excludeFilters = {
                    @ComponentScan.Filter(type = FilterType.ANNOTATION, value = EnableWebMvc.class)
            })
    public class ApplicationContextXml {
          
    }
       
       
        
         1 
         2 
         3 
         4 
         5 
         6 
         7 
         8

上面三个配置类中的每一个设置我都对应的给出了原xml文档中的对应部分，两边对照着看，应该很容易理解。  
然后按照之前的测试方法，测试成功。

7、 结束语  
以上的都是我边写边进行配置的，如果说的有什么错误，希望指正，毕竟我还是个新手，配置成功的项目我已经上传，以方便参考。链接：[点此下载][Link 1]

参考资料：  
[IntelliJ IDEA上创建Maven Spring MVC项目][IntelliJ IDEA_Maven Spring MVC]

[IntelliJ idea创建Spring MVC的Maven项目][IntelliJ idea_Spring MVC_Maven]

[Intellij IDEA使用Maven快速创建Spring MVC Web项目工程][Intellij IDEA_Maven_Spring MVC Web]

[applicationContext.xml和dispatcher-servlet.xml的区别][IntelliJ IDEA_Maven Spring MVC]

[Servlet 3 + Spring MVC零配置：去除所有xml  
][Servlet 3 _ Spring MVC_xml]

[Spring(三）：使用java config配置spring mvc][Spring_java config_spring mvc]

[SouthEast]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/1183e38a0eb04ef48dfd88f06f6f0045.png
[SouthEast 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/51bea23e07a24cf7b7fc780c2da1e709.png
[SouthEast 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/a9c0fed5cb9246948a1c0ea6b0e2691b.png
[SouthEast 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/3157edb02efd4db99cf1669ff487c5e5.png
[SouthEast 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/04f5da82bd6d42388fee16505297289e.png
[SouthEast 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/284127dd7a714cf2827bbb30dc7c62f9.png
[SouthEast 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/99fc1d7896c1403c95d6ce2a1140beba.png
[SouthEast 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/41b2536c182045348bc4d61a1305c9fc.png
[SouthEast 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/16ec353353b64eeeb9dba66b0fa5e1a7.png
[SouthEast 9]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/0eb610171d394e5484b64a63b691c15b.png
[SouthEast 10]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/7be94202e4514cd6b71ee2226f7f6369.png
[SouthEast 11]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/84e125fe20894836baaf9fd86071a46d.png
[SouthEast 12]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/feaba62ef4cf4ab3a65b151e981b0255.png
[SouthEast 13]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/f19b0704058c423395ee7b4fc3938528.png
[SouthEast 14]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/5dcda1da1d6f41b59a825763676012fc.png
[SouthEast 15]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/5a4cc0ad35124e28bc3ffde836e322be.png
[SouthEast 16]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/7501df27c9074e63b19b9ae17921a7ea.png
[SouthEast 17]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/e4bcd22994354789a2a53d43a38abaf0.png
[SouthEast 18]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/5dcfd8279231452e82544e6a5e8440ff.png
[SouthEast 19]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/73cf17d99e584715b1638e1b5f298e11.png
[http_localhost_8080_Demo_home_index]: http://localhost:8080/Demo/home/index
[SouthEast 20]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/559c7f130da34c588098e1b73b998bfd.png
[SouthEast 21]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/34d5b112e638407c81b3495812b143ab.png
[Link 1]: http://download.csdn.net/detail/cquwel/9768478
[IntelliJ IDEA_Maven Spring MVC]: http://www.cnblogs.com/parryyang/p/5783399.html
[IntelliJ idea_Spring MVC_Maven]: http://www.cnblogs.com/winner-0715/p/5294917.html
[Intellij IDEA_Maven_Spring MVC Web]: http://www.tuicool.com/articles/aMzM7jR
[Servlet 3 _ Spring MVC_xml]: http://blog.csdn.net/xiao__gui/article/details/46803193
[Spring_java config_spring mvc]: http://blog.csdn.net/sbjiesbjie/article/details/53264340