使用Maven+Eclipse+Tomcat小结

在开发中，初次准备引入maven, 原本的开发环境是Eclipse+Tomcat。因为对maven的其他功能不是很熟悉，所以最初准备只使用它的依赖管理的功能，不影响现有的开发模式。

作如下配置：nexus配置完成，搭建了私服。使用外的的Tomcat作web容器。Eclipse 已经添加了maven 需要的插件m2eclipse等。

在编译的时候，有时候会说没有tools.jar，那么在installed jre的jdk中加入jdk/lib/下的所有的包。再在启动eclipse时，加入一行启动参数： -vm"D:/javaDev/jdk1.5.0.8/bin",这样就保证了它是在jdk下运行，否则它会在Eclipse自带的jre下运行。 注意,vm与后面的路径之间不要有空格。

原工程不是maven推荐的结构。现在要使用maven, 只需要在原工程的根目录下新建一个pom.xml文件，因为我们这里不是采用的maven 的标准目录结构，所以，需要在注意pom.xml需要指定目录结构，以覆盖它的标准目录结构。

现在的目录结构如下：

需要把这个工程转化为maven 工程。按如下步骤：

1. 在这个工程上new->other->maven pom profile, 生成一个基本的pom.xml 文件。
2. 在pom.xml中添加如下的信息：

<build>

<directory>target</directory><!-- 这是打包的文件的路径。默认是该工程的根目录。 -->

<finalName>dwr2.0.5</finalName><!--生成的目标文件名 -->

<sourceDirectory>src</sourceDirectory><!-- 源文件名夹的名称。这里对应填写我们的src目录。 -->

<outputDirectory>WebRoot/WEB-INF/classes</outputDirectory><!--编译后的java文件输出的文件夹位置。 -->

<testSourceDirectory>test/java</testSourceDirectory><!-- 测试文件源文件夹。这里与src文件夹的定义是相同的。在打包时有区别，打包时，test文件夹下的源文件和资源文件都不被打到war包里面。 -->

<resources><!-- 存放资源文件。这里的文件不需要编译，在部署打包时，直接复制这里的文件 -->

<resource>

<directory>src/resources</directory><!-- -->

<excludes>

<exclude>**/*.java</exclude><!--例外的文件类型。如果这里存放有.java文件，则仍然需要编译。 -->

</excludes>

</resource>

</resources>

<testResources><!-- 与上面resource的意义相同。 -->

<testResource>

<directory>test/resources</directory>

<excludes>

<exclude>**/*.java</exclude>

</excludes>

</testResource>

</testResources>

<scriptSourceDirectory><!--脚本源文件。这里的文件也不用经过编译。通常存放css,javascript,img等文件内容。 -->

</scriptSourceDirectory>

</build>

3. 定义使用的插件，我们加入tomcat 的插件，方便开发调试及部署。其中，tomcat插件可以支持外部的tomcat的开发和部署。另外，开发web应用，还需要加入war 的插件。这些plugins也在build节点中。

<plugins><!-- -->

<plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>tomcat-maven-plugin</artifactId>

<version>1.0-beta-1</version>

<configuration>

<url>http://localhost/manager</url>

</configuration>

</plugin>

<plugin>

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

<artifactId>maven-war-plugin</artifactId>

<version>2.0.2</version>

<configuration>

<warSourceDirectory>WebRoot</warSourceDirectory>

<dependentWarExcludes>

**/jdbc.properties,**/hibernate.cfg.xml,**/sql-map-config.xml,**/web.xml,WEB-INF/classes/META-INF/**

</dependentWarExcludes>

</configuration>

</plugin>

</plugins>

4. 定义使用到的jar文件：

<!-- 定义使用到的jar文件。按照我们在nexus中查到的dependency节点抄下来即可（指定了包，类库名，版本号）。 -->

<dependencies>

<dependency>

<groupId>net.bingo</groupId>

<artifactId>dwr</artifactId>

<version>2.0.5</version>

</dependency>

<dependency>

<groupId>commons-logging</groupId>

<artifactId>commons-logging</artifactId>

<version>1.0.4</version>

</dependency>

</dependencies>

5. 完整的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 http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>

<groupId>dwr2.0.5</groupId>

<artifactId>dwr2.0.5</artifactId>

<name>dwr2.0.5</name>

<version>0.0.1-SNAPSHOT</version>

<packaging>war</packaging>

<url>@mailto:[email protected]</url>

<build>

<directory>target</directory><!-- 这是打包的文件的路径。默认是该工程的根目录。 -->

<finalName>dwr2.0.5</finalName><!--生成的目标文件名 -->

<sourceDirectory>src</sourceDirectory><!-- 源文件名夹的名称。这里对应填写我们的src目录。 -->

<outputDirectory>WebRoot/WEB-INF/classes</outputDirectory><!--编译后的java文件输出的文件夹位置。 -->

<testSourceDirectory>test/java</testSourceDirectory><!-- 测试文件源文件夹。这里与src文件夹的定义是相同的。在打包时有区别，打包时，test文件夹下的源文件和资源文件都不被打到war包里面。 -->

<resources><!-- 存放资源文件。这里的文件不需要编译，在部署打包时，直接复制这里的文件 -->

<resource>

<directory>src/resources</directory><!-- -->

<excludes>

<exclude>**/*.java</exclude><!--例外的文件类型。如果这里存放有.java文件，则仍然需要编译。 -->

