1,首先到http://maven.apache.org/download.html 下载合适的Maven版本,我下载的是Maven 2.0.9 (zip)。
2,解压文件到你想安装的目录,我的是F:/apache-maven-2.0.9。
3,在环境变量的用户变量中增加名为M2_HOME,值为F:/apache-maven-2.0.9的变量,注意在目录F:/apache- maven-2.0.9的最后不要加/,即不能为F:/apache-maven-2.0.9/。同时添加名为M2,值为%M2_HOME%/bin的环 境变量。在环境变量path的值中加入%M2%.
4,控制台运行mvn -version,显示如下信息,则maven基本安装完成
App工程
可以使用Maven的archetype插件来创建新工程,命令如下:
D:/maven/demo>mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=app
该工程的 groupId是ce.demo.mvn,那么该工程的源文件将放在Java包ce.demo.mvn中。artifactId是app,那么该工程根目 录的名称将为app。
WebApp工程
我们仍然如创建app工程一样使用archetype插件来创建webapp工程,命令如下:
D:/maven/demo>mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=webapp -DarchetypeArtifactId=maven-archetype-webapp
第一次运行此命令时,也会从central仓库中下载一些与Web应用相关的artifact(如javax.servlet)。此命令与创建app的命 令的不同之处是,多设置了一个属性archetypeArtifacttId,该属性的值为maven-archetype-webapp。即告诉 Maven,将要创建的工程是一个Web应用工程。创建app工程时没有使用该属性值,是由于archetype默认创建的是应用程序工程。同样的,执行 完该命令之后,会出现如下标准目录布局:
四、生成eclipse工程文件
我采用的开发工具是 eclipse,所以用maven的eclipse参数生成eclipse工程文件。输入如下
1、 采用dos的cd命令进入study目录
2、 输入指令:mvn eclipse:eclipse 如下所示:
D:/eclipse/workspace/study>mvn eclipse:eclipse
指令执行完毕后,发现多了两个文件:.classpath和.project
五、下载maven的eclipse插件
1、打开 eclipse
2、打开菜单 help -Software updates-Find and Install
3、选择第二项,进入下 一步
4、点击按钮“New Remote Site…”
5、在Name中输入:Maven2,在URL中输入 [url]http://m2eclipse.codehaus.org/[/url]
Ok,现在一切都是自动化的,你所需要做的就是等待并按提 示按按钮。
六、导入工程
刚才已经生成了eclipse的工程文件,现 在导入之。菜单File-import ,按“下一步”,选择工程文件导入完毕后,工程管理透视图就会出现study节点了,在工程节点上,按鼠标右键,打开弹出菜单,选择maven2菜单项, 弹出子菜单->Enable,点击之打开,在Group Id中输入:study即可。
打开study的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 [url]http://maven.apache.org/maven-v4_0_0.xsd[/url]" >
- < modelVersion > 4.0.0 </ modelVersion >
- < groupId > com.efn </ groupId >
- < artifactId > study </ artifactId >
- < packaging > jar </ packaging >
- < version > 1.0-SNAPSHOT </ version >
- < name > Maven Quick Start Archetype </ name >
- < url > [url]http://maven.apache.org[/url] </ url >
- </ project >
注意:有关这个文件的作用和各节点的作用不是本文的描述重点,可以 到maven的官方网站查阅[url]http://maven.apache.org/[/url] 目 前为止,所有的准备工作都已经就绪,现在我们就以一个主main函数访问数据库为例介绍在实际开发中的使用。
七、搭建架包
每一个java工程都不免使用第三方的架 包,Maven的好处就是可以统一管理这些架包,并使多个java工程共享这些架包。我们所需要做的就是按规则编辑pom.xml文件。Maven已经非 常智能,使用maven的eclipse插件的向导,只要输入参数就可以将配置文件生成出来。我们的例子是用jdbc方式访问oracle的数据库。所以 需要jdbc和oracle的架包的支持。下面我们就来搭建这两个架包到study工程里来。
有两种方式可以采用:
1、自动向导
第一种是采用向 导方式并让向导直接去maven的服务器上下载你需要的架包,这种方式存在一定的风险,一来可能maven的服务器上并没有你需要的东东,二来每次智能的 maven总是去寻找那并不存在的东东。抛出一大堆红字提示不说,达不到预期目标才是让人郁闷。不过为了保证文档的完整性,还是给出操作步骤。以 junit为例(这个东东倒是没有问题,呵呵)当工程的maven被Enable后,弹出菜单的maven2子菜,选择子菜单的“Add Dependency”菜单项,在Query中输入“junit”,向导会自动列出相关列表供选择。选择你最需要的架包,按“OK” 按钮。
如果 你的本地仓库已经存在该架包,则向导只在pom.xml加入依赖项信息,pom.xml文件的内容如下
-
- < project xmlns = "http://maven.apache.org/POM/4.0.0" xmlns:xsi ="http:// [url]www.w3.org/2001/XMLSchema-instance[/url]" xsi:schemaLocation ="http://maven.apache.org/POM/4.0.0 [url]http://maven.[/url] " apache.org/maven-v4_0_0.xsd >
- < modelVersion > 4.0.0 </ modelVersion >
- < groupId > com.efn </ groupId >
- < artifactId > study </ artifactId >
- < packaging > jar </ packaging >
- < version > 1.0-SNAPSHOT </ version >
- < name > Maven Quick Start Archetype </ name >
- < url > [url]http://maven.apache.org[/url] </ url >
- < dependencies >
- < dependency >
- < groupId > junit </ groupId >
- < artifactId > junit </ artifactId >
- < version > 3.8.1 </ version >
- </ dependency >
- </ dependencies >
- </ project >
06-8-4 上午09时21分07秒: Local repository folder "" does not exist
06-8-4 上午09时21分11秒: Reading /study/pom.xml
06-8-4 上午09时21分11秒: Local repository folder "" does not exist
06-8-4 上午09时21分18秒: Reading /study/pom.xml
06-8-4 上午09时21分18秒: Local repository folder "" does not exist
06-8-4 上午09时21分19秒: Reading /study/pom.xml
06-8-4 上午09时21分19秒: Local repository folder "" does not exist
06-8-4 上午09时36分33秒: Local repository folder "" does not exist
06-8-4 上午09时37分11秒: Reading / study /pom.xml
06-8-4 上午09时37分11秒: Local repository folder "" does not exist
06-8-4 上午09时37分15秒: Local repository folder "" does not exist
06-8-4 上午09时40分07秒: Local repository folder "" does not exist
06-8-4 上午09时40分08秒: Reading / study /pom.xml
06-8-4 上午09时40分08秒: Local repository folder "" does not exist
06-8-4 上午09时46分24秒: Reading / study /pom.xml
06-8-4 上午09时46分24秒: Local repository folder "" does not exist
06-8-4 上午09时46分28秒: Local repository folder "" does not exist
06-8-4 上午09时46分40秒: Local repository folder "" does not exist
06-8-4 上午09时46分47秒: Local repository folder "" does not exist
06-8-4 上午09时46分47秒: Reading / study /pom.xml
06-8-4 上午09时46分47秒: Local repository folder "" does not exist
06-8-4 上午09 时46 分49 秒: Downloading [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom[/url]
06-8-4 上午09 时46 分49 秒: Downloaded [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom[/url]
06-8-4 上午09 时46 分51 秒: Downloading [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar[/url]
06-8-4 上午09时47分00秒: Downloaded [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar[/url]
----------------------------------------------------------------
补 充修正:如果出现错误提示同时你手头也有架包的话可以采用maven的指令进行本地化安装。比如我在安装hibernate的架包时告诉我jta无法下 载。要求本地化安装,给出的提示如下:
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:[url]http://java.sun.com/products/jta.Then[/url], 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!
--------------------------------------------------------------
2、手工配置
手工配置比起自动化来说是麻烦了些,不过任何东东掌握在自己手里总归是吃饱喝足谁也不服了不是J。而且配置一次就可以受益终身。更重要的是能解决自动化完 成不了的任务。比如我现在要配置oracle的jdbc驱动,采用自动化就提示我下载不了让我改变下载地址等等,真累。
算了还是自己来吧。
手工配置前还是先介绍一下相关背景知识。首先了解一下jar仓库的概念,maven采用集中化的方式管理架包,凡用maven构建的java工程都可以重 用统一管理下的架包,所以必须有一个统一存放jar文件的地方,这就是jar仓库,不论是开发还是部署都会建立一个本地仓库。这个仓库的位置默认是 X:/Documents and Settings/Administrator.LIPENG/.m2/repository(X是你操作系统所在盘符)下,你可以修改配置文件改变默认 的输出位置。该配置文件在maven目录下的conf子目录下。文件名叫settings.xml。在配置文件中加入如下节点信息即可D:/Repository。 不过不建议改变,好像eclipse的maven插件只认默认的输出位置。我就是在这方面出了问题搞了半天才发现是输出路径的问题,也许是我还
没 有玩转插件。谁要是解决此问题别忘了跟大家共享。
现在我们分析一下配置文件pom.xml的结构,以junit为例,格式如下:
-
- < dependencies >
- < dependency >
- < groupId > junit </ groupId >
- < artifactId > junit </ artifactId >
- < version > 3.8.1 </ version >
- </ dependency >
- </ dependencies >
Repository
`-- junit
|-- junit
| `-- 3.8.1
| `-- junit-3.8.1.jar
现在大家应该明白了 吧,多余的话不说啦。照葫芦画瓢就是。不过注意先建目录后写配置文件,否则一旦保存,智能的插件就马上开始下载了…
现在开始手动建立oracle的jdbc目录并配置文件,首先建立 目录结构如下:
Repository
`-- ojdbc
|-- ojdbc
| `-- 14
| `-- ojdbc-14.jar
如果你手头的jar文件名叫ojdbc14.jar,则改为ojdbc-14.jar,写配置文件:
-
- < dependency >
- < groupId > ojdbc </ groupId >
- < artifactId > ojdbc </ artifactId >
- < version > 14 </ version >
- </ dependency >
-
- <? xml version = "1.0" ?>
- < project >
- < modelVersion > 4.0.0 </ modelVersion >
- < groupId > com.mycompany.app </ groupId >
- < artifactId > myapp </ artifactId >
- < name > Maven Quick Start Archetype </ name >
- < version > 1.0-SNAPSHOT </ version >
- < url > [url]http://maven.apache.org[/url] </ url >
- < dependencies >
- < dependency >
- < groupId > ojdbc </ groupId >
- < artifactId > ojdbc </ artifactId >
- < version > 14 </ version >
- </ dependency >
- < dependency >
- < groupId > junit </ groupId >
- < artifactId > junit </ artifactId >
- < version > 3.8.1 </ version >
- </ dependency >
- </ dependencies >
- </ project >
保存之,则发现工程管理透视图发生了一点变化,依此方法再加上 jdbc的架包,现在可以开始写程序了,建一个类并添加main函数,编写程序如下:
-
- public static void main( String[] args )
- {
- Connection conn = null ;
- PreparedStatement ps = null ;
- ResultSet rs = null ;
- try {
- Class.forName( "oracle.jdbc.driver.OracleDriver" );
- conn = DriverManager.getConnection( "jdbc:oracle:thin:@(description=(ad dress_list=(address=(protocol=TCP)(port=1521)(host=192.168.0.240)))(connect_data=(SE RVER = DEDICATED)(SERVICE_NAME = db.efriendnet.com)))" , "efnx" , "efnx" );
- ps = conn.prepareStatement( "select * From tb_partyinfo" );
- rs = ps.executeQuery();
- while (rs.next())
- {
- System.out.println(rs.getString( "topic" ));
- }
- } catch (Exception e) {
- System.out.print(e.getMessage());
- }
- finally
- {
- if (rs != null ) { try {rs.close();} catch (SQLException e) {}}
- if (ps != null ) { try {ps.close();} catch (SQLException e) {}}
- if (conn != null ) { try {conn.close();} catch (SQLException e) {}}
- }
- }
别忘了import相应的包
八、编译程序
采用maven构建系统,则编译过程就独立了 出来。这时你再用eclipse自带的编译工具就不起作用了。所以要想编译、调试、运行还要做一些工作。以前是在dos命令行方式下进行编译,现在的插件 很好用,在eclipse配置一下就可以编译了。很方便。现在就做一个介绍。
Eclipse有一个扩展工具就是用来集成其他构建工具的在工程的 节点上点击鼠标右键,选择属性,在“编译”的右边窗口选择”新建”按钮,在对话框的“name”中输入:study,点击“Browse Workspace…”列出工程列表供选择。
选择完毕后,在goals中输入package。别忘了apply.好了,让我们Run吧。如果一切 正常,
控制台会打出maven的编译信息如下:
[INFO] ---------------------------------------------------------------------
[INFO] Building Maven Quick Start Archetype
[INFO] task-segment: [package]
[INFO] ---------------------------------------------------------------------
[INFO] resources:resources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:compile
[INFO] Nothing to compile - all classes are up to date
[INFO] resources:testResources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:testCompile
[INFO] Nothing to compile - all classes are up to date
[INFO] surefire:test
[INFO] Surefire report directory: D:/eclipse/workspace/study/target/s
urefire-reports
-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running com.efn.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.157 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] jar:jar
[INFO] Building jar: D:/eclipse/workspace/study/target/study-1.0-SNAPSHOT.jar
[INFO] ----------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ---------------------------------------------------------------------
[INFO] Total time: 4 second
[INFO] Finished at: Fri Aug 04 10:55:42 CST 2006
[INFO] Memory 2M/7M
[INFO] --------------------------------------------------------------------
注 意,别忘了每一次程序改动完毕后都要经过这一步编译。因为这是maven的编译器!
九、调试程序
经过以上步骤我们已经完成了mave管理下的 软件生命周期,但是作为一个程序开发人员我们还要进行调试。这里的调试设置和普通的java程序的调试是一样的。
首先,打开debug对话框:
因为是一个一般的java应用程序,所以我们选择 Java Application,点击“New”按钮,输入一些相应的参数,apply-Debug
Ok,一切正常!希望你也顺利!
十、结束语
本文只是简单的对maven的操作步骤做一个指 南性的说明,实际应用还有很多东西需要实践。如果发现哪里有错误和纰漏也欢迎批评指正!