使用Eclipse构建Maven项目 (step-by-step)

Maven这个个项目管理和构建自动化工具,愈来愈多的开发人员使用它来管理项目中的jar包。本文仅对Eclipse中如何安装、配置和使用Maven进行了介绍。彻底step by step。css

若是以为本文对你有用,请移步到:http://download.csdn.net/detail/qjyong/5582071 下载PDF版,http://download.csdn.net/detail/qjyong/5582087 下载配套示例项目源代码。html

1.   Eclipse-jee的安装

进入eclipse官网的下载页面:http://www.eclipse.org/downloads/,以下图所示:java

根据你的操做系统具体状况选择相应的版本。我这里选择的是“Eclipse IDE for JavaEE Developers”的Windows 32 Bit版本。下载到本地磁盘便可。把下载完成的“eclipse-jee-juno-SR2-win32.zip”解压缩到本地磁盘指定目录下。我这里是解压缩在D:盘根目录下。mysql

进入解压缩后的目录中,双击“eclipse.exe”便可打开Eclipse的工做界面。(注:Eclipse正常运行的前提是在系统变量中存在名为“JAVA_HOME”的变量,值为JDK的安装目录)。web

2.   Maven的安装和配置

2.1.  安装

进入Maven官网的下载页面:http://maven.apache.org/download.cgi,以下图所示:spring

 

选择当前最新版本:"apache-maven-3.0.4-bin.zip",下载到本地,解压缩到本地磁盘D:下。sql

 

2.2.  配置

进入Maven安装目录下的conf子目录中,打开settings.xml进行配置修改。数据库

2.2.1.   修改默认的本地仓库位置

Maven默认的本地仓库位置是当前用户工做目录下的".m2/repository",使用过程当中这个目录里的文件会比较多,占用空间愈来愈大。通常建议更换到其它磁盘目录下。以下配置,就把默认的本地仓库更改到D: /.m2/repository这个目录(这个目录结构须要本身建立好)。apache

<localRepository>d:/.m2/repository</localRepository>

Maven默认的中央仓库里的文件不全。因此,都须要自行添加其它的镜像地址。在settings.xml文件中的"<mirrors>"标签里添加以下内容:

<mirror>
     <id>ibiblio</id>
     <mirrorOf>central</mirrorOf>
     <name>Human Readable Name for this Mirror.</name>
     <url>http://mirrors.ibiblio.org/maven2/</url>
</mirror>

2.2.2.   修改默认的中央仓库镜像

保存所作的修改,同时还须要把这个settings.xml文件复制一份到"D:/.m2"目录下。api

3.   Eclipse中m2eclipse插件的安装

Eclipse默认不支持Maven。须要给它添加m2eclipse插件。下面是具体的操做步骤。

3.1.  插件安装

依次选择Eclipse菜单栏的"Help"菜单 -- "Instance NewSoftWare"菜单项,就会弹出以下对话窗口:

 

选择"Add.."按钮,又会弹出以下对话框:

 

     这个对话框就是用于添加一个插件地址的。在"Name"对应的输入框里输入该操做的一个标识名。在"Location"对应的输入框里输入这个插件的安装地址。注:Maven的Eclipse插件地址为:http://download.eclipse.org/technology/m2e/releases。输入后,以下图所示:

 

输入完成后,点击右下角的"OK"按钮,就会弹出以下对话框:

 

这里须要选择想要安装的插件的详细内容。选中"Maven Integration for Eclipse"前面的复选框。以下图所示:

 

选择完成后,点击右下方的"Next>"按钮进行安装。安装成功后,会提示须要重启Eclipse来生效此次配置。重启以后,这个Eclipse就可使用m2eclipse插件功能了。

3.2.  配置

插件安装好以后,还须要进行一些配置才可以开始使用Maven的功能。

3.2.1.   设置m2eclipse插件所关联的Maven程序

依次选择Eclipse菜单栏的"Window" -- "Preferences"菜单项,就会弹出以下对话框:

在这个对话框左边的导航栏中展开"Maven"目录结点,并选择"Installations"子节点,以下图所示:

 

这里须要关联上对应的Maven安装程序。具体操做是,在右边面板中选择"Add…"按钮,会弹出以下选择Maven安装目录的选择对话框:

 

经过这个对话框来选择Maven的具体安装目录。选择好以后就点击“肯定”按钮。以下图所示:

 

