maven的部署、遇到的问题和心得体会

部署maven的一些要点、遇到的问题和心得体会

（图片看不了，可以下载doc文件）

一、   maven环境的搭建

1、 下载并配置maven（可做可不做）

（1）到http://maven.apache.org下载maven的最新版本,并解压到某一目录(假设是d:\apache-maven);

 

（2）配置系统环境变量:PATH里面加上d:\apache-maven\bin

（3）配置JAVA_HOME到jdk目录

（4）在命令行上输入 ： mvn -version; 回车，如看到下面信息表示安装成功：

 

（5）在命令行上输入 ： mvn help:system; 回车，会在当前用户目录下(win7是C:\Users\用户名,xp是c:\documents and settings\用户名),建立.m2目录。

 

2、 Eclipse集成maven

Update site是http://m2eclipse.sonatype.org/sites/m2e,全选安装就好了,重启eclipse.

这样就安装了eclipse集成的maven插件，但建议使用在第一步下载maven，做法如下：进入Preferences——》maven——》Installations，点击“Add”添加maven的解压路径。

 

 

3、建立settings.xml文件

如果没有做第一部操作，需要自己在当前用户目录下建立.m2目录。之后在.m2目录下建立setting.xml文件.注意： 《maven基本使用指南_小飞侠版1.doc》这个文档的配置是错误的，mvn install时会提示：连接不了180.200.3.76:8081的错误。是76服务器的maven私服没有建好的原因。

以下是我的配置，这里需要建立一个私服，在第四点介绍仓库时会介绍。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"

          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0

                      http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <localRepository>F:\maven</localRepository>

  <profiles>

    <profile>

             <id>dev</id>

      <repositories>

            <repository>

                                  <id>releases</id>

                                         <url>http://localhost:8888/nexus-2.0.3/content/repositories/releases</url>

                                         <releases><enabled>true</enabled></releases>

                         <snapshots><enabled>true</enabled></snapshots>

                         </repository>      

        <repository>

         <id>central</id>

         <name>Central</name>

         <url>http://localhost:8888/nexus-2.0.3/content/repositories/central/</url>

         <releases><enabled>true</enabled></releases>

         <snapshots><enabled>true</enabled></snapshots>

        </repository>

      </repositories>

    </profile>

  </profiles>

  <activeProfiles>

    <activeProfile>dev</activeProfile>

  </activeProfiles>

         </settings>

其中下面标注为红色的,需要修改为自己的一个本地目录,以后所有的jar包都会放在这个下面.

我们将项目所需要用到除源代码之外的东西（如jar包，tomcat,script等都放在上面）通过这个文件，MAVEN会从服务器会拉取jar包到本地，如果服务器上的包有更新，也会自动去更新，这样，当框架有新的版本出现时，不再需要我们手动去重新添加jar包这么麻烦。

 

二、网厅环境的搭建（我配置的是南昌网厅，遇到错误没有成功运行）

1、  检出entity、base为java project  ,biz为ejb project ,web为动态网页工程，script为javascript project。都有红叉叉，没事，继续下面的步骤后就好了。

2、  检出完成后对每个工程进行添加maven-enable依赖管理。

         选中项目右键“Maven—》Enable Depandency management”，弹出以下界面：

 

这里需要设置maven的坐标，可以参考第四点的坐标。Group ID使用com.maywide.ibh，artifact Id是构件的id，设置为项目的名称，version不用管。Packaging除了web project用war外，其他选jar。

3、  依赖管理。打开项目的pom.xml文件添加依赖项。如biz_nanchang的依赖配置如下：

<dependencies>

    <dependency>

      <groupId>com.maywide.ibh</groupId>

      <artifactId>base</artifactId>

      <version>0.0.1-SNAPSHOT</version>

    </dependency>

    <dependency>

      <groupId>com.maywide.ibh</groupId>

      <artifactId>entity</artifactId>

      <version>0.0.1-SNAPSHOT</version>

    </dependency>

    <dependency>

      <groupId>com.maywide.ibh</groupId>

      <artifactId>lib95</artifactId>

      <version>1.0</version>

    </dependency>

    <dependency>

      <groupId>com.maywide.ibh</groupId>

      <artifactId>lib96</artifactId>

      <version>1.0</version>

