Maven的使用

Maven的好處相比做過項目的童鞋都知道。它是用來專門管理項目和代碼的工具。能夠很好的管理項目，控制jar包的資源。打包，發佈都十分的方便，這篇博文主要介紹一下maven的安裝和使用。

一：安裝和配置環境變量、maven倉庫的設置

二：使用CMD創建maven項目，打包並運行操作

三：eclipse中創建maven項目、打包jar、打包war、部署在tomcat

四：maven項目使用常見錯誤，以及錯誤處理情況

五：maven項目的導入和打包，以及pom文件的使用

一：安裝和配置環境變量、maven倉庫的設置

1. 下載：可以從官方最新版下載地址：http://maven.apache.org/download.cgi下載maven壓縮包，下載完成後解壓到本地磁盤中即可完成安裝。

2. 配置環境變量：maven的運行需要設置環境變量，在我的電腦高級設置中添加環境變量：M2_HOME，值爲：E:\maven\apach-maven-3.5.0，然後添加到path變量中：(;%M2_HOME%\bin)，完成環境變量的設置。

3. 每一個maven都會對應一個倉庫，即常見的.m2文件，該文件中存儲了一個jar資源包，項目中使用的jar依賴都是來自於這個倉庫。那這個倉庫在哪裏，又是如何生成的呢？在我們下載解壓好的maven中，conf文件下有一個settings.xml文件，該文件指明瞭倉庫的存放地址(默認在C盤用戶下的.m2文件中)，以及倉庫的資源地址(改地址會在maven運行加載時自動從改地址下載倉庫到本地的.m2文件)。

①倉庫位置：大概在該文件的50行左右，可以通過<localRepository>e:/maven/repository</localRepository>，來完成默認倉庫存放地址的修改

②倉庫的資源下載地址：在settings.xml文件中，找到<mirrors>標籤，在該標籤中添加資源下載地址，目前比較流行下載alibaba的maven資源。

<mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
     </mirror>

4. 此時maven已經安裝並配置完成了， 在CMD中輸入mvn -v,查看Maven的版本信息，出現了版本信息表示maven配置成功。

5. 那還需要下載maven倉庫，怎麼下載呢？可以使用CMD的命令：mvn help:system，默認下載setting中設置的倉庫地址下載到設置的maven倉庫路徑中。執行完成後，即可看到在配置的路徑下有一些jar包資源，則這些jar包資源就可以在maven項目的pom文件中直接引入使用了。

二：使用CMD創建maven項目，打包並運行操作。

正常創建和打包maven項目都不會在命令行中進行，都會在IDE工具中完成。此例通過命令行完成maven項目的創建和打包和執行jar。演示maven的原生運行過程。

1. CMD中，路徑切換至新建的項目文件夾中，確保1這個文件夾中是空的。

執行命令：mvn archetype:generate -DgroupId=com.java -DartifactId=j2se -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

意思是創建一個項目，項目包名：com.java，項目名稱時:j2se，項目類型：maven-archetype-quickstart

執行，即可發現1文件夾中被搭建好了maven項目。並在java文件夾中自動生成了app.java，main方法中輸出"Hello World"，

2. 將項目打包，打成jar，並運行出"Hello World"

打包：CMD路徑切換到j2se下，運行mvn package，此命令會將該項目編譯、測試、打包等一系列操作，然後在target下生成一個jar包。

運行：執行命令：java -cp target/j2se-1.0-SNAPSHOT.jar com.java.App，此時就會在CMD中打印輸出了"Hello World"。

3. CDM創建的打包以及運行結束。

三：eclipse中創建maven項目、打包jar、打包war、部署在tomcat。

在eclipse中如何創建maven項目呢？其實很簡單

1. 首先需要在eclipse中聲明maven版本、倉庫位置、JDK的版本信息等

①在eclipse中聲明maven版本：菜單->Window->Preferences->Maven->Installations->E:\amven\apache-maven-3.5.0，指定maven的位置

②菜單->Window->Preferences->Maven->User Settings-> Global Settings 和 User Settings都使用：maven下的setting路徑，指定倉庫的位置信息

2. 創建Maven項目，通過new->maven project

這個按照默認點擊next，

然後默認是maven-archetype-quickstart類型，如果要創建WEB類型的maven項目就選擇如下所示，然後next：

然後輸入項目包名，和項目名，點擊finish，完成創建：

3. 創建完成maven項目由於JDK是使用的eclipse中默認的JDK，會導致項目報錯，此時右鍵項目->屬性->Java Build Path->Libraries->Edit->Workspace default JRE(jdk8)->Finish，完成設置，如果index.jsp文件報錯的話，則雙擊打開pom.xml文件，選擇dependences然後選擇ADD，搜索servlet，添加servlet的jar包即可。此時通過啓動tomcat，訪問index即可啓動該項目。

4. 搭建一個maven風格的SSM項目：