3.2.2.   设置自定义的本地仓库

选择如上图对话窗口左边菜单树 "Maven"节点下的"UserSettings"子节点,它默认的配置文件是"C:\Documents and Settings\csdn\.m2\settings.xml",以下图所示:

这边须要修改成咱们自定义仓库位置下的settings.xml文件。具体操做是,点击"Browse…"按钮来选择上一步骤修改的本地仓库目录下的settings.xml文件,以下图所示:

在上图中选择D:/.m2目录下的"settings.xml"文件,点击"打开"按钮来确认刚才的选择,就会回到以下图的对话窗口中:

在上图中点击右下角的"OK"按钮来完成全部的配置修改。

4.   使用Maven来构建Web项目

4.1.  建立Maven的web项目

m2eclispe插件中默认提供了一些Maven样板项目,可使用这些样板来建立符合咱们要求的项目。具体操做以下步骤:

在eclipse菜单栏中选择"File" -- "News" -- "Other"菜单项,就会打开以下对话窗口,在窗口中选择"Maven"节点下"Maven Project"条目,以下图所示:

点击"Next>"按钮,进入以下窗口:

再次选择"Next >"按钮,进入以下窗口:

在这个窗口中选择"maven-archetype-webapp"来建立一个Maven的web项目,再选择"Next>"按钮,进入以下图窗口:

在上图窗口的"Group Id"中输入项目的基本包名,在"Artifact Id"中输入项目名,其它输入框不用理会。点击"Finish"按钮来完成项目的整个建立过程。

以后,Maven就会根据项目的配置去中央仓库下载相应的文件和jar包。完成后,就有以下项目目录结构:

如上图所示,"pom.xml"文件就是这个项目的maven配置文件。打开此文件,并在"<build>"标签内添加以下配置:

<defaultGoal>install</defaultGoal>
<plugins>
         <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-surefire-plugin</artifactId>
                   <configuration>
                            <skip>true</skip>
                   </configuration>
         </plugin>
 
         <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-compiler-plugin</artifactId>
                   <version>2.5.1</version>
                   <configuration>
                            <source>1.6</source>
                            <target>1.6</target>
                            <encoding>UTF-8</encoding>
                   </configuration>
         </plugin>
</plugins>

这段配置中"<defaultGoal>"标签指定maven的默认操做是"install“;”maven-surefire-plugin“插件配置了”忽略编译项目时的测试运行“;”maven-compiler-plugin“插件指定了一些编译时的信息配置。

4.2.  使用Maven添加项目依赖包

Java Web项目中还须要添加ServletAPI、JSP API以及JSTL的jar包,这能够直接在pom.xml文件中添加了。以下pom.xml文件中就添加了Servlet-API 2.5版本、JSP-API2.1版本、JSTL 1.2版本:

<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.qiujy</groupId>
         <artifactId>testweb_svn</artifactId>
         <packaging>war</packaging>
         <version>0.0.1-SNAPSHOT</version>
         <name>testweb_svn Maven Webapp</name>
         <url>http://maven.apache.org</url>
         <dependencies>
                   <dependency>
                            <groupId>javax.servlet</groupId>
                            <artifactId>servlet-api</artifactId>
                            <version>2.5</version>
                            <scope>provided</scope>
                   </dependency>
                   <dependency>
                            <groupId>javax.servlet.jsp</groupId>
                            <artifactId>jsp-api</artifactId>
                            <version>2.1</version>
                            <scope>provided</scope>
                   </dependency>
                   <dependency>
                            <groupId>javax.servlet</groupId>
                            <artifactId>jstl</artifactId>
                            <version>1.2</version>
                   </dependency>
         </dependencies>
         <build>
                   <finalName>testweb_svn</finalName>
                   <defaultGoal>install</defaultGoal>
                   <plugins>
                            <plugin>
                                     <groupId>org.apache.maven.plugins</groupId>
                                     <artifactId>maven-surefire-plugin</artifactId>
                                     <configuration>
                                               <skip>true</skip>
                                     </configuration>
                            </plugin>
                   </plugins>
         </build>
</project>

这里说明一下:对Servlet和JSP的API包,在编译web项目时须要使用,而把web项目打包部署到web容器(如Tomcat)中运行时就不须要了。所以,这里把它们的<scope>配置为provided。

4.3.  把Maven项目转换成Eclipse工程