</dependency>

         添加了对base、entity项目的依赖。其中lib95、lib96是privatelib的jar包。我上传到私服时把它命名成这样了。Base、entity项目也需要添加对lib的依赖项，在私服需要一个个jar包上传，所以需要一个个的添加依赖，lib有94个jar吧，慢慢加呗。因为maven的依赖具有传递性的，所以biz_nanchang项目不需要添加对lib的jar包的依赖。同理，web_nanchang项目只需要添加对biz_nanchang的依赖就可以了。

         之后选择mvn install编译。

3、把biz_nanchang和web_nanchang项目的jdk改成1.6。进行maven下的操作时经常会把jdk给成1.5的，要检查一下。

 

4、添加maven的依赖库到Web Deployment Assembly。网上说要这样做的，防止找不到jar包，不过这一步我没体现到它的用处。

 

 

5、Web工程右键->Run as->Maven build,这时会跳出一个页面：如图：

 

 

在goals输入：tomcat:run-war，

 

在VM参数:添加

 -Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n

点击Apply，之后run就可以执行了。但期间遇到错误2、错误3和错误4。错误4没有解决导致网站无法运行。

 

三、我掌握的maven的一下知识点。

1、坐标

         Maven把项目作为构件，每个构件定义一个坐标，由于区分其他的构件，配置依赖时只需加入这个坐标，maven会先到本地仓库查找该构件，找不到就到远程仓库查找。

         坐标如下：

         GroupId：定义当前maven项目所属的实际项目。例如网厅项目使用com.maywide.ibh。

         ArtifactID:构件的ID，一个project、模块的id。

         Version:版本号。

         Packaging:打包的方式。默认是jar。Web project需要选择war。

 

2、maven的依赖在<dependency>标签里设置，需输入构件的坐标。Maven是传递依赖的。

3、仓库

    仓库是存储构件的地方。Maven有本地仓库和远程仓库之分。

    （1）本地仓库

    在setting.xml的<localRepository>F:\maven</localRepository>里面配置本地仓库的位置 ，项目所需的构件会被下载到该目录。如网厅项目，我们可以打开该目录F:\maven，可以进入com文件夹—》maywinde文件夹—》ibh文件夹，看到我们的base、entity、biz等项目。

       （2）远程仓库

       远程仓库分为中央仓库和私服。

       中央仓库是全世界共享的一下常见的构件。

       私服是一家公司、企业自己建的用于存储构件的的一个maven服务器,还有它也起到代理中央仓库的作用。目前最多人使用的是用nexus搭建maven私服。

 

私服的仓库分成4类：group（仓库组）、hosted（宿主）、proxy（代理）和虚拟（virtual）。Nexus默认已经有中央仓库的代理了。只需把下面提供的url配置到setting.xml文件了。

 

         我们要使用到的是宿主仓库，用于存放项目的jar包。Maven提供Releases仓库用于存放发布版本的构件；Snapshots存放快照版本的构件；3rd party存放第三方构件。

         选择一个仓库，可以进入以下界面上传构件：

 

 

四、遇到的问题和解决