在maven中搭建項目，最重要的就是對jar包的依賴，也就是配置pom.xml文件，搭建SSM項目所需要用到的依賴如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>maven.wht</groupId>
  <artifactId>web</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>web Maven Webapp</name>
  <url>http://maven.apache.org</url>
  
  <properties>
    <spring.version>4.1.3.RELEASE</spring.version>
    <pagehelper.version>5.1.2-beta</pagehelper.version>
    <mysql.version>5.1.6</mysql.version>
    <mybatis.spring.version>1.2.3</mybatis.spring.version>
    <mybatis.version>3.1.1</mybatis.version>
    <junit.version>4.12</junit.version>
    <jstl.version>1.2</jstl.version>
    <jsqlparser.version>1.0</jsqlparser.version>
    <jackson.version>1.2.7</jackson.version>
    <servlet-api.version>3.1.0</servlet-api.version>
    <druid.version>1.0.18</druid.version>
    <log4j.version>1.2.16</log4j.version>
    <commons-logging.version>1.2</commons-logging.version>
    <commons-fileupload.version>1.2.1</commons-fileupload.version>
    <commons-io.version>1.3.2</commons-io.version>
    <commons-lang.version>2.6</commons-lang.version>
    <aopalliance.version>1.0</aopalliance.version>
    <mybatis-generator.version>1.3.5</mybatis-generator.version>
  </properties>
  
  
  <dependencies>
 
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>${junit.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>${mybatis.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>${mybatis.spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>${mysql.version}</version>
    </dependency>
 
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>druid</artifactId>
      <version>${druid.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>${spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${spring.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aspects</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- JSP相關 -->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>${jstl.version}</version>
    </dependency>
 
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>${servlet-api.version}</version>
      <scope>provided</scope>
    </dependency>
 
    <!-- pageHelper -->
    <dependency>
      <groupId>com.github.pagehelper</groupId>
      <artifactId>pagehelper</artifactId>
      <version>${pagehelper.version}</version>
    </dependency>
 
    <!--jsqlparser-->
    <dependency>
      <groupId>com.github.jsqlparser</groupId>
      <artifactId>jsqlparser</artifactId>
      <version>${jsqlparser.version}</version>
    </dependency>
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>${log4j.version}</version>
    </dependency>
 
    <dependency>
      <groupId>commons-logging</groupId>
      <artifactId>commons-logging</artifactId>
      <version>${commons-logging.version}</version>
    </dependency>
 
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>${commons-fileupload.version}</version>
    </dependency>
 
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>${commons-io.version}</version>
    </dependency>
 
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>${commons-lang.version}</version>
    </dependency>
 
    <dependency>
      <groupId>aopalliance</groupId>
      <artifactId>aopalliance</artifactId>
      <version>${aopalliance.version}</version>
    </dependency>
 
    <dependency>
      <groupId>org.mybatis.generator</groupId>
      <artifactId>mybatis-generator-core</artifactId>
      <version>${mybatis-generator.version}</version>
    </dependency>
 
  </dependencies>
  
  <build>
    <finalName>${project.artifactId}</finalName>
    <plugins>
      <!-- 資源文件拷貝插件 -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>2.7</version>
        <configuration>
          <encoding>UTF-8</encoding>
        </configuration>
      </plugin>
      <!-- java編譯插件 -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.2</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
          <encoding>UTF-8</encoding>
        </configuration>
      </plugin>
    </plugins>
    <pluginManagement>
      <plugins>
        <!-- 配置Tomcat插件 -->
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <artifactId>tomcat7-maven-plugin</artifactId>
          <version>2.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
 
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
          <include>**/*.tld</include>
        </includes>
        <filtering>false</filtering>
      </resource>
      <resource>
        <directory>src/main/java</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
        </includes>
        <filtering>false</filtering>
      </resource>
    </resources>
 
  </build>
</project>

設置完成jar包依賴之後，則按照SSM的創建方式，完成SSM項目的搭建，指的注意的是：在maven項目中，xml配置文件可以放置在resources路徑下(該路徑其實也是SRC根路徑)，在webapp中創建相應的jsp或者js等，大概項目結構如下圖：

5. 以上SSM項目通過eclipse工具打成war包或者jar包。併發布部署在tomcat中運行訪問，無論打什麼類型的包，有個原則是現maven clean一下。

①打war包：首先在pom.xml中，<packageing>標籤的值爲war，右擊項目->run as->maven clean->，然後run as->maven install->完成打包，此時打好的包存放在項目的target路徑下。然後將該war包修改下簡單點的文件名，放在tomcat的webapp路徑下，啓動Tomcat，即可訪問該項目。打好的war包會在WEB-INF目錄下生成lib文件夾，從maven導入的相關jar包都會在該路徑下。

如果點擊clean沒有反應，是因爲eclipse沒有添加maven的參數，解決辦法：window-java-installed JREs-選中使用的jdk-在default中加入maven的環境變量值：-Dmaven.multiModuleProjectDirectory=$M2_HOME，點擊OK即可。

如果點擊install時，building失敗，提示信息表示jdk or jre，則該錯誤原因是：eclipse中默認的添加的是jre編譯，我們需要修改成JDK編譯，還要對比pom.xml中的jdk版本是否一致。修改方法：window-preferences-java-installed JREs-刪除原來的jre，-add-standard VM-選擇JDK的安裝路徑（可以在cmd中 java -verbose查看安裝路徑）點擊OK即可。

②打成jar包，則將pom.xml文件的<packageing>值修改爲jar即可，運行jar包項目時，需要在CMD中，文件路徑轉到jar包所在路徑，然後通過命令jave -jar jar包名.jar   ，運行該jar包。

四：maven項目使用常見錯誤，以及錯誤處理情況。

1. 如果maven項目報錯org.springframework.web.context.ContextLoaderListener，提示ClassNotFound異常，查找jar包依賴能找到該jar，原因是工程部署時，沒有創建lib文件，導致無法加載資源。所以tomcat啓動失敗。進入到tomcat的eclipse中部署路徑.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps\下檢查了一下，發現工程部署後在WEB-INF文件夾下沒有生成lib目錄，正常情況下，會生成lib目錄並把工程的所有依賴jar包都部署到該目錄下。

解決方案：

1.右鍵點擊項目--選擇Properties

選擇Deployment Assembly,在右邊點擊Add按鈕，在彈出的窗口中選擇Java Build Path Entries

2.點擊Next，選擇Maven Dependencies

3.點擊Finish，然後可以看到已經把Maven Dependencies添加到Web應用結構中了

重新部署項目，啓動tomcat，問題解決。

五：maven項目的導入和打包，以及pom文件的使用