Tomcat源码学习(一) 源码编译和导入Eclipse

 因为如今项目相对比较轻松，并且项目是研究SOA和Web Service的，所以这里我要对一些相关的开源技术作一些研究。接下来我要写的文章是Tomcat源码系列的文章，文章(一)是关于Tomcat源码编译和如何将Tomcat工程导入Eclips的，这里分享一下编译经验。
  你们都知道Java的开源项目很强大，正是这些开源项目促进大量优秀的程序员进步和推进软件的快速发展。了解和看过开源项目的程序员很多，可是真正参与进去的程序开发者就很少了。其实只有真正参与到开源项目中，咱们的开发能力就会大大加强，咱们的开发者就会更加优秀、更善于软件管理，咱们的软件产业也会越作越强。
  我以为能够用构建和谐社会的一句话来描述开源软件，那就是：在共享中共建，在共建中共享。好了，不说这么多了，开始咱们的Tomcat源码之旅了。
  
  1.下载Tomcat源码

  请先从 [url]http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91[/url] 下载版本控制工具SubVersion，下载到的是svn-win32-1.5.4.zip，解压后将bin路径放到环境变量path下，就可使用这个版本控制工具了。
  在MS-DOS窗口中输入：svn export[url]http://svn.apache.org/repos/asf/tomcat/tc6.0.x/tags/TOMCAT_6_0_18/[/url] F:\project\tomcat\apache-tomcat-6.0.18-src\  这里我把要下载的源码放到F盘的这个目录了。TOMCAT_6_0_18是当前最新的源码版本。
  该目录显示的就是Tomcat源码目录，这里的output目录和eclipse_output目录是没有的，这是我以后编译生成的目录。所以你们须要注意。
  
  2.编译并运行
  
  使用Ant工具进行代码编译。从 [url]http://ant.apache.org/bindownload.cgi[/url] 处下载Ant工具。我下载的是apache-ant-1.7.1-bin.zip，解压后把bin路径放到环境变量path下就可使用了。
  把该目录下的build.properties.default文件更名为：build.properties。打开build.properties，找到base.path=/usr/share/java，改成base.path=F:/project/share。F盘下的这个目录是我本地的存在的目录，读者能够设置本身电脑上一个存在的目录便可。
  在Tomcat编译过程当中，Ant会让咱们下载一些必要的依赖项目，base.path目录就是用来保存这些项目文件的，咱们能够将这个属性指向一个已经存在的目录。修改完base.path后，咱们回到MS-DOS窗口，切换到Tomcat源代码所在目录，而后运行ant download命令，以下图所示： 


  此次咱们等的时间较长，由于eclipse-JDT-3.2.zip大约有20多M，下载须要一段时间。一段时间后，编译器可能给出几个警告。这时咱们可发现刚才建立的base.path目录（F:/project/share）中已经下载了6个依赖项目，它们都是Tomcat编译所必须的。
  下面就开始真正的编译任务了，请在MS-DOS窗口内键入ant并回车，Ant将在2分钟内编译1000多个源文件并将Tomcat部署到output目录。编译顺利完成后，请打开Tomcat的源代码目录，会发现多了一个output目录，这是Ant的编译后的输出目录。请打开Tomcat源代码的output\build\bin子目录，双击startup.bat文件，咱们便可成功启动Tomcat6.0，若是不成功，请注意设置环境变量CATALINA_HOME，设置为F:\project\tomcat\apache-tomcat-6.0.18-src\output\build。此时咱们的编译工做就算顺利完成了。 
  这里可能会有错误出现：
    (1)执行ant download命令时出现错误，缘由多是找不到build.properties文件中的行 jdt.loc=http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.3.1-200709211145/eclipse-JDT-3.3.1.zip 这个包，读者在网上搜索到这个包后，把网址换一下便可。不过我用的都是最新的版本，至少在一段时间内都是可用的。
    (2)执行ant命令时出错，缘由有不少。我遇到的错误是以下错误：

