Maven 入门 (2)—— 创建Maven项目

http://blog.csdn.net/kakashi8841/article/details/17427043

读这篇文章之前请先确保你成功安装了maven,如果你还没安装成功,请先看:Maven 入门 (1)—— 安装 这里的文章安装成功再继续。

因为maven在执行一些插件目标的时候可能会从中心数据库下载依赖的文件,因此,使用maven的时候请保持联网状态。

现在如果你已经迫不及待了,那么可以尝试在命令行终端先输入:

[plain] view plaincopy

  1. mvn clean install

这时候会打印正在下载各种文件。是不是感觉很爽呢?好了,下面我们开始进入正题:

1、先创建一个Maven项目。

在终端输入命令然后执行:

[plain] view plaincopy

  1. mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
和之前一样,现在它也是在不停下载各种所需要的文件。
等到命令结束后,你发现当前目录下多了一个叫my-app的目录,它里面有pom.xml和src目录,如下图:

完整目录结构如下:

是不是很神奇嘞?
神奇归神奇,刚刚那个命令那么复杂,它到底是什么意思,做了什么操作?别急,我们慢慢看。

首先,你刚刚执行了一个maven的目标"archetype:generate",并传了不同的参数给那个目标。"archetype"是一个插件,它包含了"generate"这个目标。如果你熟悉Ant,你可以假设它就是ant中的task。这个目标创建基于原型之上的简单工程。总之就是,插件是一系列通用目标的集合。例如jboss-maven-plugin,就是用于处理各种不同的jboss项目。

接着,我们来看看 -DgroupId  -DartifactId -DarchetypeArtifactId -DinteractiveMode 这几个属性
其实它们是Java执行时的参数。
groupId:一般填的是项目名,有的人喜欢填公司名。这里说下,一个公司一般是有多个项目的,如果这里填公司名,那么artifactId只能填项目名了。而version毫无疑问是版本号。这样在项目的划分上粒度比较粗。因此,我一般groupId是填到项目。比如:com.taobao.shop。
artifactId:上面填了项目,那么这里就可以填模块了。比如:login
version:这里填的是本模块版本。
OK上面的groupId、artifactId、version(简称GAV)构成了maven中的“定位系统“,理论上所有的依赖包都可以通过GAV找到。

我们接着看其它参数,
archetypeArtifactId:这个参数其实是指定一个模版来初始化生成你的项目。比如你是一个普通的java应用程序,还是一个web程序,都有对应的模版。

如果你还是不懂怎么生成一个maven项目,那么,你也可以通过命令行:

mvn help:describe -Dplugin=archetype

一样的,这里help也是一个插件,然后describe是目标,而-Dplugin参数指明了describe要查看的是archetype插件的信息。

这样就能获得archetype这个插件的帮助。

Name: Maven Archetype Plugin

Description: Maven Archetype is a set of tools to deal with archetypes, i.e.

an abstract representation of a kind of project that can be instantiated into

a concrete customized Maven project. An archetype knows which files will be

part of the instantiated project and which properties to fill to properly

customize the project.

Group Id: org.apache.maven.plugins

Artifact Id: maven-archetype-plugin

Version: 2.2

Goal Prefix: archetype

This plugin has 8 goals:

archetype:crawl

Description: Crawl a Maven repository (filesystem, not HTTP) and creates a

catalog file.

archetype:create

Description: The archetype creation goal looks for an archetype with a

given groupId, artifactId, and version and retrieves it from the remote

repository. Once the archetype is retrieved, it is then processed against a

set of user parameters to create a working Maven project.

Deprecated. Please use the generate mojo instead.

archetype:create-from-project

Description: Creates an archetype project from the current project.

This goal reads your source and resource files, the values of its

parameters, and properties you specify in a .property file, and uses them

to create a Maven archetype project using the maven-archetype packaging. If

you build the resulting project, it will create the archetype. You can then

use this archetype to create new projects that resemble the original.

The maven-archetype-plugin uses Velocity to expand template files, and this

documentation talks about ‘Velocity Properties‘, which are values

substituted into Velocity templates. See The Velocity User‘s Guide for more

information.

This goal modifies the text of the files of the current project to form the

Velocity template files that make up the archetype.

GAV

The GAV values for the current project are replaced by properties:

groupId, artifactId, and version. The user chooses new values for these

when generating a project from the archetype.

package

All the files under one specified Java (or cognate) package are relocated

to a project that the user chooses when generating a project. References

to the class name are replaced by a property reference. For example, if

the current project‘s sources are in the package

org.apache.saltedpeanuts, then any example of the string

org.apache.saltedpeanuts is replaced with the Velocity property reference

${packageName}. When the user generates a project, this is in turn

replaced by his or her choice of a package.

custom properties

You may identify additional strings that should be replaced by

parameters. To add custom properties, you must use the propertyFile

parameter to specify a property file. See the documentation for

propertyFile for the details.

