分享

Maven编译代码的相关命令

 niefeng2011 2013-12-17


第一、main目录下的主代码编写完毕后,使用Maven进行编译,在项目根目录下运行命令mvn clean compile
      行项目编译。
第二、test目录下的测试用例编写完毕之后就可以调用Maven执行测试,运行mvn clean test进行测试。
第三、将项目进行编译、测试之后,下一个重要步骤就是打包(package)。在pom.xml中定义
      <packaging>war</packaging>标签表示将要把工程打成什么类型的包(默认是jar类型),我们可以简单地
      执行命令mvn clean package进行打包。
第四、war插件的war目标将项目主代码打包成一个名为<artifactId>S3h3WebWs</artifactId>标签中的定义-
      <version>0.0.1-SNAPSHOT</version>标签中的定义.war的文件
      (最终的jar文件是S3h3WebWs-0.0.1-SNAPSHOT.war),该文件也位于target/输出目录中,它是根据
      artifact-version.jar规则进行命名的,如有需要,我们还可以使用finalName来自定义该文件的名称。
第五、至此,我们得到了项目的输出,如果我们把项目打成了jar文件并且需要在其他项目中使用的话,就可以
      复制这个jar文件到其他项目的Classpath中从而使用这个项目中的类。但是,如何才能让其他的Maven项
      目直接引用这个jar呢?我们还需要一个安装的步骤,执行mvn clean install命令。
第六、我们已经将体验了Maven最主要的命令:mvn clean compilemvn clean test
     mvn clean packagemvn clean install。执行test之前是会先执行compile的,执行package之前是
      会先执行test的,而类似地,install之前会执行package。
第七、如果项目中有一个拥有main方法的类需要被调用执行。默认打包生成的jar是不能够直接运行的main方法
      的,因为带有main方法的类信息不会添加到manifest中(我们可以打开jar文件中的META-INF/MANIFEST.MF
      文件,将无法看到Main-Class一行)。为了生成可执行的jar文件,我们需要借助maven-shade-plugin插
      件,配置该插件如下:
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>1.2.1</version>
        <executions>
            <execution>
                <phase>package</phase>
                <goals>
                    <goal>shade</goal>
                </goals>
                <configuration>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <mainClass>com.todaytech.framework.utils.VoConvertXmlUtils</mainClass>
                        </transformer>
                    </transformers>
                </configuration>
            </execution>
        </executions>
     </plugin>

     plugin元素在POM中的相对位置应该在<project><build><plugins>下面。我们配置了mainClass
     com.todaytech.framework.utils.VoConvertXmlUtils ,项目在打包时会将该信息放到MANIFEST中。现
     在执行 mvn clean install,待构建完成之后打开target/目录,我们可以看到
     S3h3WebWs-0.0.1-SNAPSHOT.jaroriginal-S3h3WebWs-0.0.1-SNAPSHOT.jar,前者是带有Main-Class信息
     的可运行jar,后者是原始的jar,打开hello-world-1.0-SNAPSHOT.jar的META-INF/MANIFEST.MF,可以看      到它包含这样一行信息:Main-Class: com.todaytech.framework.utils.VoConvertXmlUtils
     现在,我们在项目根目录中执行该jar文件:
     D: codeS3h3WebWs>java -jar targetS3h3WebWs-0.0.1-SNAPSHOT.jar
     Hello Maven
     控制台输出为Hello Maven,这正是我们所期望的。
