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