错误1 ： [ERROR] Failed to execute goal on project biz_zhuhai: Could not resolve dependencies for project biz_zhuhai:biz_zhuhai:jar:0.0.1-SNAPSHOT: Failed to collect dependencies for [com.maywide.ibh:lib345:pom:1.0 (compile)]: Failed to read artifact descriptor for com.maywide.ibh:lib345:pom:1.0: Could not transfer artifact com.maywide.ibh:lib345:pom:1.0 from/to releases (http://localhost:9888/nexus-2.0.3/content/repositories/releases): Connection to http://localhost:9888 refused: Connection refused: connect -> [Help 1]

解决：这是配置的url有错误或者是私服没有配好，导致构件下载时出错。如果没有jar包需要在私服里下载，可以不配置私服的，也就是可以把setting.xml的profiles里的东西全部删除的。

 

错误2：[ERROR] Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.10:test (default-test) on project web_nanchang: There are test failures.

[ERROR]

[ERROR] Please refer to E:\maven\web_nanchang\target\surefire-reports for the individual test results.

 

    解决：这是因为测试代码时遇到错误，它会停止编译。只需要在pom.xml的<project>里添加以下配置，使得测试出错不影响项目的编译。

<build>

    <plugins>

      <plugin>

        <groupId>org.apache.maven.plugins</groupId>

        <artifactId>maven-surefire-plugin</artifactId>

        <configuration>

          <testFailureIgnore>true</testFailureIgnore>

        </configuration>

      </plugin>

    </plugins>

 </build>

 

         错误3：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-war-plugin:2.1.1:war (default-war) on project web_nanchang: Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode) -> [Help 1]

[ERROR]

[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

[ERROR] Re-run Maven using the -X switch to enable full debug logging.

[ERROR]

[ERROR] For more information about the errors and possible solutions, please read the following articles:

    解决：maven的web项目默认的webroot是在src\main\webapp。如果在此目录下找不到web.xml就抛出以上的异常。解决方法在pom.xml加入以下的配置。红色背景字体改成你网站的根目录。

<build>
<finalName>simple-webapp</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.1.1</version>
<configuration>
<webResources>
<resource>
<!-- this is relative to the pom.xml directory -->
<directory>WebContent</directory>
</resource>
</webResources>
</configuration>
</plugin>
</plugins>
</build>

 

错误4： 严重: The web application [/web_nanchang] registered the JBDC driver [org.hsqldb.jdbc.JDBCDriver] but failed to unregister it when the web application was stopped. To prevent a memory leak, the JDBC Driver has been forcibly unregistered.

2012-4-27 10:36:49 org.apache.catalina.loader.WebappClassLoader clearReferencesJdbc

严重: The web application [/web_nanchang] registered the JBDC driver [com.mysql.jdbc.Driver] but failed to unregister it when the web application was stopped. To prevent a memory leak, the JDBC Driver has been forcibly unregistered.

还不知道怎样解决，导致运行不了。

错误5：

 

这个感觉怪怪的，遇过几次。把java complier改成1.6或者disabled dependency manangent后在enable它，搞着搞着就消失了。

 

五、心得体会：

       这次maven的部署用了一个多星期。起初对maven不了解，按着小飞侠的文档来部署，但那个文档是boss2的，而我配的是网厅项目，部署不成功又不知道什么原因。所以我觉得用boss2的配置文档去配置网厅的，应该先弄清楚每一步是什么意思。就比如boss2的项目为什么不需要检出lib和privatelib呢，是因为私服里已经有了jar包，而网厅的没有，所以不理解地按着文档搞是白搞的。

       之后我上网找资料，还买了本书，去学习maven。结果学习了一些maven的知识，知道怎样配私服，还按书本部署了几个简单的项目。但当用到网厅的时候出现一些奇怪的错误，上网找答案，尝试了多种方法解决了一些错误。我觉得一个部署项目好郁闷啊，如果有个人请教一下或者讨论一下，会很高效。

评论

5 楼 yudey 2013-07-29  

不错。赞一个！

4 楼 elang0705 2013-07-11  

不错，楼主继续分享，支持！！！

3 楼 lowitty 2013-01-24  

非常感谢楼主啊，帮组很大。

2 楼 wkywahaha 2012-11-12  

关于打war包的那个错误，我这边有时候需要指定路径到web.xml这一级，而又时候只需要指定到webContent这一级·····很奇怪····麻烦指导下

1 楼 Sweblish 2012-08-11  

不错，看过留个言！