Note that you may need to edit the results of this goal. This goal has no

way to exclude unwanted files, or add copyright notices to the Velocity

templates, or add more complex elements to the archetype metadata file.

This goal also generates a simple integration-test that exercises the

generated archetype.

archetype:generate

Description: Generates a new project from an archetype, or updated the

actual project if using a partial archetype. If the project is fully

generated, it is generated in a directory corresponding to its artifactId.

If the project is updated with a partial archetype, it is done in the

current directory.

archetype:help

Description: Display help information on maven-archetype-plugin.

Call

mvn archetype:help -Ddetail=true -Dgoal=<goal-name>

to display parameter details.

archetype:integration-test

Description: Execute the archetype integration tests, consisting in

generating projects from the current archetype and optionally comparing

generated projects with reference copy.

Each IT consists of a sub-directory in src/test/resources/projects

containing:

- a goal.txt file, containing a list of goals to run against the generated

project (can be empty, content ignored before maven-archetype-plugin

2.1),

- an archetype.properties file, containing properties for project

generation,

- an optional reference/ directory containing a reference copy of the

expected project created from the IT.

Notice that it is expected to be run as part as of a build after the

package phase and not directly as a goal from CLI.

archetype:jar

Description: Build a JAR from the current Archetype project.

archetype:update-local-catalog

Description: Updates the local catalog

For more information, run ‘mvn help:describe [...] -Ddetail‘

[INFO] ------------------------------------------------------------------------

[INFO] BUILD SUCCESS

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 3.851s

[INFO] Finished at: Tue Dec 24 02:45:02 CST 2013

[INFO] Final Memory: 11M/156M

[INFO] ------------------------------------------------------------------------

我们注意到:archetype这个插件本身也有个help目标,似乎能查找更多帮助信息。

那么我们可以尝试用下面命令来查找generate目标的信息:

mvn archetype:help -Ddetail=true -Dgoal=generate

然后,这时候返回的内容是:

cmatoMacBook-Pro:~ cjunhong$ mvn archetype:help -Ddetail=true -Dgoal=generate

[INFO] Scanning for projects...

[INFO]

[INFO] ------------------------------------------------------------------------

[INFO] Building Maven Stub Project (No POM) 1

[INFO] ------------------------------------------------------------------------

[INFO]

[INFO] --- maven-archetype-plugin:2.2:help (default-cli) @ standalone-pom ---

[INFO] org.apache.maven.plugins:maven-archetype-plugin:2.2

Maven Archetype Plugin

Maven Archetype is a set of tools to deal with archetypes, i.e. an abstract

representation of a kind of project that can be instantiated into a concrete

customized Maven project. An archetype knows which files will be part of the

instantiated project and which properties to fill to properly customize the

project.

archetype:generate

Generates a new project from an archetype, or updated the actual project if

using a partial archetype. If the project is fully generated, it is generated

in a directory corresponding to its artifactId. If the project is updated with

a partial archetype, it is done in the current directory.

Available parameters:

archetypeArtifactId

The archetype‘s artifactId.

Expression: ${archetypeArtifactId}

archetypeCatalog (Default: remote,local)

The archetype catalogs to use to build a list and let the user choose

from. It is a comma separated list of catalogs. Catalogs use following

schemes:

- ‘file://...‘ with archetype-catalog.xml automatically appended when

pointing to a directory

- ‘http://...‘ or ‘https://...‘ with archetype-catalog.xml always appended

- ‘local‘ which is the shortcut for ‘file://~/.m2/archetype-catalog.xml‘

- ‘remote‘ which is the shortcut for Maven Central repository, ie

‘http://repo1.maven.org/maven2‘

- ‘internal‘ which is an internal catalog

Since 2.0-alpha-5, default value is no longer internal,local but

remote,local. If Maven Central repository catalog file is empty, internal

catalog is used instead.

Expression: ${archetypeCatalog}

archetypeGroupId

The archetype‘s groupId.

Expression: ${archetypeGroupId}

archetypeRepository

The archetype‘s repository.

Expression: ${archetypeRepository}

archetypeVersion

The archetype‘s version.

Expression: ${archetypeVersion}

basedir

(no description available)

Expression: ${basedir}

filter

Applying some filter on displayed archetypes list: format is artifactId or

groupId:artifactId.

- org.apache: -> displays all archetypes which contain org.apache in

groupId

- :jee or jee -> displays all archetypes which contain jee in artifactId

- org.apache:jee -> displays all archetypes which contain org.apache in

groupId AND jee in artifactId

Expression: ${filter}

goals

Additional goals to immediately run on the project created from the

archetype.

Expression: ${goals}

interactiveMode (Default: ${settings.interactiveMode})

User settings use to check the interactiveMode.

Required: Yes

Expression: ${interactiveMode}

[INFO] ------------------------------------------------------------------------

[INFO] BUILD SUCCESS

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 1.088s

