IntelliJ IDEA用maven创建springMVC项目和配置

以你之姓@ 2022-05-16 03:57 222阅读 0赞

\-----------------------------------------------------------------------[原文章地址][Link 1]\---------------------------------------------------------------------

> 这段时间在学习javaweb的一些知识，然后接触到了springmvc框架。框架的创建和配置一直是新手入门的一个难题，所以我就写一下我的配置过程，以供参考，另外因为spring4的新特性可以用java来配置，网上相关资料较少，所以我参考了很多博文后，把xml和java两种配置方式都试了一下。   
> 工具准备：IDEA2016.3 Java jdk 1.8   
> 1、DEA创建项目   
> 新建一个maven project，并且选择webapp原型。 
> 
>         ![70][]
> 
> 然后点击next     
> 
>        
> ![70 1][]
> 
>    这里的GroupId和ArtifactID随意填写，但是ArtifactID最好和你的项目一名一样然后next
> 
>     ![70 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>
> 
> 具体位置如下图所示
> 
> ![70 3][]
> 
> 这个是阿里的库，所以很快。做完之后我们回到idea，点击next，然后填写项目名，然后finish。   
> 接下来idea开始创建项目，这里你要把maven自动导入打开。
> 
>                                                              ![70 4][]
> 
> 然后等待maven创建项目成功
> 
>                              ![70 5][]
> 
> 这样我们的项目初始的框架就弄好了。
> 
> 2、添加pom依赖   
> 创建好之后的项目目录如图所示 
> 
>                                                                ![70 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>
> 
> 一旦你复制过去之后，maven就会开始下载相应的jar文件，等待下载完成即可。可能包有点多，不过用了阿里的镜像之后还是挺快的。
> 
> 3、添加框架支持   
> 配置完pom.xml之后，我们在idea中要添加一下框架的支持。   
> 右击我们的项目文件夹，选择add framework support 
> 
>                                             ![70 7][]
> 
> 然后在窗口中分别选中spring和springmvc，并且选择spring是，记得勾选springconfig.xml
> 
>             ![70 8][]
> 
> 因为我们之前下载过相应的文件，所以这里直接用我们下载好的spring文件。   
> 点击ok之后，我们会发现WEB-INF文件夹下多出了两个文件 
> 
>                                                                              ![70 9][]
> 
> 这个就是我们之后要配置的文件，先不用管。
> 
> 4、完善目录结构   
> 首先我们在src/main文件夹下创建java文件夹，你会发现这个文件夹不能创建java的类文件和package，别急，先把必须的文件夹全部创建好。请按照下图创建文件夹 
> 
>                                                                 ![70 10][]
> 
> 然后我们进入project structure选择文件夹的作用，在界面的右上角进入project structure
> 
>                                                                          ![70 11][]
> 
> 然后在module中选择设置各个模块，其中java文件夹是 sources，test是Test，改完之后，点ok，文件夹会变色，那就成功了。
> 
>                                                                 ![70 12][]
> 
> 然后仔仔java文件夹中添加需要的包。最后的完整目录如下 
> 
>                                                               ![70 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>
> 
> 上面代码的意思主要就是创建一个中央的控制器，都有简单的注释，如果有需要，请自行百度。
> 
> 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="/WEB-INF/view/"/>
>             <property name="suffix" value=".jsp"/>
>             <property name="exposeContextBeansAsAttributes" value="true"/>
>         </bean>
>     
>         
>         <context:component-scan base-package="example.controller"/>
>     </beans>
> 
> 直接复制即可，都有注释，如果有需要，请自行百度。
> 
> 5.3、 配置applicationContext.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"
>            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">
>         <context:component-scan base-package="example"/>
>     </beans>
> 
> 5.4、 测试   
>  三个配置文件配置好之后，就可以测试了。首先在controller文件夹下创建一个IndexController，代码如下：
> 
>     @Controller
>     @RequestMapping("/home")
>     public class IndexController {
>     
>         @RequestMapping("/index")
>         public String index() {
>             return "index";
>         }
>     }
> 
> 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>
> 
>     p
>     {
>         background-color: brown;
>         font-family: "Courier New";
>         font-size:100px;
>     }
> 
> 接下来配置tomcat，如果没有，去官网下载tomcat7以上的版本。   
> 右上角 
> 
>                                                                       ![70 14][]
> 
> 然后选择tomcat 
> 
>                                       ![70 15][]
> 
> 配置相关信息
> 
> ![70 16][]
> 
> 还有deployment
> 
>    ![70 17][]
> 
> 选择第二个
> 
>                                          ![70 18][]
> 
> 这里的名称和项目名一样
> 
> ![70 19][]
> 
> 然后点击ok完成。
> 
> 最后运行tomcat，在浏览器输入[http://localhost:8080/Demo/home/index][http_localhost_8080_Demo_home_index] 即可。 
> 
> 6、基于Java配置   
> java配置也是参考spring in action 第四版这个书，所以具体的原理不去详解，所以我这里更加倾向于把java配置和xml配置中的相同功能的部分进行比较，也是能对java配置又以有一个更加直观的认识。   
> 首先我们先完成准备工作，也就是本文的前四个直到文件目录完成，但是目录需要一点小的修改，因为多了配置类，如下图。 
> 
>                                                                    ![70 20][]
> 
> 可以看到我们多了一个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[] {"/"};
>         }
>     }
> 
> 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);
>         }
>     }
> 
> 6.3、去除applicationContext.xml
> 
>     @Configuration
>     @ComponentScan(basePackages = {"web"},
>             excludeFilters = {
>                     @ComponentScan.Filter(type = FilterType.ANNOTATION, value = EnableWebMvc.class)
>             })
>     public class ApplicationContextXml {
>     }
> 
> 上面三个配置类中的每一个设置我都对应的给出了原xml文档中的对应部分，两边对照着看，应该很容易理解。   
> 然后按照之前的测试方法，测试成功。
> 
> 参考资料：
> 
> [applicationContext.xml和dispatcher-servlet.xml的区别][applicationContext.xml_dispatcher-servlet.xml]
> 
>

