IDEA用maven創建springMVC項目和配置
原文地址:http://blog.csdn.net/cquwel
這段時間在學習javaweb的一些知識,然後接觸到了springmvc框架。框架的創建和配置一直是新手入門的一個難題,所以我就寫一下我的配置過程,以供參考,另外因為spring4的新特性可以用Java來配置,網上相關資料較少,所以我參考了很多博文後,把xml和java兩種配置方式都試了一下。
工具準備:IDEA2016.3 Java jdk 1.8
1、DEA創建項目
新建一個maven project,並且選擇webapp原型。
然後點擊next
這裏的GroupId和ArtifactID隨意填寫,但是ArtifactID最好和你的項目一名一樣然後next
為了快一點創建,我們添加一個屬性值,如圖中亮的所示,點右邊的加號,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>
具體位置如下圖所示
這個是阿裏的庫,所以很快。做完之後我們回到idea,點擊next,然後填寫項目名,然後finish。
接下來idea開始創建項目,這裏你要把maven自動導入打開。
然後等待maven創建項目成功
這樣我們的項目初始的框架就弄好了。
2、添加pom依賴
創建好之後的項目目錄如圖所示
我們打開其中的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> <!--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>
一旦你復制過去之後,maven就會開始下載相應的jar文件,等待下載完成即可。可能包有點多,不過用了阿裏的鏡像之後還是挺快的。
3、添加框架支持
配置完pom.xml之後,我們在idea中要添加一下框架的支持。
右擊我們的項目文件夾,選擇add framework support
然後在窗口中分別選中spring和springmvc,並且選擇spring是,記得勾選springconfig.xml
因為我們之前下載過相應的文件,所以這裏直接用我們下載好的spring文件。
點擊ok之後,我們會發現WEB-INF文件夾下多出了兩個文件
這個就是我們之後要配置的文件,先不用管。
4、完善目錄結構
首先我們在src/main文件夾下創建java文件夾,你會發現這個文件夾不能創建java的類文件和package,別急,先把必須的文件夾全部創建好。請按照下圖創建文件夾
然後我們進入project structure選擇文件夾的作用,在界面的右上角進入project structure
然後在module中選擇設置各個模塊,其中java文件夾是 sources,test是Test,改完之後,點ok,文件夾會變色,那就成功了。
然後仔仔java文件夾中添加需要的包。最後的完整目錄如下
這樣我們配置前的工作就完成了,接下來就是對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 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> <!--配置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>springMVC</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>
上面代碼的意思主要就是創建一個中央的控制器,都有簡單的註釋,如果有需要,請自行百度。
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"> <!--此文件負責整個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/views/"/><!--設置JSP文件的目錄位置--> <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以上的版本。
右上角
然後選擇tomcat
配置相關信息
還有deployment
選擇第二個
這裏的名稱和項目名一樣。
然後點擊ok完成。
最後運行tomcat,在瀏覽器輸入http://localhost:8080/Demo/home/index 即可。
運行成功。
6、基於Java配置
java配置也是參考spring in action 第四版這個書,所以具體的原理不去詳解,所以我這裏更加傾向於把java配置和xml配置中的相同功能的部分進行比較,也是能對java配置又以有一個更加直觀的認識。
首先我們先完成準備工作,也就是本文的前四個直到文件目錄完成,但是目錄需要一點小的修改,因為多了配置類,如下圖。
可以看到我們多了一個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> <!--配置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> */ @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/views/"/><!--設置JSP文件的目錄位置--> <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 { } 1
上面三個配置類中的每一個設置我都對應的給出了原xml文檔中的對應部分,兩邊對照著看,應該很容易理解。
然後按照之前的測試方法,測試成功
IDEA用maven創建springMVC項目和配置