模塊化建立項目流程(Maven聚合模塊)

先說項目使用Maven的好處

1、項目構建。Maven定義了軟件開發的整套流程體系，並進行了封裝，開發人員只需要指定項目的構建流程，無需針對每個流程編寫自己的構建腳本。
2、依賴管理。除了項目構建，Maven最核心的功能是軟件包的依賴管理，能夠自動分析項目所需要的依賴軟件包，併到Maven中心倉庫去下載。
A)管理依賴的jar包
B)管理工程之間的依賴關係。

傳統工程結構

Maven管理的工程結構：

不使用maven：工程部署時需要手動複製jar包。完成工程構建。非常繁瑣。
使用maven進行工程構建：
使用maven可以實現一步構建。

1.創建springmvc-parent

1.1創建maven工程

1.2修改pom文件

<!-- 集中定義依賴版本號 -->  
    <properties>  
        <junit.version>4.12</junit.version>  
        <spring.version>4.1.3.RELEASE</spring.version>  
        <mybatis.version>3.2.8</mybatis.version>  
        <mybatis.spring.version>1.2.2</mybatis.spring.version>  
        <mybatis.paginator.version>1.2.15</mybatis.paginator.version>  
        <mysql.version>5.1.32</mysql.version>  
        <slf4j.version>1.6.4</slf4j.version>  
        <jackson.version>2.4.2</jackson.version>  
        <druid.version>1.0.9</druid.version>  
        <httpclient.version>4.3.5</httpclient.version>  
        <jstl.version>1.2</jstl.version>  
        <servlet-api.version>2.5</servlet-api.version>  
        <jsp-api.version>2.0</jsp-api.version>  
        <joda-time.version>2.5</joda-time.version>  
        <commons-lang3.version>3.3.2</commons-lang3.version>  
        <commons-io.version>1.3.2</commons-io.version>  
        <commons-net.version>3.3</commons-net.version>  
        <pagehelper.version>3.4.2-fix</pagehelper.version>  
        <jsqlparser.version>0.9.1</jsqlparser.version>  
        <commons-fileupload.version>1.3.1</commons-fileupload.version>  
        <jedis.version>2.7.2</jedis.version>  
        <solrj.version>4.10.3</solrj.version>  
    </properties>  
<!-- 只定義以來的版本，並不實際依賴-->  
  <dependencyManagement>  
        <dependencies>  
            <!-- 時間操作組件 -->  
            <dependency>  
                <groupId>joda-time</groupId>  
                <artifactId>joda-time</artifactId>  
                <version>${joda-time.version}</version>  
            </dependency>  
            <!-- Apache工具組件 -->  
            <dependency>  
                <groupId>org.apache.commons</groupId>  
                <artifactId>commons-lang3</artifactId>  
                <version>${commons-lang3.version}</version>  
            </dependency>  
            <dependency>  
                <groupId>org.apache.commons</groupId>  
                <artifactId>commons-io</artifactId>  
                <version>${commons-io.version}</version>  
            </dependency>  
            <dependency>  
                <groupId>commons-net</groupId>  
                <artifactId>commons-net</artifactId>  
                <version>${commons-net.version}</version>  
            </dependency>  
            <!-- Jackson Json處理工具包 -->  
            <dependency>  
                <groupId>com.fasterxml.jackson.core</groupId>  
                <artifactId>jackson-databind</artifactId>  
                <version>${jackson.version}</version>  
            </dependency>  
            <!-- httpclient -->  
            <dependency>  
                <groupId>org.apache.httpcomponents</groupId>  
                <artifactId>httpclient</artifactId>  
                <version>${httpclient.version}</version>  
            </dependency>  
            <!-- 單元測試 -->  
            <dependency>  
                <groupId>junit</groupId>  
                <artifactId>junit</artifactId>  
                <version>${junit.version}</version>  
                <scope>test</scope>  
            </dependency>  
            <!-- 日誌處理 -->  
            <dependency>  
                <groupId>org.slf4j</groupId>  
                <artifactId>slf4j-log4j12</artifactId>  
                <version>${slf4j.version}</version>  
            </dependency>  
            <!-- Mybatis -->  
            <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>com.github.miemiedev</groupId>  
                <artifactId>mybatis-paginator</artifactId>  
                <version>${mybatis.paginator.version}</version>  
            </dependency>  
            <dependency>  
                <groupId>com.github.pagehelper</groupId>  
                <artifactId>pagehelper</artifactId>  
                <version>${pagehelper.version}</version>  
            </dependency>  
            <!-- MySql -->  
            <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>  
            <!-- Spring -->  
            <dependency>  
                <groupId>org.springframework</groupId>  
                <artifactId>spring-context</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>servlet-api</artifactId>  
                <version>${servlet-api.version}</version>  
                <scope>provided</scope>  
            </dependency>  
            <dependency>  
                <groupId>javax.servlet</groupId>  
                <artifactId>jsp-api</artifactId>  
                <version>${jsp-api.version}</version>  
                <scope>provided</scope>  
            </dependency>  
            <!-- 文件上傳組件 -->  
            <dependency>  
                <groupId>commons-fileupload</groupId>  
                <artifactId>commons-fileupload</artifactId>  
                <version>${commons-fileupload.version}</version>  
            </dependency>  
            <!-- Redis客戶端 -->  
            <dependency>  
                <groupId>redis.clients</groupId>  
                <artifactId>jedis</artifactId>  
                <version>${jedis.version}</version>  
            </dependency>  
            <!-- solr客戶端 -->  
            <dependency>  
                <groupId>org.apache.solr</groupId>  
                <artifactId>solr-solrj</artifactId>  
                <version>${solrj.version}</version>  
            </dependency>  
        </dependencies>  
    </dependencyManagement>  

    <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.7</source>  
                    <target>1.7</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>  
    </build> 