[javac] D:\tomcat\share\tomcat6-deps\dbcp\src\java\org\apache\tomcat\dbcp\db
cp\BasicDataSource.java:43: org.apache.tomcat.dbcp.dbcp.BasicDataSource 不是抽象
的，而且未覆盖 java.sql.Wrapper 中的抽象方法 isWrapperFor(java.lang.Class<?>)
  [javac] public class BasicDataSource implements DataSource {
  [javac]     ^
  [javac] D:\tomcat\share\tomcat6-deps\dbcp\src\java\org\apache\tomcat\dbcp\db
cp\DelegatingStatement.java:45: org.apache.tomcat.dbcp.dbcp.DelegatingStatement
不是抽象的，而且未覆盖 java.sql.Statement 中的抽象方法 isPoolable()

    等等一大堆错误，这个缘由是因为我使用的JDK版本是1.6的，因此会出现这个问题，把JDK版本换成1.5的，把JAVA_HOME也换成1.5版本的JDK便可，这些错误就解决了。还有一些警告，不过没有关系。

    若是读者在编译过程当中还有其余错误和问题，请留言联系我。

  3.导入源码到Eclipse中

  (1)打开Eclipse，新建一个Java工程，选择“Create project from existing source”，导入现有的代码工程，以下图所示：


  点击“Finish”完成工程建立。
  (2)导入完成后，会看到一些错误提示。右击工程tomcat，选择"build Path"->Config Build path ，删除两个以TOMCAT_LIBS开头的两个库，保留JRE库和JUnit库。
  (3)把ant.jar（刚才下载的ant中的lib里有）和org.eclipse.jdt.core_3.3.1.v_780_R33x.jar（在刚才设置的F:\project\share中有）copy到代码工程下的lib文件夹下(lib文件夹以前没有，须要手动新建)。选择“Config Build path”->"Add library"，加入一个User library,把这两个jar包加进来，命名成tomcat_lib。在Tomcat最新版本6.0.18中，有两个.java代码文件：ServiceProxy.java和ServiceRefFactory.java中用到了一些其余包中的类，如import javax.xml.rpc.Service和import javax.wsdl.Definition等类，这些类分别在包jaxrpc.jar和wsdl4j-1.5.1.jar中，这两个包都在axis2的lib中，我下载的版本是axis-bin-1_4.zip，下载地址是：[url]http://apache.freelamp.com/ws/axis/1_4/axis-bin-1_4.zip [/url] 解压后在lib目录能够看到这两个jar包，直接加入到工程便可。
  添加完成后，以下图所示：


  (4)运行tomcat:找到tomcat的启动主类org.apache.catalina.startup包下的Bootstrap类，右击->“Run AS”->"Run Configurations"，在Arguments窗口中作以下设置：
    在Program arguments中写入:start
    在VM arguments中写入：-Dcatalina.home="F:\project\tomcat\apache-tomcat-6.0.18-src\output\build" 。以下图所示：



  而后运行，能够看到tomcat启动成功，以下图所示：



  (5)中止tomcat：跟上面步骤同样，在Program arguments中写入:stop，点击运行。便可中止tomcat。

  4.总结

  到此为止，咱们的tomcat源码的两种编译方式和导入Eclipse都已经完成，这里之因此导入到Eclipse是为了方便读代码，也能够对代码进行单步调式，看看代码的执行过程，这是比较有意义的事情。好了接下来的任务就是深刻代码内部了，这是一个使人激动的事情，由于tomcat是一个很优秀的项目，其代码也颇有诱惑力。不说了，我开始欣赏代码了，之后的文章就会跟你们分享代码的细节了，还去有兴趣读者关注和一块儿讨论。因为工程比较大，远远超过2M，我就不上传了，有须要的读者能够留言，我发给你们。

本文出自 “C++技术” 博客，请务必保留此出处http://panpan.blog.51cto.com/489034/120826