zoukankan      html  css  js  c++  java
  • maven项目构建

    Maven是apache的一个开源项目。是一个用来把源代码构建成可发布的构件的工具。

    Maven的功能非常强大,可以认为是一个项目管理工具,不仅仅是一个构建工具。

    Maven本身的核心很小,但是可以在上面扩展出很多的插件。Mven采用的是插件的思想,通过插件的功能扩展出很多的功能。同时Maven采用约定大于配置的思想,在项目中采用了很多约定规则来减少配置。不想ant这样的构建工具需要很多的配置。作为一个项目构建工具,最重要的是管理项目的库和项目之间的依赖关系。

    本文将以以下面的例子,来作为学习maven的一个过程。

    假设要构建一个名为Content-Search的项目,该项目包含了三个子项目:contentSearch-dal,contentSearch-biz,contentSearch-web。项目采用Struts2、hibernate3、spring2.5的框架结合。使用mysql数据库。

    contentSearch-web:Web层的代码, struts2+spring2.5结合的框架。

    contentSearch-biz:业务逻辑层代码。

    contentSearch-dal:数据持久层代码。

    三个项目之间的依赖和对外部库的依赖关系大概如下:

    作为从一个项目构建工具角度出发,maven主要要实现的就是项目的依赖的二方、三方库管理,项目之间的依赖管理。以及项目的整个生命周期的管理,包括编译(compile)、测试(test)、打包(packaging)、部署(install)等。

    以以上为背景,先介绍下maven的基本概念:

    依赖管理:对每个项目对外部的依赖的管理。

    远程仓库:maven外部引用仓库的管理。

    项目LifeCycle抽象和管理:项目生命周期编译、测试和打包等过程的抽象和管理。

    1. 1. Maven安装

    http://maven.apache.org/download.html在上面根据不同的操作系统选择不同的安装版本。

    安装后的目录结构如下:

    bin/:maven脚本

    boot/

    conf/:全局的settings.xml。 如果需要自己定制可以覆盖.m2文件夹里的settings.xml文件。

    lib/:有包含maven核心的jar文件

    设置环境变量: M2_HOME=maven安装路径  Path: $M2_HOME/bin

    1. 2. Maven核心概念

    groupId , artifactId, packaging, version:—— 以上4个是 Maven 的 坐 标(coordinates),它们唯一标识了一个项目。

    groupId: 团体,公司,小组,组织,项目,或者其它团体。如contentSearch-web,contentSearch-dal,contentSearch-biz同属一个groupId。

    artifactId:在 groupId 下的表示一个单独项目的唯一标识符。项目名称ID 。

    packaging: 标识项目的类型,如jar,war等。

    Version:版本号。

    以文章开头的例子为例,contentSearch-web的坐标可以定义如下:

    groupId: com.companyName.contentSearch

    artifactId:contentSearch-web

    packaging: war

    Version:1.0。

    而contentSearch-dal的坐标如下:

    groupId: com.companyName.contentSearch

    artifactId:contentSearch-dal

    packaging: jar

    Version:1.0。

    在一个 Maven 仓库中,所有的东西存储在一个与 Maven 项目坐标十分匹配的目录结构中。

    /groupId/artifactId/version/artifactId-version.packaging.

    POM:项目抽象模型

    这是maven非常核心的概念。Maven通过它来管理项目。每一个项目都有一个pom.xml文件,该文件定义了改项目的基本信息,依赖关系等,maven对项目的生命周期管理也是基于此文件。以contentSearch-dal为例,该项目的pom.xml定义如下(关于pom.xml里面各项的含义,本文不做过多介绍,相信看了基本都能清楚。):

    <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>

             <parent>

                       <groupId> com.companyName.contentSearch</groupId>

                       <artifactId>contentSearch</artifactId>

                       <version>1.0</version>

             </parent>

             <artifactId>contentSearch-dal</artifactId>

             <packaging>jar</packaging>

             <version>1.0</version>

             <name>contentSearch-dal</name>

             <url>http://maven.apache.org</url>

             <dependencies>

                       <dependency>

                                <groupId>junit</groupId>

                                <artifactId>junit</artifactId>

                                <version>3.8.1</version>

                                <scope>test</scope>

                       </dependency>

                       <dependency>

                                <groupId>generalorm</groupId>

                                <artifactId>hibernate</artifactId>

                                <version>3.0</version>

                       </dependency>

                       <dependency>

                                <groupId>mysql</groupId>

                                <artifactId>mysql-connector-java</artifactId>

                                <version>5.1.6</version>

                       </dependency>

                       <dependency>

                                <groupId>log4j</groupId>

                                <artifactId>log4j</artifactId>

                                <version>1.2.14</version>

                       </dependency>

                       <dependency>

                                <groupId>dom4j</groupId>

                                <artifactId>dom4j</artifactId>

                                <version>1.6.1</version>

                       </dependency>

                       <dependency>

                                <groupId>slf4j</groupId>

                                <artifactId>slf4j-api</artifactId>

                                <version>1.5.8</version>

                       </dependency>

                       <dependency>

                                <groupId>slf4j</groupId>

                                <artifactId>slf4j-nop</artifactId>

                                <version>1.5.2</version>

                       </dependency>

                       <dependency>

                                <groupId>antlr</groupId>

                                <artifactId>antlr</artifactId>

                                <version>2.7.6</version>

                       </dependency>

                       <dependency>

                                <groupId>jta</groupId>

                                <artifactId>jta</artifactId>

                                <version>1.1</version>

                       </dependency>

                       <dependency>

                                <groupId>javassist</groupId>

                                <artifactId>javassist</artifactId>

                                <version>3.9.0.GA</version>

                       </dependency>

                       <dependency>

                                <groupId>commons-collections</groupId>

                                <artifactId>commons-collections</artifactId>

                                <version>3.1</version>

                       </dependency>

             </dependencies>

    </project>

    Repository

    仓库,二方库,三方库的概念。每当安装完成maven之后就会有一个默认的本地仓库和远程仓库。本地仓库在用户工作目录下的.m2文件夹,如在linux下为/home/yblin/.m2。远程repository默认在settings.xml里面配置,如果要修改该文件必须在.m2文件夹下面替换一下即可。当进行编译的时候,maven会先查找本地Repository,如果本地Repository没有,会去取远程repository 。

     

    1. 3. Maven命令

    创建一个项目:

    mvn archetype:create -DgroupId=com.xxx.simple  - DartifactId =simple

    archetype:create是一个goal,-DgroupId=org.sonatype.mavenbook.ch03代表要传到目标goal任务的参数,以-D开头。

    插件和目标:maven archetype:create. Archetype是插件标识,create是目标标识。

    一个 Maven 插件是一个单个或者多个目标的集合。Maven 插件的例子有一些简单但核心的插件,像 Jar 插件,它包含了一组创建JAR 文件的目标,Compiler插件,它包含了一组编译源代码和测试代码的目标,或者 Surefire 插件,它包含一组运行单元测试和生成测试报告的目标。而其它的,更有专门的插件包括:Hibernate3 插件,用来集成流行的持久化框架 Hibernate,JRuby 插件,它让你能够让运行 ruby 称为 Maven 构建的一部分或者用 Ruby 来编写 Maven 插件。Maven也提供了自定义插件的能力。一个定制的插件可以用 Java 编写,或者用一些其它的语言如 Ant,Groovy,beanshell 和之前提到的 Ruby。

    生命周期命令:maven install

    Mvn install命令没有进行任何插件配置或者定制,所以这个例子绑定了一组标准插件的目标到默认的生命周期。当 Maven 经过以 package 为结尾的默认生命周期的时候,下面的目标按顺序被执行:

    resources:resources

          Resources 插件的 resources 目标绑定到了 resources 阶段。这个目标复

          制 src/main/resources 下的所有资源和其它任何配置的资源目录,到输

          出目录。

    compiler:compile

          Compiler 插件的 compile 目标绑定到了 compile 阶段。这个目标编译

          src/main/java 下的所有源代码和其他任何配置的资源目录,到输出目

          录。

    resources:testResources

          Resources 插件的 testResources 目标绑定到了 test-resources 阶段。

          这个目标复制 src/test/resources 下的所有资源和其它任何的配置的测

          试资源目录,到测试输出目录。

    compiler:testCompile

          Compiler 插件的 testCompile 目标绑定到了 test-compile 阶段。这个目

          标编译 src/test/java 下的测试用例和其它任何的配置的测试资源目录,

          到测试输出目录。

    surefire:test

          Surefire 插件的 test 目标绑定到了 test 阶段。这个目标运行所有的测试

          并且创建那些捕捉详细测试结果的输出文件。默认情况下,如果有测试失

          败,这个目标会终止。

    jar:jar

          Jar 插件的 jar 目标绑定到了 package 阶段。这个目标把输出目录打包成

          JAR 文件。

    当 Maven 运行一个目标的时候,每个目标都会访问定义在项目 POM 里的信息。

    其他命令:

    mvn install:install-file -DgeneratePom=true -DgroupId=jep -DartifactId=jep -Dversion=3.3.0 -Dpackaging=jar -Dfile=E:/lib/LIB_COMMON/jep-3.3.0-trial.jar:添加一个包到依赖库。

    mvn dependency:resolve  mvn dependency:tree浏览项目依赖。

    mvn archetype:create :创建 Maven 项目

    mvn compile :编译源代码

    mvn test-compile :编译测试代码

    mvn test : 运行应用程序中的单元测试

    mvn site : 生成项目相关信息的网站

    mvn clean :清除目标目录中的生成结果

    mvn package : 依据项目生成 jar 文件

    mvn install :在本地 Repository 中安装 jar

    mvn eclipse:eclipse :生成 Eclipse 项目文件

    1. 4. Maven实践

     

    以文章开头例子为例,做为实践。

    1. 下载依赖包,并添加到本地repository.如果配置了远程依赖库里面已经有了这些依赖包,那无需下载,在编译时会自动下载到本地库。

    下载struts2,hibernate2,spring2.5,mysql-jdbc等相关的包到本地,通过命令安装到本地repository.

    mvn install:install-file -DgrouptId=framework -DartifactId=spring-beans -Dversion=2.5.6 -Dfile=spring-beans-2.5.6.jar

    该命令将spring-beans-2.5.6.jar安装到本地repository.

    2. 创建总控项目

    mvn archetype:create命令创建总控项目,修改pom.xml文件如下:

    <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> com.companyName.contentSearch </groupId>

      <artifactId>contentSearch</artifactId>

      <packaging>pom</packaging>

      <version>1.0</version>

      <name>Chapter 6 Simple Parent Project</name>

      <modules>

        <module>contentSearch-dal</module>

        <module>contentSearch-biz</module>

        <module>contentSearch-web</module>

      </modules>

      <build>

        <pluginManagement>

          <plugins>

            <plugin>

              <groupId>org.apache.maven.plugins</groupId>

              <artifactId>maven-compiler-plugin</artifactId>

              <configuration>

                <source>1.5</source>

                <target>1.5</target>

              </configuration>

            </plugin>

          </plugins>

       </pluginManagement>

      </build>

      <dependencies>

        <dependency>

          <groupId>junit</groupId>

          <artifactId>junit</artifactId>

          <version>3.8.1</version>

          <scope>test</scope>

        </dependency>

      </dependencies>

    </project>

    3. 创建子项目

    总控项目包括了三个子项目,在总控项目文件夹下面创建3个子项目如下:

    contentSearch-dal:

    <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>

    <parent>

         <groupId> com.companyName.contentSearch </groupId>

         <artifactId>contentSearch</artifactId>

         <version>1.0</version>

    </parent>

    <artifactId>contentSearch-dal</artifactId>

    <packaging>jar</packaging>

    <version>1.0</version>

    <name>contentSearch-dal</name>

    <url>http://maven.apache.org</url>

    <dependencies>

         <dependency>

             <groupId>junit</groupId>

             <artifactId>junit</artifactId>

             <version>3.8.1</version>

             <scope>test</scope>

         </dependency>

         <dependency>

             <groupId>generalorm</groupId>

             <artifactId>hibernate</artifactId>

             <version>3.0</version>

         </dependency>

         <dependency>

             <groupId>mysql</groupId>

             <artifactId>mysql-connector-java</artifactId>

             <version>5.1.6</version>

         </dependency>

         <dependency>

             <groupId>log4j</groupId>

             <artifactId>log4j</artifactId>

             <version>1.2.14</version>

         </dependency>

         <dependency>

             <groupId>dom4j</groupId>

             <artifactId>dom4j</artifactId>

             <version>1.6.1</version>

         </dependency>

         <dependency>

             <groupId>slf4j</groupId>

             <artifactId>slf4j-api</artifactId>

             <version>1.5.8</version>

         </dependency>

         <dependency>

             <groupId>slf4j</groupId>

             <artifactId>slf4j-nop</artifactId>

             <version>1.5.2</version>

         </dependency>

         <dependency>

             <groupId>antlr</groupId>

             <artifactId>antlr</artifactId>

             <version>2.7.6</version>

         </dependency>

         <dependency>

             <groupId>jta</groupId>

             <artifactId>jta</artifactId>

             <version>1.1</version>

         </dependency>

         <dependency>

             <groupId>javassist</groupId>

             <artifactId>javassist</artifactId>

             <version>3.9.0.GA</version>

         </dependency>

         <dependency>

             <groupId>commons-collections</groupId>

             <artifactId>commons-collections</artifactId>

             <version>3.1</version>

         </dependency>

    </dependencies>

    </project>

    contentSearch-biz:

    <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>

    <parent>

         <groupId> com.companyName.contentSearch</groupId>

         <artifactId>contentSearch</artifactId>

         <version>1.0</version>

    </parent>

    <artifactId>contentSearch-biz</artifactId>

    <packaging>jar</packaging>

    <version>1.0</version>

    <name>contentSearch-biz</name>

    <url>http://maven.apache.org</url>

    <dependencies>

         <dependency>

             <groupId>junit</groupId>

             <artifactId>junit</artifactId>

             <version>3.8.1</version>

             <scope>test</scope>

         </dependency>

         <dependency>

             <groupId> com.companyName.contentSearch </groupId>

             <artifactId>contentSearch-dal</artifactId>

             <version>1.0</version>

             <scope></scope>

         </dependency>

         <dependency>

             <groupId>com.sun</groupId>

             <artifactId>mail</artifactId>

             <version>1.4.3</version>

             <scope></scope>

         </dependency>

         <dependency>

             <groupId>com.sun</groupId>

             <artifactId>activation</artifactId>

             <version>1.1.1</version>

             <scope></scope>

         </dependency>

    </dependencies>

    </project>

    contentSearch-web:

    <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>

    <parent>

         <groupId> com.companyName.contentSearch </groupId>

         <artifactId>contentSearch</artifactId>

         <version>1.0</version>

    </parent>

    <artifactId>contentSearch-web</artifactId>

    <packaging>war</packaging>

    <version>1.0-SNAPSHOT</version>

    <name>contentSearch-web Maven Webapp</name>

    <url>http://maven.apache.org</url>

    <dependencies>

         <dependency>

             <groupId>apache.tomcat</groupId>

             <artifactId>servlet-api</artifactId>

             <version>2.5</version>

         </dependency>

         <dependency>

             <groupId>apache.commons</groupId>

             <artifactId>commons-fileupload</artifactId>

             <version>1.2.1</version>

         </dependency>

         <dependency>

             <groupId>commons-logging</groupId>

             <artifactId>commons-logging</artifactId>

             <version>1.0.4</version>

         </dependency>

         <dependency>

             <groupId>apache.tomcat</groupId>

             <artifactId>jsp-api</artifactId>

             <version>1.0</version>

         </dependency>

         <dependency>

             <groupId>junit</groupId>

             <artifactId>junit</artifactId>

             <version>3.8.1</version>

             <scope>test</scope>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>struts2-core</artifactId>

             <version>2.1.8</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>xwork-core</artifactId>

             <version>2.1.6</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>spring-core</artifactId>

             <version>2.5.6</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>spring-web</artifactId>

             <version>2.5.6</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>spring-context</artifactId>

             <version>2.5.6</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>spring-beans</artifactId>

             <version>2.5.6</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>freemarker</artifactId>

             <version>2.3.15</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>struts2-spring-plugin</artifactId>

             <version>2.1.8</version>

         </dependency>

         <dependency>

             <groupId> com.companyName.contentSearch </groupId>

             <artifactId>contentSearch-biz</artifactId>

             <version>1.0</version>

         </dependency>

         <dependency>

             <groupId>framework</groupId>

             <artifactId>struts2-json-plugin</artifactId>

             <version>2.1.8</version>

         </dependency>

    </dependencies>

    <build>

         <finalName>contentSearch-web</finalName>

         <plugins>

             <plugin>

                 <groupId>org.mortbay.jetty</groupId>

                 <artifactId>maven-jetty-plugin</artifactId>

                 <version>6.1.9</version>

             </plugin>

         </plugins>

    </build>

    </project>

    4. 编写代码,打包运行。

    mvn clean install

    mvn jetty:run

    以上只是从构建的角度介绍maven的使用,还有很多其他的特性待以后学习后再做介绍。作为一个优秀的构建工具,maven还是值得推荐的。

    http://maven.apache.org/guides/ 

    附上官网上的指南地址。

  • 相关阅读:
    大胆决定+细致用功, 才可能改变命运
    采用用同步编程的方式实现跨进程异步获取数据
    关于DataGridViewComboBoxCell修改后提交数据源
    学习:如何具有坚韧的性格
    汉语-成语:坚韧不拔
    汉语-词语:坚韧
    阿里云-OSS-Help-SKD参考-.NET:前言
    阿里云-OSS-OSS管理控制台:Bucket列表
    阿里云-OSS-OSS管理控制台:概览
    汉语-词语:推理
  • 原文地址:https://www.cnblogs.com/langren1992/p/5221993.html
Copyright © 2011-2022 走看看