</excludes>

</resource>

</resources>

<testResources><!-- 与上面resource的意义相同。 -->

<testResource>

<directory>test/resources</directory>

<excludes>

<exclude>**/*.java</exclude>

</excludes>

</testResource>

</testResources>

<scriptSourceDirectory><!--脚本源文件。这里的文件也不用经过编译。通常存放css,javascript,img等文件内容。 -->

</scriptSourceDirectory>

<plugins><!-- tomcat 的插件 -->

<plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>tomcat-maven-plugin</artifactId>

<version>1.0-beta-1</version>

<configuration>

<url>http://localhost/manager</url>

</configuration>

</plugin>

<plugin>

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

<artifactId>maven-war-plugin</artifactId>

<version>2.0.2</version>

<configuration>

<warSourceDirectory>WebRoot</warSourceDirectory>

<dependentWarExcludes>

**/jdbc.properties,**/hibernate.cfg.xml,**/sql-map-config.xml,**/web.xml,WEB-INF/classes/META-INF/**

</dependentWarExcludes>

</configuration>

</plugin>

</plugins>

</build>

<!-- 定义使用到的jar文件。按照我们在nexus中查到的dependency节点抄下来即可（指定了包，类库名，版本号）。 -->

<dependencies>

<dependency>

<groupId>net.bingo</groupId>

<artifactId>dwr</artifactId>

<version>2.0.5</version>

</dependency>

<dependency>

<groupId>commons-logging</groupId>

<artifactId>commons-logging</artifactId>

<version>1.0.4</version>

</dependency>

</dependencies>

<!--这是生成站点

<distributionManagement>

<site>

<id>website</id>

<url>http://localhost/www/docs/project/</url>

</site>

</distributionManagement>

-->

</project>

6. 在.m2/setting.xml中的文件设置如下：

<?xml version="1.0"?>

<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">

<servers>

<!-- 前两个server是设置的上传到私服的用户名和密码。分别可以上传release 版本和snapshot版本的。后面的是部署到tomcat下的，提供tomcat的manager角色的用户名和密码，注意与你的tomcat下conf/tomcat-users.xml中的设置保持一致。因为通过的是UI的方式部署，所以需要先启动tomcat。 -->

<server>

<id>nexus-releases</id>

<username>admin</username>

<password>admin123</password>

</server>

<server>

<id>nexus-snapshots</id>

<username>admin</username>

<password>admin123</password>

</server>

<server>

<id>tomcat-server</id>

<username>admin</username>

<password></password>

</server>

</servers>

<mirrors>

<mirror>

<id>Nexus</id>

<name>Nexus Public Mirror</name>

<url>http://localhost:8081/nexus/content/groups/public</url>

<mirrorOf>central</mirrorOf>

</mirror>

<mirror>

<!--This is used to direct the public snapshots repo in the

profile below over to a different nexus group -->

<id>nexus-public-snapshots</id>

<mirrorOf>public-snapshots</mirrorOf>

<url>

http://localhost:8081/nexus/content/groups/public-snapshots

</url>

</mirror>

<mirror>

<!--This sends everything else to /public -->

<id>nexus</id>

<mirrorOf>*</mirrorOf>

<url>http://localhost:8081/nexus/content/groups/public</url>

</mirror>

</mirrors>

<profiles>

<profile>

<id>development</id>

<repositories>

<repository>

<id>central</id>

<url>http://central</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</repository>

</repositories>

<pluginRepositories>

<pluginRepository>

<id>central</id>

<url>http://central</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</pluginRepository>

</pluginRepositories>

</profile>

<profile>

<!--this profile will allow snapshots to be searched when activated-->

<id>public-snapshots</id>

<repositories>

<repository>

<id>public-snapshots</id>

<url>http://public-snapshots</url>

<releases>

<enabled>false</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

</snapshots>

</repository>

</repositories>

<pluginRepositories>

<pluginRepository>

<id>public-snapshots</id>

<url>http://public-snapshots</url>

<releases>

<enabled>false</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

</snapshots>

</pluginRepository>

</pluginRepositories>

</profile>

</profiles>

<activeProfiles>

<activeProfile>development</activeProfile>

</activeProfiles>

</settings>

注意所有的localhost 都需要改为实际nexus 所安装在的文件服务器的IP地址。nexus的默认端口是8081，可不修改。

7. 现在就可以像以前一样使用tomcat +Eclipse 了。我们以前使用tomcat的部署方式不受任何影响。断点调试等问题，因为是使用的外部的Eclipse 和Tomcat，与maven 并无关系，所以这些都不受影响。唯一的区别就是，我们现在的jar包，可以通过在pom.xml定义了以后，执行install命令进行安装了。开发时和暴露式部署后，在WEB-INF/lib的目录是空的，我们的jar包只是以外部类库引用的方式在使用，同时在SVN提交代码时，也不再需要关心jar文件了。只有在打war包的时候，WEB-INF/lib的目录会包含用到的jar文件。
8. 至此，我们的初步的目标--使用maven 管理依赖的这个目标已经达到。而且，因为我们已经有了自己的目录结构，另外使用maven 的其他功能也已经很容易实现了。看了许多天，终于成功使用，作一小结，以兹纪念。guorabbit, 2009-03-27.