为了便于在Eclipse中开发JavaWeb项目,咱们须要把Maven项目的目录结构转换成Eclipse工程的目录结构,具体按以下操做步骤进行。

选中项目在右键菜单中选择"Properties",弹出以下图所示对话窗口:

选中左边功能树中的"ProjectFacets"节点,而后在对应的右边面板中点击"Convert to faceted from…"这个超连接,右边面板就会切换成以下图所示:

在"Project Facet"中进行相应配置,以下图所示:

配置好以后,选择窗口右下角的"OK"按钮来保存配置。这时,这个Maven项目就会转换成Eclipse的web工程目录结构。

若是还须要直接在Eclipse中运行这个web工程,还须要把Maven依赖包添加到本项目类路径中:

还须要添加部署到Tomcat时的依赖包,以下图:

点击"Finish"来完成后,对话框以下图所示:

以后点击"OK"按钮来完成这些设置。

4.4.  把web.xml修改为相应版本

因为Maven中的"maven-archetype-webapp"样板项目的"web.xml"是2.3版本的,咱们须要替换成新版本:能够把Eclipse的web工程webContent/WEB-INF目录下的"web.xml"文件复制替换掉"src/main/webapp/WEB-INF/"目录下的web.xml文件。

注意:因为Maven项目编译和发布时,它只是把"src"目录下的资源压缩到一个war包中。而使用Eclipse-JEE开发web项目时,都是把页面资源(html/css/js/img/JSP)放置在WebContent目录下。因此,在使用Maven来编译和发布项目前,须要把WebContent目录下的资源复制到"src/main/webapp/"目录下。

5.   使用Maven编译和发布项目

在项目中的"pom.xml"文件上点击右键,在弹出的菜单中选择"Run AS" -- "Maveninstall"来编译和生成项目。以下图所示:

在编译和生成过程当中,能够在"Console"面板中能够看到Maven编译过程的信息,若是编译和生成成功,能够在"Console"面板看到"BUILD SUCCESS"字样。

另外,在修改pom.xml文件中的相关jar包信息时,可能因为仓库中不存在,就会出现一些错误,这时,项目编译就可能存在一些问题。此时可经过"Maven clean"选项来清除编译,而后再修改pom.xml到正确状况。再经过"Maven install"来编译和生成。

6.   示例项目代码

7.   附文件

以下是一个SpringMVC3+Spring3+Hibernate4的web项目中的pom.xml文件:

<projectxmlns="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.qiujy</groupId>
    <artifactId>site2013</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>site2013 Maven Webapp</name>
    <url>http://maven.apache.org</url>
 
    <properties>
       <spring.version>3.2.3.RELEASE</spring.version>
       <hibernate.version>4.2.2.Final</hibernate.version>
       <slf4j.version>1.7.5</slf4j.version>
       <jackson.version>2.2.2</jackson.version>
    </properties>
 
    <dependencies>
       <!-- servlet/jsp api -->
       <dependency>
           <groupId>javax.servlet</groupId>
           <artifactId>servlet-api</artifactId>
           <version>2.5</version>
           <scope>provided</scope>
       </dependency>
       <dependency>
           <groupId>javax.servlet.jsp</groupId>
           <artifactId>jsp-api</artifactId>
           <version>2.1</version>
           <scope>provided</scope>
       </dependency>
 
       <!-- jstl -->
       <dependency>
           <groupId>javax.servlet</groupId>
           <artifactId>jstl</artifactId>
           <version>1.2</version>
       </dependency>
       <!-- javaxmail
       <dependency>
           <groupId>javax.mail</groupId>
           <artifactId>mail</artifactId>
           <version>1.4.5</version>
        </dependency>-->
 
       <!-- slf4j -->
       <dependency>
           <groupId>org.slf4j</groupId>
           <artifactId>slf4j-log4j12</artifactId>
           <version>${slf4j.version}</version>
       </dependency>
 
       <!-- junit -->
       <dependency>
           <groupId>junit</groupId>
           <artifactId>junit</artifactId>
           <version>4.8.2</version>
       </dependency>
 
       <!-- proxool <dependency> <groupId>proxool</groupId> <artifactId>proxool</artifactId>
           <version>0.8.3</version> </dependency> -->
 
       <!-- mysql driver -->
       <dependency>
           <groupId>mysql</groupId>
           <artifactId>mysql-connector-java</artifactId>
           <version>5.1.22</version>
       </dependency>
 
       <!-- sql server数据库驱动 <dependency> <groupId>net.sourceforge.jtds</groupId>
           <artifactId>jtds</artifactId> <version>1.3.0</version> </dependency> -->
 
       <!-- oracle数据库驱动:maven仓库中的ojdbc下载须要oracle的官方受权,先在网上找一个ojdbc14.jar包,上传到本地的maven仓库
           mvn install:install-file -Dfile=D:/resources/ojdbc/ojdbc14.jar -DgroupId=com.oracle
           -DartifactId=ojdbc14 -Dversion=10.2.0.1.0 -Dpackaging=jar <dependency> <groupId>com.oracle</groupId>
           <artifactId>ojdbc14</artifactId> <version>10.2.0.4.0</version> </dependency> -->
 
       <!-- fileupload -->
       <dependency>
           <groupId>commons-fileupload</groupId>
           <artifactId>commons-fileupload</artifactId>
           <version>1.2.2</version>
       </dependency>
       <!-- io -->
       <dependency>
           <groupId>commons-io</groupId>
           <artifactId>commons-io</artifactId>
           <version>2.4</version>
       </dependency>
 
       <!-- c3p0 -->
       <dependency>
           <groupId>c3p0</groupId>
           <artifactId>c3p0</artifactId>
           <version>0.9.1.2</version>
       </dependency>
 
       <!-- struts2 <dependency> <groupId>org.apache.struts</groupId> <artifactId>struts2-core</artifactId>
           <version>${struts.version}</version> <exclusions> <exclusion> <artifactId>javassist</artifactId>
           <groupId>javassist</groupId> </exclusion> </exclusions> </dependency> <dependency>
           <groupId>org.apache.struts</groupId> <artifactId>struts2-spring-plugin</artifactId>
           <version>${struts.version}</version> <exclusions> <exclusion> <artifactId>spring-core</artifactId>
           <groupId>org.springframework</groupId> </exclusion> </exclusions> </dependency> -->
 
       <!-- spring3 -->
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-beans</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-context</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <!-- spring须要的aspectj依赖包 -->
       <dependency>
           <groupId>org.aspectj</groupId>
           <artifactId>aspectjweaver</artifactId>
           <version>1.7.2</version>
       </dependency>
 
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-tx</artifactId>
           <version>${spring.version}</version>
       </dependency>
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-jdbc</artifactId>
           <version>${spring.version}</version>
       </dependency>
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-orm</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-context-support</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <!-- spring web -->
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-web</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <!-- spring mvc -->
       <dependency>
           <groupId>org.springframework</groupId>
           <artifactId>spring-webmvc</artifactId>
           <version>${spring.version}</version>
       </dependency>
 
       <!-- <dependency> <groupId>org.quartz-scheduler</groupId> <artifactId>quartz</artifactId>
           <version>2.1.6</version> </dependency> -->
 
       <!-- hibernate4 -->
       <dependency>
           <groupId>org.hibernate</groupId>
           <artifactId>hibernate-core</artifactId>
           <version>${hibernate.version}</version>
           <exclusions>
              <exclusion>
                  <groupId>org.slf4j</groupId>
                  <artifactId>slf4j-api</artifactId>
              </exclusion>
           </exclusions>
       </dependency>
       <dependency>
           <groupId>org.hibernate</groupId>
           <artifactId>hibernate-ehcache</artifactId>
           <version>${hibernate.version}</version>
       </dependency>
 
       <dependency>
           <groupId>com.fasterxml.jackson.core</groupId>
           <artifactId>jackson-databind</artifactId>
           <version>${jackson.version}</version>
       </dependency>
    </dependencies>
 
    <!-- ========================================================== -->
    <build>
       <finalName>site2013</finalName>
       <defaultGoal>install</defaultGoal>
       <plugins>
           <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-surefire-plugin</artifactId>
              <configuration>
                  <skip>true</skip>
              </configuration>
           </plugin>
 
           <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>2.5.1</version>
              <configuration>
                  <source>1.6</source>
                  <target>1.6</target>
                  <encoding>UTF-8</encoding>
              </configuration>
           </plugin>
       </plugins>
    </build>
</project>

本文转自:http://blog.csdn.net/qjyong/article/details/9098213

相关文章
相关标签/搜索