1.3 將spring-parent安裝到本地倉庫

2.創建spring-common

注意：我們這裏創建common項目的用途是用來放其他工程需要用到的通用組件、工具類、以及單元測試等等，可以讓整個結構體系看起來更加清晰，明確

2.1 創建工程（由於我之前建過這個項目所以我這裏只是演示下）

2.2修改pom文件

<!-- jar包的依賴 -->  
    <dependencies>  
        <!-- 時間操作組件 -->  
        <dependency>  
            <groupId>joda-time</groupId>  
            <artifactId>joda-time</artifactId>  
        </dependency>  
        <!-- Apache工具組件 -->  
        <dependency>  
            <groupId>org.apache.commons</groupId>  
            <artifactId>commons-lang3</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.apache.commons</groupId>  
            <artifactId>commons-io</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>commons-net</groupId>  
            <artifactId>commons-net</artifactId>  
        </dependency>  
        <!-- Jackson Json處理工具包 -->  
        <dependency>  
            <groupId>com.fasterxml.jackson.core</groupId>  
            <artifactId>jackson-databind</artifactId>  
        </dependency>  
        <!-- httpclient -->  
        <dependency>  
            <groupId>org.apache.httpcomponents</groupId>  
            <artifactId>httpclient</artifactId>  
        </dependency>  
        <!-- 單元測試 -->  
        <dependency>  
            <groupId>junit</groupId>  
            <artifactId>junit</artifactId>  
            <scope>test</scope>  
        </dependency>  
        <!-- 日誌處理 -->  
        <dependency>  
            <groupId>org.slf4j</groupId>  
            <artifactId>slf4j-log4j12</artifactId>  
        </dependency>  
    </dependencies>

2.3 更新工程

右鍵項目->Maven->Update Project Configuration

3.創建spring-manager

注意這是個pom工程

3.1修改pom文件

<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/xsd/maven-4.0.0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
    <parent>  
        <groupId>com.yanl</groupId>  
        <artifactId>springmvc-parent</artifactId>  
        <version>0.0.1-SNAPSHOT</version>  
    </parent>  
    <groupId>com.yanl</groupId>  
    <artifactId>spring-manager</artifactId>  
    <version>0.0.1-SNAPSHOT</version>  
    <packaging>pom</packaging>  
    <description>聚合工程，包含4個模塊三個jar模塊entity，mapper，service以及war模塊controller</description>  
    <!-- 依賴管理 -->  
    <dependencies>  
        <dependency>  
            <groupId>com.yanl</groupId>  
            <artifactId>spring-common</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
        </dependency>  
    </dependencies>  
    <modules>  
        <module>spring-manager-entity</module>  
        <module>spring-manager-mapper</module>  
        <module>spring-manager-service</module>  
        <module>spring-manager-web</module>  
    </modules>  
    <build>  
        <plugins>  
            <plugin>  
                <groupId>org.apache.tomcat.maven</groupId>  
                <artifactId>tomcat7-maven-plugin</artifactId>  
                <configuration>  
                    <port>8080</port>  
                    <path>/</path>  
                </configuration>  
            </plugin>  
        </plugins>  
    </build>  
</project> 

4.創建spring-manager-entity

注意：這是一個在manager裏面的模塊所以右鍵spring-manager項目選擇新建項目的Maven Module

5.創建spring-manager-mapper

5.1修改pom文件

