1. 用Maven 命令创建一个简单的 Maven 项目
在cmd中运行如下命令:
mvn archetype:generate
-DgroupId=com.mycompany.app
-DartifactId=my-app
-Dversion=1.0
-DarchetypeArtifactId=maven-archetype-quickstart
即可在当前目录创建一个简单的 maven 项目,创建的时候会从Maven库中下载相关的依赖。
执行成功后,进入创建的 my-app 目录,打开 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.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<packaging>jar</packaging>
<version>1.0</version>
<name>my-app-simple</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
POM 包含了一个 project 所需要的所有信息,包括配置文件;开发者需要遵循的规则,缺陷管理系统,组织和licenses,项目的url,项目的依赖性,以及其他所有的项目相关因素。
我们开发Maven项目的时候,需要为其定义适当的坐标,在这个基础上,其他Maven项目才能应用该项目生成的构件。Maven坐标为各种构件引入了秩序,任何一个构件都必须明确定义自己的坐标,而一组Maven坐标是通过一些元素定义的,它们是groupId,artifactId,version,packaging,class-sifer。其中,前三个是必须的,packaging 是可选的,而 classfier 是不能直接定义的。
下面是一组坐标定义:
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<packaging>jar</packaging>
<version>1.0</version>
groupId :定义当前Maven项目隶属的实际项目。首先,Maven项目和实际项目不一定是一对一的关系。比如SpringFrameWork这一实际项目,其对应的Maven项目会有很多,如spring-core,spring-context等。这是由于Maven中模块的概念,因此,一个实际项目往往会被划分成很多模块。其次,groupId不应该对应项目隶属的组织或公司。原因很简单,一个组织下会有很多实际项目,如果groupId只定义到组织级别,而后面我们会看到,artifactId只能定义Maven项目(模块),那么实际项目这个层次将难以定义。最后,groupId的表示方式与Java包名的表达方式类似,通常与域名反向一一对应。
artifactId : 该元素定义当前实际项目中的一个Maven项目(模块),推荐的做法是使用实际项目名称作为artifactId的前缀。比如上例中的my-app。
version : 该元素定义Maven项目当前的版本
packaging :定义Maven项目打包的方式,首先,打包方式通常与所生成构件的文件扩展名对应,如上例中的packaging为jar,最终的文件名为my-app-1.0.jar。也可以打包成war, ear等。当不定义packaging的时候,Maven 会使用默认值 jar
classifier: 该元素用来帮助定义构建输出的一些附件。附属构件与主构件对应,如上例中的主构件为my-app-1.0.jar,该项目可能还会通过一些插件生成如my-app-1.0-javadoc.jar,my-app-1.0-sources.jar, 这样附属构件也就拥有了自己唯一的坐标
2.maven 基本命令
编译:compile
在cmd中,将目录切换到 my-app 下,执行mvn clean compile
build success之后我们会在my-app 下看到新增了一个target目录,该目录下存放项目编译后的文件,如.class文件
清理:clean
cmd目录my-app下执行命令 mvn clean
会将target文件删除,即清理项目,该命令可以结合其他命令运行
测试:test
cmd 目录 my-app 下执行命令 mvn test
会执行src/test/java 下的Junit 测试代码,在执行测试之前会自动执行编译命令。
打包:package
cmd 目录 my-app 下执行命令 mvn package
会将项目打成jar包,并放在target目录中
执行此命令之前会先执行编译和测试命令
安装:install
cmd 目录 my-app 下执行命令 mvn install
会将项目jar包安装到本地仓库中,以便其他项目使用
执行此命令之前会先执行编译,测试,打包命令
3.创建自定义archetype
创建一个新的 maven 项目,将配置好的公共文件放到相应目录。
注意:上面要生成模版的项目的版本号不能带-SNAPSHOT,否则找不到的,直接用数字1.0等就可以了。
编辑 pom.xml,添加插件
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-archetype-plugin</artifactId>
<version>2.2</version>
</plugin>
</plugins>
打开 cmd 窗口,进入刚才创建的 maven project 的根目录,运行maven命令:
mvn archetype:create-from-project
然后会在target目录下面生成 generated-sources 目录,这个就是生成的 archetype,
进入到 archetype 目录,找到 pom.xml 文件,可修改该文件,增加 deploy 的设置,比如公司有 maven repository manager 服务器,以后就可以将该archetype部署到公司服务器上,便于其他人使用。比如:
<distributionManagement>
<repository>
<id>releases</id>
<name>MyCo Internal Repository</name>
<url>http://192.168.200.88:9001/nexus/content/repositories/releases</url>
</repository>
<snapshotRepository>
<id>snapshots</id>
<name>MyCo Internal Repository</name>
<url>http://192.168.200.88:9001/nexus/content/repositories/snapshots</url>
</snapshotRepository>
</distributionManagement>
部署到公司服务器的命令:
mvn deploy
安装到本地仓库
mvn install
archetype安装的地址是在maven安装目录下面的conf/settings.xml文件中指定的(<localRepository>字节)。
默认会在 ~/.m2 目录下面生成一个archetype-catalog.xml文件(和默认的settings.xml在同一个目录),声明了该archetype的groupId、artifactId和其他属性。如果没有找到,则保存在默认 ~/.m2 目录下。
Eclipse创建maven项目过程中,选择的“Default Local”指向的地址就是 ~/.m2,所以文件archetype-catalog.xml会被eclipse自动读取,使用eclipse创建maven项目的时候可以在"Default Local"一项中找到刚才自定义archetype名字。
如果想要卸载刚才安装的archetype,只需要将~/.m2目录下面的archetype-catalog.xml文件中对应的<archetype>字节段删掉,并且把本地仓库中相应groupId和artifactId下面的文件删掉就可以了。
安装到本地仓库中的archetype只可以被自己使用,如果想要共享,那么不要使用install命令。