学习Mina的时候,发现Mina使用Maven做项目管理的。又开始学习Maven,这段时间做的笔记。要学会这种类似于ant,又比ant高级的build工具,首先要掌握mvn命令下的各个参数,然后将这些mvn、参数组合在实际的项目中加以运用。
mvn将项目分为5个阶段(lifecycle):准备、编译(complie)、测试、部署、运行
下载配置maven:
详细过程网上都会有。
1.1 user
对指定用户的配置。user configuration可以在${user.home}/.m2/settings.xml中指定。注:该文件不是必须的,当该文件找不到时,maven会使用默认的配置。
关于该文件的具体配置可以参考:http://maven.apache.org/ref/2.0.4/maven-settings/settings.html
1.2 配置代理
在maven2.0中,代理服务器上网,可以为http request配置代理。同样在user configuration中配置,配置如下:
<proxy>
<id>optional</id>
<active>true</active>
<protocol>http</protocol>
<username>proxyuser</username>
<password>proxypass</password>
<host>www.hc360.com</host>
<port>80</port>
<nonProxyHosts>local.net,some.host.com</nonProxyHosts>
</proxy>
详见:http://maven.apache.org/guides/mini/guide-proxies.html
1.3 安全和部署配置
在一个project中,该项目将要使用哪个Repository,是在setting.xml中指定的。然而,你却不能将用户名和
码以及其它的安全设定也放在该project中。因此,你可能会在你自己的设定中定义一个server,给它指定一个id, 该id
与project将要使用那个Repository相对应。
另外,有些repository在下载时可能需要用户名和密码,这些也可以在server element中以相同的方式指定。配置如下
<server>
<id>deploymentRepo</id>
<username>repouser</username>
<password>repopwd</password>
</server>
1.4 mavenplugins for eclipse
通过eclipse安装的url为http://m2eclipse.sonatype.org/update/ ,可以去官方网站上查询。
配置:在window-->references-->Java-->build path-->classpath variables,按"New",名字为:M2_REPO 创建一个目录,指向当前的资源库:C:/Documents and Settings/pengch/.m2/repository
要注意的部分:设置maven的主目录的名称为:M2_HOME。从服务器下载的jar库默认是: ${user.home}/.m2/repository/下,我的${user.home}值为:C:/Documents and Settings/Administrator,初始配置是在:%M2_HOME%/bin/m2.conf文件中可见到。如果要修改resposity的值:
有两种方法:%M2_HOME%/conf/settings.xml中的字段为:<localRepository>实际的物理地址</localRepository>,如<localRepository>E:/maven/.m2/repository</localRepository>
另一种方法是:用artifactory来建立maven的本地的repository。本人没有试用过。(以下转自:http://www.javaeye.com/topic/98480)
官方的maven repository服务器特别的慢,还记得上次海底电缆事故么?官方的服务器根本就无法访问,那段时间简直要抓狂。并且官方服务器类库版本通常不是最新,有时候想用最新版的还得自己动手。(下面会介绍如何自己动手做),所以建立一个自己的本地代码服务器对于整个团队就特别有意义。
Maven的服务器很简单,一个普通的http服务器就行,比如apache,装好apache以后。
将你本地代码库文件夹拷贝到apache安装目录下htpdocs/maven2,windows用户是C:/Documents and Settings/jeffrey/.m2/repository,linux下是 /home/Jeffrey/.m2/repository(注意.m2在linux下是隐藏文件夹)
启动apache服务器,在浏览器中输入http://localhost/maven2/repository,应该可以查看到repository的文件目录
编辑项目pom,指定本地的代码库服务器
在project中加入:
xml 代码
<repositories>
<repository>
<id>mylibsid>
<url>http://localhost/maven2/repositoryurl>
repository>
repositories>
可以加入多个repository,mvn会按照顺序检索,如果都没有找到,最后会去找官方的服务器。(转完)
maven 常用命令组合:
创建:mvn archetype:create -DgroupId=com.oreilly -DartifactId=app
文件夹结构:
app
---com
------oreilly
创建Maven的普通java项目:mvn archetype:create -DgroupId=com.codeline.commons -DartifactId=pjoName
创建Maven的Web项目:mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
编译:
cd app;
mvn compile
编译测试用例:Compiling Test Sources and Running Unit Tests
mvn test;
mvn test will always run the compile and test-compile phases first, as well as all the others defined before it.
打包,
Packaging and Installation to Your Local Repository
Making a JAR file is straightforward and can be accomplished by executing the following command:
C:/app> mvn package
将生成的文件添加到本地类库中
Now, you'll want to install the artifact (the JAR file) you've generated into your local repository. It can then be used by other projects as a dependency. The directory <user_home>/.m2/repository isthe default location of the repository.
To install, execute the following command:
C:/app> mvn install
maven代码库的文件目录组织方式,同一个jar对于每个版本都有一个独立的文件夹来存放,除了jar还要有该jar的描述文件.pom,以及他们的校验文件.sh1
.pom文件里定义了该jar的名称、版本以及该jar所依赖到的其他jar(这也就是为什么引入一个jar却带出一大堆的jar来)
最简单的pom如下:
xml 代码
xml version="1.0" encoding="UTF-8"?>
<project>
<modelVersion>4.0.0modelVersion>
<groupId>net.jeffreygroupId>
<artifactId>xxxartifactId>
<version>1.0version>
<dependencies>
dependencies>
project>
为jar和pom生成校验文件
可以通过一个ant任务来做:
xml 代码
<target name="checksum" description="Generate checksum file for jar and pom">
<checksum algorithm="SHA" fileext=".sha1">
<fileset dir="d:/javalib" id="id">
<include name="**/*.pom" />
<include name="**/*.jar" />
<include name="**/*.xml" />
<exclude name="**/*.sh1" />
</fileset>
</checksum>
</target>
把生成好的sh1文件和jar、pom按照前面介绍的结构布局拷贝到apache的代码库中,当然你也可以直接拷到本地代码库中。
(转自:http://fluagen.blog.51cto.com/146595/40086)
在安装hibernate的架包时告诉我jta无法下载。要求本地化安装,给出的提示如下:
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:http://java.sun.com/products/jta.Then, install it using the command:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta / -Dversion=1.0.1B -Dpackaging=jar -Dfile=/path/to/filePath to dependency:
1) com.efn:mywebapp:war:1.0-SNAPSHOT
2) org.hibernate:hibernate:jar:3.1rc2
3) javax.transaction:jta:jar:1.0.1B
----------
1 required artifact is missing.for artifact: com.efn:mywebapp-1.0-SNAPSHOT.war这个提示是说可以先到sun的网站下载jta架包,然后采用命令行的方式按要求安装,因为我本来就有此架包,于是拷到一个方便的位置,比如c:/,然后在命令行下输入:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=C:/jta.jar
执行完毕后,一切OK!
(转完)
其他命令:
不需任何附加工作maven依靠此POM就可以为你的项目产生一个网站,你只须定制你的maven网站,如果时间紧迫,你只须执行以下命令:
mvn site
还有许多goals可以执行,比如
mvn clean
此命令删除target目录。
可能你需要为你的项目产生一个IntelliJ IDEA 描述符,执行以下命令:
mvn idea:idea
组合使用goal命令,如只打包不测试:mvn -Dtest package
编译测试的内容:mvn test-compile
只打jar包: mvn jar:jar
只测试而不编译,也不测试编译:mvn test -skipping compile -skipping test-compile (这里要特别注意 -skipping 的灵活运用,当然也可以用于其他组合命令)
清除eclipse的一些系统设置:mvn eclipse:clean
注意事项:
当建立一个工程后,执行 mvn eclipse:eclipse,则会产生eclipse的工程文件,但是第一次用eclipse打开工程后,发现报如下错误:Unbound classpath variable: 'M2_REPO/junit/junit/3.8.1/junit-3.8.1.jar' in project my-webapp ,需要在Eclipse 中配置 M2_REPO 变量,配置步骤:window >> preferences >> Java >> Build Path >> Classpath Variables
新建一个 M2_REPO 的变量,变量值指向你系统的Maven2的数据仓库位置
将资源文件(.resources)加入
如何在jar文件中加入资源?
在示例应用程序中,增加目录${basedir}/src/main/resources,我们把资源文件放入此目录。任何在${basedir}/src/main/resources目录中的文件和目录都将被打包到jar文件中。
my-app
|-- pom.xml
`-- src
|-- main
| |-- java
| | `-- com
| | `-- mycompany
| | `-- app
| | `-- App.java
| `-- resources
| `-- META-INF
| `-- application.properties
`-- test
`-- java
`-- com
`-- mycompany
`-- app
`-- AppTest.java
在这个例子中,我们在${basedir}/src/main/resources目录下放了一个META-INF目录并在META-INF目录中放了一个application.properties文件。如果你将jar文件解压,可以看到以下内容:
|-- META-INF
| |-- MANIFEST.MF
| |-- application.properties
| `-- maven
| `-- com.mycompany.app
| `-- my-app
| |-- pom.properties
| `-- pom.xml
`-- com
`-- mycompany
`-- app
`-- App.class
就像你看到的那样,${basedir}/src /main/resources中的内容在jar文件的起始位置,我们的application.properties文件在META-INF目录下。同 时,一些其他文件如META-INF/MANIFEST.MF,以及pom.xml和pom.properties文件也在其中,对于maven产生的 jar文件来说,这是maven的标准行为。你可以自行创建自己的manifest,不过如果你不指定,maven会产生一个默认的。由于pom.xml 和pom.properties文件都被打包到jar文件中,所以maven产生的产品都是自描述的,一个简单的应用就是获得应用程序版本。打开POM文 件可能需要一些maven的工具,但打开属性文件可以使用标准的java API来做到,属性文件pom.properties如下所示:
#Generated by Maven
#Tue Oct 04 15:43:21 GMT-05:00 2005
version=1.0-SNAPSHOT
groupId=com.mycompany.app
artifactId=my-app
为了单元测试,可能需要把资源加入到classpath,你可以遵照同样的模式:
my-app
|-- pom.xml
`-- src
|-- main
| |-- java
| | `-- com
| | `-- mycompany
| | `-- app
| | `-- App.java
| `-- resources
| `-- META-INF
| |-- application.properties
`-- test
|-- java
| `-- com
| `-- mycompany
| `-- app
| `-- AppTest.java
`-- resources
`-- test.properties
那么在测试代码中,只须使用如下代码就可访问这些资源:
...
// Retrieve resource
InputStream is = getClass().getResourceAsStream( "/test.properties" );
// Do something with the resource
...
建立Maven2的本地代码库服务器,也就是常说的“私服”
官方的maven repository服务器特别的慢,还记得上次海底电缆事故么?官方的服务器根本就无法访问,那段时间简直要抓狂。并且官方服务器类库版本通常不是最新,有时候想用最新版的还得自己动手。(下面会介绍如何自己动手做),所以建立一个自己的本地代码服务器对于整个团队就特别有意义。
Maven的服务器很简单,一个普通的http服务器就行,比如apache,装好apache以后。
将你本地代码库文件夹拷贝到apache安装目录下htpdocs/maven2,windows用户是C:\Documents and Settings\jeffrey\.m2\repository,linux下是 /home/Jeffrey/.m2/repository(注意.m2在linux下是隐藏文件夹)
启动apache服务器,在浏览器中输入http://localhost/maven2/repository,应该可以查看到repository的文件目录
编辑项目pom,指定本地的代码库服务器
在project中加入:
xml 代码
<repositories>
<repository>
<id>mylibs<!---->id>
<url>http://localhost/maven2/repository<!---->url>
<!---->repository>
<!---->repositories>
<o:p></o:p>
可以加入多个repository,mvn会按照顺序检索,如果都没有找到,最后会去找官方的服务器
mvn将项目分为5个阶段(lifecycle):准备、编译(complie)、测试、部署、运行
下载配置maven:
详细过程网上都会有。
1.1 user
对指定用户的配置。user configuration可以在${user.home}/.m2/settings.xml中指定。注:该文件不是必须的,当该文件找不到时,maven会使用默认的配置。
关于该文件的具体配置可以参考:http://maven.apache.org/ref/2.0.4/maven-settings/settings.html
1.2 配置代理
在maven2.0中,代理服务器上网,可以为http request配置代理。同样在user configuration中配置,配置如下:
<proxy>
<id>optional</id>
<active>true</active>
<protocol>http</protocol>
<username>proxyuser</username>
<password>proxypass</password>
<host>www.hc360.com</host>
<port>80</port>
<nonProxyHosts>local.net,some.host.com</nonProxyHosts>
</proxy>
详见:http://maven.apache.org/guides/mini/guide-proxies.html
1.3 安全和部署配置
在一个project中,该项目将要使用哪个Repository,是在setting.xml中指定的。然而,你却不能将用户名和
码以及其它的安全设定也放在该project中。因此,你可能会在你自己的设定中定义一个server,给它指定一个id, 该id
与project将要使用那个Repository相对应。
另外,有些repository在下载时可能需要用户名和密码,这些也可以在server element中以相同的方式指定。配置如下
<server>
<id>deploymentRepo</id>
<username>repouser</username>
<password>repopwd</password>
</server>
1.4 mavenplugins for eclipse
通过eclipse安装的url为http://m2eclipse.sonatype.org/update/ ,可以去官方网站上查询。
配置:在window-->references-->Java-->build path-->classpath variables,按"New",名字为:M2_REPO 创建一个目录,指向当前的资源库:C:/Documents and Settings/pengch/.m2/repository
要注意的部分:设置maven的主目录的名称为:M2_HOME。从服务器下载的jar库默认是: ${user.home}/.m2/repository/下,我的${user.home}值为:C:/Documents and Settings/Administrator,初始配置是在:%M2_HOME%/bin/m2.conf文件中可见到。如果要修改resposity的值:
有两种方法:%M2_HOME%/conf/settings.xml中的字段为:<localRepository>实际的物理地址</localRepository>,如<localRepository>E:/maven/.m2/repository</localRepository>
另一种方法是:用artifactory来建立maven的本地的repository。本人没有试用过。(以下转自:http://www.javaeye.com/topic/98480)
官方的maven repository服务器特别的慢,还记得上次海底电缆事故么?官方的服务器根本就无法访问,那段时间简直要抓狂。并且官方服务器类库版本通常不是最新,有时候想用最新版的还得自己动手。(下面会介绍如何自己动手做),所以建立一个自己的本地代码服务器对于整个团队就特别有意义。
Maven的服务器很简单,一个普通的http服务器就行,比如apache,装好apache以后。
将你本地代码库文件夹拷贝到apache安装目录下htpdocs/maven2,windows用户是C:/Documents and Settings/jeffrey/.m2/repository,linux下是 /home/Jeffrey/.m2/repository(注意.m2在linux下是隐藏文件夹)
启动apache服务器,在浏览器中输入http://localhost/maven2/repository,应该可以查看到repository的文件目录
编辑项目pom,指定本地的代码库服务器
在project中加入:
xml 代码
<repositories>
<repository>
<id>mylibsid>
<url>http://localhost/maven2/repositoryurl>
repository>
repositories>
可以加入多个repository,mvn会按照顺序检索,如果都没有找到,最后会去找官方的服务器。(转完)
maven 常用命令组合:
创建:mvn archetype:create -DgroupId=com.oreilly -DartifactId=app
文件夹结构:
app
---com
------oreilly
创建Maven的普通java项目:mvn archetype:create -DgroupId=com.codeline.commons -DartifactId=pjoName
创建Maven的Web项目:mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
编译:
cd app;
mvn compile
编译测试用例:Compiling Test Sources and Running Unit Tests
mvn test;
mvn test will always run the compile and test-compile phases first, as well as all the others defined before it.
打包,
Packaging and Installation to Your Local Repository
Making a JAR file is straightforward and can be accomplished by executing the following command:
C:/app> mvn package
将生成的文件添加到本地类库中
Now, you'll want to install the artifact (the JAR file) you've generated into your local repository. It can then be used by other projects as a dependency. The directory <user_home>/.m2/repository isthe default location of the repository.
To install, execute the following command:
C:/app> mvn install
maven代码库的文件目录组织方式,同一个jar对于每个版本都有一个独立的文件夹来存放,除了jar还要有该jar的描述文件.pom,以及他们的校验文件.sh1
.pom文件里定义了该jar的名称、版本以及该jar所依赖到的其他jar(这也就是为什么引入一个jar却带出一大堆的jar来)
最简单的pom如下:
xml 代码
xml version="1.0" encoding="UTF-8"?>
<project>
<modelVersion>4.0.0modelVersion>
<groupId>net.jeffreygroupId>
<artifactId>xxxartifactId>
<version>1.0version>
<dependencies>
dependencies>
project>
为jar和pom生成校验文件
可以通过一个ant任务来做:
xml 代码
<target name="checksum" description="Generate checksum file for jar and pom">
<checksum algorithm="SHA" fileext=".sha1">
<fileset dir="d:/javalib" id="id">
<include name="**/*.pom" />
<include name="**/*.jar" />
<include name="**/*.xml" />
<exclude name="**/*.sh1" />
</fileset>
</checksum>
</target>
把生成好的sh1文件和jar、pom按照前面介绍的结构布局拷贝到apache的代码库中,当然你也可以直接拷到本地代码库中。
(转自:http://fluagen.blog.51cto.com/146595/40086)
在安装hibernate的架包时告诉我jta无法下载。要求本地化安装,给出的提示如下:
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:http://java.sun.com/products/jta.Then, install it using the command:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta / -Dversion=1.0.1B -Dpackaging=jar -Dfile=/path/to/filePath to dependency:
1) com.efn:mywebapp:war:1.0-SNAPSHOT
2) org.hibernate:hibernate:jar:3.1rc2
3) javax.transaction:jta:jar:1.0.1B
----------
1 required artifact is missing.for artifact: com.efn:mywebapp-1.0-SNAPSHOT.war这个提示是说可以先到sun的网站下载jta架包,然后采用命令行的方式按要求安装,因为我本来就有此架包,于是拷到一个方便的位置,比如c:/,然后在命令行下输入:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=C:/jta.jar
执行完毕后,一切OK!
(转完)
其他命令:
不需任何附加工作maven依靠此POM就可以为你的项目产生一个网站,你只须定制你的maven网站,如果时间紧迫,你只须执行以下命令:
mvn site
还有许多goals可以执行,比如
mvn clean
此命令删除target目录。
可能你需要为你的项目产生一个IntelliJ IDEA 描述符,执行以下命令:
mvn idea:idea
组合使用goal命令,如只打包不测试:mvn -Dtest package
编译测试的内容:mvn test-compile
只打jar包: mvn jar:jar
只测试而不编译,也不测试编译:mvn test -skipping compile -skipping test-compile (这里要特别注意 -skipping 的灵活运用,当然也可以用于其他组合命令)
清除eclipse的一些系统设置:mvn eclipse:clean
注意事项:
当建立一个工程后,执行 mvn eclipse:eclipse,则会产生eclipse的工程文件,但是第一次用eclipse打开工程后,发现报如下错误:Unbound classpath variable: 'M2_REPO/junit/junit/3.8.1/junit-3.8.1.jar' in project my-webapp ,需要在Eclipse 中配置 M2_REPO 变量,配置步骤:window >> preferences >> Java >> Build Path >> Classpath Variables
新建一个 M2_REPO 的变量,变量值指向你系统的Maven2的数据仓库位置
将资源文件(.resources)加入
如何在jar文件中加入资源?
在示例应用程序中,增加目录${basedir}/src/main/resources,我们把资源文件放入此目录。任何在${basedir}/src/main/resources目录中的文件和目录都将被打包到jar文件中。
my-app
|-- pom.xml
`-- src
|-- main
| |-- java
| | `-- com
| | `-- mycompany
| | `-- app
| | `-- App.java
| `-- resources
| `-- META-INF
| `-- application.properties
`-- test
`-- java
`-- com
`-- mycompany
`-- app
`-- AppTest.java
在这个例子中,我们在${basedir}/src/main/resources目录下放了一个META-INF目录并在META-INF目录中放了一个application.properties文件。如果你将jar文件解压,可以看到以下内容:
|-- META-INF
| |-- MANIFEST.MF
| |-- application.properties
| `-- maven
| `-- com.mycompany.app
| `-- my-app
| |-- pom.properties
| `-- pom.xml
`-- com
`-- mycompany
`-- app
`-- App.class
就像你看到的那样,${basedir}/src /main/resources中的内容在jar文件的起始位置,我们的application.properties文件在META-INF目录下。同 时,一些其他文件如META-INF/MANIFEST.MF,以及pom.xml和pom.properties文件也在其中,对于maven产生的 jar文件来说,这是maven的标准行为。你可以自行创建自己的manifest,不过如果你不指定,maven会产生一个默认的。由于pom.xml 和pom.properties文件都被打包到jar文件中,所以maven产生的产品都是自描述的,一个简单的应用就是获得应用程序版本。打开POM文 件可能需要一些maven的工具,但打开属性文件可以使用标准的java API来做到,属性文件pom.properties如下所示:
#Generated by Maven
#Tue Oct 04 15:43:21 GMT-05:00 2005
version=1.0-SNAPSHOT
groupId=com.mycompany.app
artifactId=my-app
为了单元测试,可能需要把资源加入到classpath,你可以遵照同样的模式:
my-app
|-- pom.xml
`-- src
|-- main
| |-- java
| | `-- com
| | `-- mycompany
| | `-- app
| | `-- App.java
| `-- resources
| `-- META-INF
| |-- application.properties
`-- test
|-- java
| `-- com
| `-- mycompany
| `-- app
| `-- AppTest.java
`-- resources
`-- test.properties
那么在测试代码中,只须使用如下代码就可访问这些资源:
...
// Retrieve resource
InputStream is = getClass().getResourceAsStream( "/test.properties" );
// Do something with the resource
...
建立Maven2的本地代码库服务器,也就是常说的“私服”
官方的maven repository服务器特别的慢,还记得上次海底电缆事故么?官方的服务器根本就无法访问,那段时间简直要抓狂。并且官方服务器类库版本通常不是最新,有时候想用最新版的还得自己动手。(下面会介绍如何自己动手做),所以建立一个自己的本地代码服务器对于整个团队就特别有意义。
Maven的服务器很简单,一个普通的http服务器就行,比如apache,装好apache以后。
将你本地代码库文件夹拷贝到apache安装目录下htpdocs/maven2,windows用户是C:\Documents and Settings\jeffrey\.m2\repository,linux下是 /home/Jeffrey/.m2/repository(注意.m2在linux下是隐藏文件夹)
启动apache服务器,在浏览器中输入http://localhost/maven2/repository,应该可以查看到repository的文件目录
编辑项目pom,指定本地的代码库服务器
在project中加入:
xml 代码
<repositories>
<repository>
<id>mylibs<!---->id>
<url>http://localhost/maven2/repository<!---->url>
<!---->repository>
<!---->repositories>
<o:p></o:p>
可以加入多个repository,mvn会按照顺序检索,如果都没有找到,最后会去找官方的服务器