1. 程式人生 > >IDEA用maven創建springMVC項目和配置

IDEA用maven創建springMVC項目和配置

beans connector 點擊 lease odi tar 記得 相關信息 iyu

原文地址: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項目和配置