第八、使用maven archetype来创建该项目的骨架,离开当前的Maven项目目录。
      如果是Maven 3,简单的运行:
      mvn archetype:generate
      如果是Maven 2,最好运行如下命令:
      mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-5:generate
      很多资料会让你直接使用更为简单的 mvn archetype:generate 命令,但在Maven2中这是不安全的,因为
      该命令没有指定archetype插件的版本,于是Maven会自动去下载最新的版本,进而可能得到不稳定的
      SNAPSHOT版本,导致运行失败。然而在Maven 3中,即使用户没有指定版本,Maven也只会解析最新的稳定
      版本,因此这是安全的。
      我们实际上是在运行插件maven-archetype-plugin,注意冒号的分隔,其格式为
      groupId:artifactId:version:goal,org.apache.maven.plugins是maven官方插件的groupId,
      maven-archetype-plugin是archetype插件的artifactId,2.0-alpha-5是目前该插件最新的稳定版,
      generate是我们要使用的插件目标。
      紧接着我们会看到一段长长的输出,有很多可用的archetype供我们选择,包括著名的Appfuse项目的
      archetype,JPA项目的archetype等等。每一个archetype前面都会对应有一个编号,同时命令行会提示一
      个默认的编号,其对应的archetype为maven-archetype-quickstart,我们直接回车以选择该archetype,
      紧接着Maven会提示我们输入要创建项目的groupId、artifactId、 version、以及包名package。
--------------------------------------------------------------------------------------------------

生成清除Eclipse项目结构:
mvn eclipse:eclipse
mvn eclipse:clean

清理(删除target目录下编译内容):
mvn clean

仅打包Web页面文件:
mvn war:exploded

打包时跳过测试:
mvn package -Dmaven.test.skip=ture

跳过测试运行maven任务:    

mvn -Dmaven.test.skip=true XXX

 

创建Maven的普通java项目(只适用于Maven2.x版本): 
mvn archetype:create -DgroupId=packageName -DartifactId=projectName

创建Maven的Web项目(只适用于Maven2.x版本):   

mvn archetype:create  -DgroupId=packageName -DartifactId=webappName DarchetypeArtifactId=maven-archetype-webapp

创建Maven的Web项目(只适用于Maven3.x版本):

C:Documents and SettingsAdministrator>f:
F:>cd F:SoftWareMavenMavenWebAppTest
F:SoftWareMavenMavenWebAppTest>mvn archetype:generate -DgroupId=com.shihuan -DartifactId=S3h3WebWs -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

创建Maven的Quickstart项目(只适用于Maven3.x版本):

C:Documents and SettingsAdministrator>f:
F:>cd F:SoftWareMavenMavenWebAppTest
F:SoftWareMavenMavenWebAppTest>mvn archetype:generate -DgroupId=com.shihuan -DartifactId=S3h3WebWs -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false


查看详细日志信息命令:
mvn archetype:create -Dgroupid=com.shihuan -Dartifactid=S3h3WebWs -e -DarchetypeArtifactid=maven-archetype-webapp
或者
mvn archetype:create -Dgroupid=com.shihuan -Dartifactid=S3h3WebWs -X -DarchetypeArtifactid=maven-archetype-webapp

编译源代码: mvn compile

编译测试代码:mvn test-compile
运行测试:mvn test
生成站点目录: mvn site
生成站点目录并发布:mvn site-deploy
安装当前工程的输出文件到本地仓库: mvn install
安装指定文件到本地仓库:mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=1.0.0 -Dpackaging=jar -Dfile=<myfile.jar>
查看实际pom信息: mvn help:effective-pom
分析项目的依赖信息:mvn dependency:analyze 或 mvn dependency:tree
查看帮助信息:mvn help:help 或 mvn help:help -Ddetail=true
查看插件的帮助信息:mvn <plug-in>:help,比如:mvn dependency:help 或 mvn ant:help

生成eclipse项目:mvn eclipse:eclipse

生成idea项目:mvn idea:idea

组合使用goal命令,如只打包不测试:mvn -Dtest package

只打jar包: mvn jar:jar

只测试而不编译,也不测试编译:mvn test -skipping compile -skipping test-compile

在pom.xml文件中增加servlet容器的插件:

<build>
   <plugins>
       <plugin>
           <groupId>org.codehaus.mojo</groupId>
           <artifactId>tomcat-maven-plugin</artifactId>
       </plugin>
       <plugin>
           <groupId>org.mortbay.jetty</groupId>
           <artifactId>maven-jetty-plugin</artifactId>
           <version>6.1.6</version>
       </plugin>
       <plugin>
           <artifactId>maven-compiler-plugin</artifactId>
           <configuration>
               <source>1.6</source>
               <target>1.6</target>
               <encoding>UTF-8</encoding>
           </configuration>
        </plugin>
    </plugins>
</build>

 

 


启动tomcat:

mvn tomcat:run

 

启动jetty: 

mvn jetty:run


 

转化为eclipse项目:

mvn -Dwtpversion=1.5 eclipse:eclipse

 

这样生成wtp插件的web项目。

打开eclipse,菜单选择:file>import>general>existing projects into workspace,在对话框中选中目录,导入即可。

另外,需要在eclipse里创建一个classpath变量,名称为:M2_REPO,值为系统用户下.m2/repository目录。


packaging : 打包的格式可以为:pom , jar , maven-plugin , ejb , war , ear , rar , par


 

POM间关系: 依赖关系(dependencies)、继承关系(parent)、聚合关系(modules)。

依赖关系举例
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate</artifactId>
    <version>3.2.6.ga</version>
</dependency>

继承关系举例

继承其他pom.xml配置的内容。
maven提供了一个类似java.lang.Object的顶级父pom.xml文件。
可以通过下面命令查看当前pom.xml受到超pom.xml文件的影响:mvn help:effective-pom


创建一个各种项目可复用的pom.xml文件:http://easymorse./svn/trunk/pom/pom.xml
部署要复用的pom.xml文件:mvn install 
在自己的pom文件中继承上述pom:
<parent>
    <groupId>com.easymorse</groupId>
    <artifactId>pom</artifactId>
    <version>0.1</version>
</parent>

聚合关系举例
用于将多个maven项目聚合为一个大的项目。
比如目录结构如下: 
.
|-- pom.xml
|-- module-a
    `-- pom.xml
|-- module-b
    `-- pom.xml
|-- module-c
    `-- pom.xml
|-- foo-all
    `-- pom.xml
 
那么总的pom.xml文件类似: 
...
    <modules>
        <module>module-a</module>
        <module>module-b</module>
        <module>module-c</module>
        <module>foo-all</module>
    </modules>
</project>

把项目部署到tomcat下的做法:
tomcat配置有管理权限的用户:conftomcat-users.xml。 
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager"/>
  <user username="marshal" password="password" roles="manager"/>
</tomcat-users>
 
在pom文件的tomcat插件中添加:
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>tomcat-maven-plugin</artifactId>
    <configuration>
        <url>http://localhost:8080/manager</url>
        <server>myserver</server>
        <path>/mycontext</path>
    </configuration>
</plugin>
 
在.m2/settings.xml文件中增加:
<settings xmlns="http://maven./POM/4.0.0"
        xmlns:xsi="http://www./2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven./POM/4.0.0
http://maven./xsd/settings-1.0.0.xsd">
        <servers>
            <server>
                <id>myserver</id>
                <username>marshal</username>
                <password>password</password>
            </server>
        </servers>
</settings>
 
运行打包部署,在maven项目目录下: 
mvn tomcat:deploy
 
然后访问:http://localhost:8080/mycontext/ 即可。
撤销部署: 
mvn tomcat:undeploy
 
启动web应用:
mvn tomcat:start
 
停止web应用:
mvn tomcat:stop
 
重新部署:
mvn tomcat:redeploy
 
部署展开的war文件: 
mvn war:exploded tomcat:exploded

--------------------------------------------------------------------------------------