<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/xsd/maven-4.0.0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
    <parent>  
        <groupId>com.yanl</groupId>  
        <artifactId>spring-manager</artifactId>  
        <version>0.0.1-SNAPSHOT</version>  
    </parent>  
    <artifactId>spring-manager-mapper</artifactId>  
    <!-- 依賴管理 -->  
    <dependencies>  
        <dependency>  
            <groupId>com.yanl</groupId>  
            <artifactId>spring-manager-entity</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
        </dependency>  
        <!-- Mybatis -->  
            <dependency>  
                <groupId>org.mybatis</groupId>  
                <artifactId>mybatis</artifactId>  
            </dependency>  
            <dependency>  
                <groupId>org.mybatis</groupId>  
                <artifactId>mybatis-spring</artifactId>  
            </dependency>  
            <dependency>  
                <groupId>com.github.miemiedev</groupId>  
                <artifactId>mybatis-paginator</artifactId>  
            </dependency>  
            <dependency>  
                <groupId>com.github.pagehelper</groupId>  
                <artifactId>pagehelper</artifactId>  
            </dependency>  
            <!-- MySql -->  
            <dependency>  
                <groupId>mysql</groupId>  
                <artifactId>mysql-connector-java</artifactId>  
            </dependency>  
            <!-- 連接池 -->  
            <dependency>  
                <groupId>com.alibaba</groupId>  
                <artifactId>druid</artifactId>  
            </dependency>  
    </dependencies>  
</project> 

6.創建spring-manager-service

6.1修改pom文件

<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/xsd/maven-4.0.0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
    <parent>  
        <groupId>com.yanl</groupId>  
        <artifactId>spring-manager</artifactId>  
        <version>0.0.1-SNAPSHOT</version>  
    </parent>  
    <artifactId>spring-manager-service</artifactId>  
    <description>service模塊</description>  
    <!-- 依賴管理 -->  
    <dependencies>  
        <dependency>  
            <groupId>com.yanl</groupId>  
            <artifactId>spring-manager-mapper</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
        </dependency>  
        <!-- Spring -->  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-context</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-beans</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-webmvc</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-jdbc</artifactId>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-aspects</artifactId>  
        </dependency>  
    </dependencies>  
</project>  

7.創建spring-manager-web（這個就是我們的前端控制器controller）

7.1修改pom文件

<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/xsd/maven-4.0.0.xsd">  
    <modelVersion>4.0.0</modelVersion>  
    <parent>  
        <groupId>com.yanl</groupId>  
        <artifactId>spring-manager</artifactId>  
        <version>0.0.1-SNAPSHOT</version>  
    </parent>  
    <artifactId>spring-manager-web</artifactId>  
    <packaging>war</packaging>  
    <!-- 依賴管理 -->  
    <dependencies>  
        <dependency>  
            <groupId>com.yanl</groupId>  
            <artifactId>spring-manager-service</artifactId>  
            <version>0.0.1-SNAPSHOT</version>  
        </dependency>  
        <!-- JSP相關 -->  
        <dependency>  
            <groupId>jstl</groupId>  
            <artifactId>jstl</artifactId>  
            <version>${jstl.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>javax.servlet</groupId>  
            <artifactId>servlet-api</artifactId>  
            <version>${servlet-api.version}</version>  
            <scope>provided</scope>  
        </dependency>  
        <dependency>  
            <groupId>javax.servlet</groupId>  
            <artifactId>jsp-api</artifactId>  
            <version>${jsp-api.version}</version>  
            <scope>provided</scope>  
        </dependency>  
        <!-- 文件上傳組件 -->  
        <dependency>  
            <groupId>commons-fileupload</groupId>  
            <artifactId>commons-fileupload</artifactId>  
            <version>${commons-fileupload.version}</version>  
        </dependency>  
    </dependencies>  
</project>  

至此我們的工程建立完成，我們需要測試這個工程能不能用還需要配置如下

8.配置tomcat插件

運行web工程需要添加一個tomcat插件。插件必須添加到spring-manager工程中。因爲spring-manager是聚合工程。在運行時需要把子工程聚合到一起才能運行。

上面在創建spring-manager時我已經配置了，這裏在配下，提醒。

<build>  
        <plugins>  
            <plugin>  
                <groupId>org.apache.tomcat.maven</groupId>  
                <artifactId>tomcat7-maven-plugin</artifactId>  
                <configuration>  
                    <port>8080</port>  
                    <path>/</path>  
                </configuration>  
            </plugin>  
        </plugins>  
    </build>  

9.運行聚合工程

看到如下，說明運行成功

然後打開http://localhost:8080/你會看到

10.1.關於mybatis分頁插件pagehelper的問題

有關分頁插件請看我之前寫過的一篇pagehelper文章。

10.2 Java編譯插件

10.3 Build時控制檯報錯，一般是提示parent，common沒有安裝，你右鍵這兩個項目安裝下在運行spring-manager就可以了。

10.4 需要用到的倉庫我上傳到我的資源裏面了（由於文件太大，我傳百度網盤了，傳送門 http://pan.baidu.com/s/1cmrIgu），如果maven下載不了直接將這個倉庫覆蓋你自己的本地倉庫，一般本地倉庫在C盤用戶.m2文件夾下，祝你成功。

10.5 需要用到的倉庫我上傳到我的資源裏面了（由於文件太大，我傳百度網盤了，傳送門 http://pan.baidu.com/s/1cmrIgu），如果maven下載不了直接將這個倉庫覆蓋你自己的本地倉庫，一般本地倉庫在C盤用戶.m2文件夾下，祝你成功。