[INFO] Finished at: Tue Dec 24 02:56:42 CST 2013

[INFO] Final Memory: 9M/156M

[INFO] ------------------------------------------------------------------------

看到没有,连我们刚刚没有解释的interactiveMode参数,它里面也都有了说明了。

所以,要善于利用help插件来查找某个插件的信息,然后如果得知这个插件有help目标查找更详细信息,那么就更好了!

时间: 2024-09-29 02:15:56

Maven 入门 (2)—— 创建Maven项目的相关文章

Maven入门----MyEclipse创建maven项目(二)

新建项目: Next next next 新建项目后,MyEclipse会自动从远程仓库中下载支持包,需要几分钟左右时间. 项目结构图: HelloWorld.java public class HelloWorld { public String say(){ return "Hello World"; } public static void main(String []args){ System.out.println(new HelloWorld().say()); } Hel

Maven命令行创建web项目,并部署到jobss当中(解决No plugin found for prefix &#39;jboss-as&#39; in the current project and in the plugin groups [org.apache.maven.plugins,问题)

首件创建项目:此处可参照:http://maven.apache.org/guides/mini/guide-webapp.html mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp 将目录切换至my-webapp下,编译和打包: mvn clean package 此时,启动jboss服务器(我的是jboss

maven安装和创建maven工程

maven是一个项目管理工具,整个项目依赖的jar文件和依赖其他模块的jar都是由maven管理和维护.他还可以帮助我们发布项目(编译,打包,测试...). 下载和安装maven,配置maven的环境 1.0 下载  进入maven官网 点击download  找到最新二进制发布包 下载下来 下载完毕后,解压文件文件目录如下 bin 目录 :保存maven的可执行命令 conf:  保存 maven的配置文件settings.xml lib :maveny运行时依赖的类库 settings文件中

Maven入门指南 :Maven 快速入门及简单使用

Maven入门指南 :Maven 快速入门及简单使用 前言 Maven是一个Java语言编写的开源项目管理工具,是Apache软件基金会的顶级项目.主要用于项目构建,依赖管理,项目信息管理. maven项目在编译.测试.打包里,会需要从maven的中央仓库(即:maven组织公布在互联网上的一个站点,里面已经收录了目前绝大多数主流的jar包)下载jar包等文件, 如果使用代理服务器上网,需要配置代理服务器. 理解"仓库" 首次运行完mvn -version后,会在用户目录下创建一个.m

Maven入门指南② :Maven 常用命令,手动创建第一个 Maven 项目

1.根据 Maven 的约定,我们在D盘根目录手动创建如下目录及文件结构: 2.打开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://m

java web开发入门九(Maven使用&amp;idea创建maven项目)基于intellig idea

Maven 1.解决的问题 jar包的依赖和管理:版本.依赖关系等 自动构建项目 2.maven介绍 1.Maven是什么? Apache Maven是一个软件项目管理的综合工具.基于项目对象模型(POM)的概念,提供了帮助管理构建.文档.报告.依赖.发布等方法,Maven简化和标准化项目建设过程.处理编译,分配,文档,团队协作和其他任务的无缝连接. Maven增加可重用性并负责建立相关的任务. 2.Maven好处 可以将项目过程规范化.自动化.高效化以及强大的可扩展性,利用maven自身及其插

在windows上安装Maven,并且创建一个项目

1.浏览器打开 http://maven.apache.org/  地址. 点击Download 2.选择 zip包格式的 进行下载. 介绍下Maven目录结构 --bin目录里包含了运行Maven的脚本,我们一会配置到环境变量里去. --boot目录有一个jar文件,是创建Maven运行所需要的一个内加载器的jar文件 --conf目录下的.xml文件用来定义一些Maven的行为. --lib目录里是Maven核心jar文件 3.接下来配置Maven的环境变量 在系统变量中 添加一个 名为:M

Maven学习之创建web项目在pom.xml遇到的bug

今天再学习maven的时候,遇到了一个小bug,决定分享上来说不定对刚学习maven的你有一定的帮助! maven版本:apache-maven-3.5.4 在创建web项目时出现 Cannot detect Web Project version. Please specify version of Web Project through Maven project prope--的错误 解决方案: 第一步  修改项目的jdk版本,改成你想要的版本,新建的maven web项目默认是jdk1.

1.搭建maven,eclipse创建maven项目

1.下载maven包,下载地址为:http://maven.apache.org/download.cgi 2.解压zip包 3.eclipse 引入maven: window-Preferences-maven-Installations-Add引入本地maven, 下图1为eclips默认Maven,点击Add,从本地电脑选择maven包,导入, 点击ok, 然后选择对应的maven,点击apply,完成导入. 4.配置maven,settings配置文件,该文件配置远程仓库以及本地仓库信息

Maven 实战-手动创建Maven项目,使用Maven编译

创建空目录 F:\jtDevelop\maventest\myapp 创建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.o