pom是指project object Model。pom是一个xml,在maven2里为pom.xml。是maven工作的基础,在执行task或者goal时,maven会去项目根目录下读取pom.xml获得需要的配置信息
pom文件中包含了项目的信息和maven build项目所需的配置信息,通常有项目信息(如版本、成员)、项目的依赖、插件和goal、build选项等等。
pom是可以继承的,通常对于一个大型的项目或是多个module的情况,子模块的pom需要指定父模块的pom。
project pom文件的顶级元素。
modelVersion 所使用的object model版本,为了确保稳定的使用,这个元素是强制性的。除非maven开发者升级模板,否则不需要修改。
groupId 是项目创建团体或组织的唯一标志符,通常是域名倒写,如groupId  org.apache.maven.plugins就是为所有maven插件预留的。
artifactId 是项目artifact唯一的基地址名。
packaging artifact打包的方式,如jar、war、ear等等。默认为jar。这个不仅表示项目最终产生何种后缀的文件,也表示build过程使用什么样的<a href="http://maven./guides/introduction/introduction-to-the-lifecycle.html#Built-in_Lifecycle_Bindings" target="_blank">lifecycle</a>。
version artifact的版本,通常能看见为类似0.0.1-SNAPSHOT,其中SNAPSHOT表示项目开发中,为开发版本。
name 表示项目的展现名,在maven生成的文档中使用。
url表示项目的地址,在maven生成的文档中使用。
description 表示项目的描述,在maven生成的文档中使用。
dependencies 表示依赖,在子节点dependencies中添加具体依赖的groupId artifactId和version。
build 表示build配置。
parent 表示父pom。
其中groupId:artifactId:version唯一确定了一个artifact。



Artifact
这个有点不好解释,大致说就是一个项目将要产生的文件,可以是jar文件,源文件,二进制文件,war文件,甚至是pom文件。每个artifact都由groupId:artifactId:version组成的标识符唯一识别。需要被使用(依赖)的artifact都要放在仓库(见Repository)中。



Repositories
Repositories是用来存储Artifact的。如果说我们的项目产生的Artifact是一个个小工具,那么Repositories就是一个仓库,里面有我们自己创建的工具,也可以储存别人造的工具,我们在项目中需要使用某种工具时,在pom中声明dependency,编译代码时就会根据dependency去下载工具(Artifact,供自己使用。
对于自己的项目完成后可以通过mvn install命令将项目放到仓库(Repositories)中
仓库分为本地仓库和远程仓库,远程仓库是指远程服务器上用于存储Artifact的仓库,本地仓库是指本机存储Artifact的仓库,对于windows机器本地仓库地址为系统用户的.m2/repository下面。



Build Lifecycle
是指一个项目build的过程。maven的Build Lifecycle分为三种,分别为default(处理项目的部署)、clean(处理项目的清理)、site(处理项目的文档生成)。他们都包含不同的lifecycle
Build Lifecycle是由phases构成的,下面重点介绍default Build Lifecycle几个重要的phase:
validate 验证项目是否正确以及必须的信息是否可用;
compile 编译源代码;
test 测试编译后的代码,即执行单元测试代码;
package 打包编译后的代码,在target目录下生成package文件;
integration-test 处理package以便需要时可以部署到集成测试环境;
verify 检验package是否有效并且达到质量标准;
install 安装package到本地仓库,方便本地其它项目使用;
deploy 部署,拷贝最终的package到远程仓库和替他开发这或项目共享,在集成或发布环境完成

以上的phase是有序的(注意实际两个相邻phase之间还有其他phase被省略,完整phase见lifecycle),下面一个phase的执行必须在上一个phase完成后
若直接以某一个phase为goal,将先执行完它之前的phase,如mvn install
将会先validate、compile、test、package、integration-test、verify最后再执行install phase。



Goal
goal代表一个特定任务
goal represents specific task (finer than build phase) which contributes to the building and managing of project. 


mvn package表示打包的任务,通过上面的介绍我们知道,这个任务的执行会先执行package phase之前的phase
mvn deploy表示部署的任务
mven clean install则表示先执行clean的phase(包含其他子phase),再执行install的phase。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多