[Link 1]: https://blog.csdn.net/CQUWEL/article/details/59495083
[70]: /images/20220516/eec87fa8c903409f83ae59d3cea45829.png
[70 1]: /images/20220516/2dd76d2c62cd45fb9197f544a69c0aa7.png
[70 2]: /images/20220516/0d6b09f6ca364953b1b612d95cd9ae53.png
[70 3]: /images/20220516/0a67386af8d0497eaa868014709d3d35.png
[70 4]: /images/20220516/b273958fb64342ec8125ebc42254dcce.png
[70 5]: /images/20220516/0479f3000b864be2ba3985f84d09a5d4.png
[70 6]: /images/20220516/6d0aae20cdd04ed5bc68c59cb9ce565d.png
[70 7]: /images/20220516/12809d512fd04242bee0bc4e4152c442.png
[70 8]: /images/20220516/9889d5a8210e458eaea427602eb88a0e.png
[70 9]: /images/20220516/fc2bb244375f455db50a9c6c70a97b66.png
[70 10]: /images/20220516/3a671450e86d4d528c84fcedfc97263c.png
[70 11]: /images/20220516/efdb6a29d3544211af55e2ae4b23be49.png
[70 12]: /images/20220516/73249045d4294a4ab99d6ae167c5cf31.png
[70 13]: /images/20220516/e15c45fc7cb641c59f4759a894c147b4.png
[70 14]: /images/20220516/3f5a4582d6e04858b993ca06f54ec7be.png
[70 15]: /images/20220516/0b4ecff334924c21a394fb09740b37da.png
[70 16]: /images/20220516/62061f631e554f1dad4d81d646cae06b.png
[70 17]: /images/20220516/abb70dd337a94b72a2ad1606c279eade.png
[70 18]: /images/20220516/9f22759762874de0b2ddcefcece82e63.png
[70 19]: /images/20220516/6709e7483ee84a0fa762f8692e9088a7.png
[http_localhost_8080_Demo_home_index]: http://localhost:8080/Demo/home/index
[70 20]: /images/20220516/61d808b7e3e64955a6e0cdd47a88d54b.png
[applicationContext.xml_dispatcher-servlet.xml]: https://blog.csdn.net/lvhaoguang0/article/details/81705708