Eclipse中搭建Apache Tomcat源码调试环境

我就是我 2022-06-02 02:36 249阅读 0赞

最近对tomcat的底层实现很感兴趣，想对tomcat底层一探究竟，第一步要做的肯定就是下载源码，于是乎按照网上的博客论坛进行一步步操作，经过实测有些地方写的还是不够详细，因此在这我把自身的操作过程给大家分享。

# 下载源码 #

两种发方法

## 官网直接下载源码 ##

[http://tomcat.apache.org/download-70.cgi][http_tomcat.apache.org_download-70.cgi]

## Eclipse导入github源码 ##

[https://github.com/apache/tomcat][https_github.com_apache_tomcat]

看个人喜好，我一般喜欢通过Eclipse的插件导入项目源码，如果导入源码网上资料一堆，大家可以去查询

[http://blog.csdn.net/xiongyouqiang/article/details/78903975][http_blog.csdn.net_xiongyouqiang_article_details_78903975]

# 源码导入到Eclipse中 #

第1步：Eclipse中新建一个Java Project，例如名称可以是tomcat

![20171231112554446][]

第2步：在工程上点击右键=>Import=>General=>File System，点击Next按钮。

![20171231112555013][]

第3步：点击Browser按钮，找到tomcat源码解压路径，勾选java、test、conf和webapps目录（注意不需要勾选examples目录），点击Finish按钮。

![20171231112555977][]

第4步：在java和test目录上点击右键=>Build Path=>Use As Source Folder將这两个目录设为源码目录。同时可以删除工程中原有的src目录了。

![20171231112556846][]

第5步：解决导入后工程中出现的编译错误，一般都是由于缺少某些jar导致

主要导入以下几个jar饱

ant.jar

ecj-4.4.2.jar

jaxrpc.jar

wsdl4j-1.5.2.jar

easymock-3.5.1.jar

在工程中新建一个lib目录，將这些jar包放到该目录下，同时添加到build path中。

![20171231112557437][]

apache tomcat采用junit作为单元测试工具，我们需要为工程添加Junit支持，在工程上点击右键=>Properties=>Java build path。

![20171231112559192][]

点击Add Library按钮，选择Junit4即可。

此时test包中的TestCookieFilter类会报CookieFilter编译异常，这是因为缺少CookieFilter这个类导致，经过一番查找总算找到了CookieFilter源码如下所示：

/\*

\* Licensed to the Apache Software Foundation (ASF) under one or more

\* contributor license agreements. See the NOTICE file distributed with

\* this work for additional information regarding copyright ownership.

\* The ASF licenses this file to You under the Apache License, Version 2.0

\* (the "License"); you may not use this file except in compliance with

\* the License. You may obtain a copy of the License at

\* http://www.apache.org/licenses/LICENSE-2.0

\* Unless required by applicable law or agreed toin writing, software

\* distributed under the License is distributed on an "AS IS" BASIS,

\* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

\* See the License for the specific language governing permissions and

\* limitations under the License.

\*/

package util;

import java.util.Locale;

import java.util.StringTokenizer;

/\*\*

\* Processes a cookie header and attempts to obfuscate any cookie values that

\* represent session IDs from other web applications. Since session cookie names

\* are configurable, as are session ID lengths, this filter is not expected to

\* be 100% effective.

\* It is required that the examples web application is removed in security

\* conscious environments as documented in the Security How-To. This filter is

\* intended to reduce the impact of failing to follow that advice. A failure by

\* this filter to obfuscate a session ID or similar value is not a security

\* vulnerability. In such instances the vulnerability is the failure to remove

\* the examples web application.

\*/

publicclass CookieFilter \{

privatestatic final String OBFUSCATED = "\[obfuscated\]";

private CookieFilter() \{

// Hide default constructor

publicstatic String filter(String cookieHeader, String sessionId) \{

StringBuilder sb = new StringBuilder(cookieHeader.length());

// Cookie name value pairs are ';' separated.

// Session IDs don't use ; in the value so don't worry about quoted

// values that contain ;

StringTokenizer st = new StringTokenizer(cookieHeader, ";");

boolean first = true;

while (st.hasMoreTokens()) \{

if (first) \{

first = false;

\} else \{

sb.append(';');

sb.append(filterNameValuePair(st.nextToken(), sessionId));

return sb.toString();

privatestatic String filterNameValuePair(String input, String sessionId) \{

int i = input.indexOf('=');

if (i == -1) \{

return input;

String name = input.substring(0, i);

String value = input.substring(i + 1, input.length());

return name + "=" \+ filter(name, value, sessionId);

publicstatic String filter(String cookieName, String cookieValue, String sessionId) \{

if (cookieName.toLowerCase(Locale.ENGLISH).contains("jsessionid") &&

(sessionId == null || !cookieValue.contains(sessionId))) \{

cookieValue = OBFUSCATED;

return cookieValue;

错误终于全部解决了，找到程序入口类Bootstrap，右键=>Run As=>Java Application启动tomcat。打开浏览器访问http://localhost:8080

![20171231112559920][]

我们看到了久违的界面，OK，完全没有问题，接下来就开始欣赏大师们写的代码吧，在main方法中打个断点，逐步跟踪就可以分析tomcat的启动过程了。

![20171231112600526][]

# 参考博客  #

[http://blog.csdn.net/Rongbo\_J/article/details/50446262][http_blog.csdn.net_Rongbo_J_article_details_50446262]

[http://blog.csdn.net/sun54429552/article/details/69666315][http_blog.csdn.net_sun54429552_article_details_69666315]

[http_tomcat.apache.org_download-70.cgi]: http://tomcat.apache.org/download-70.cgi
[https_github.com_apache_tomcat]: https://github.com/apache/tomcat
[http_blog.csdn.net_xiongyouqiang_article_details_78903975]: http://blog.csdn.net/xiongyouqiang/article/details/78903975
[20171231112554446]: /images/20220602/82cab3c14de045b39dc56a019c7ebd24.png
[20171231112555013]: /images/20220602/70c09db999004ab1a416039941724fc7.png
[20171231112555977]: /images/20220602/c89274242fe941d78655ee62ba32b76f.png
[20171231112556846]: /images/20220602/a2977e6cd70a49978a8e70b8ea5c5dfd.png
[20171231112557437]: /images/20220602/fff0de8c28354f67bb5268414e5c84e9.png
[20171231112559192]: /images/20220602/fa648c2441c34df9a80050ec81efe7f5.png
[20171231112559920]: /images/20220602/5b05626439a74beb8b58313f3006d712.png
[20171231112600526]: /images/20220602/689c0eb9f6584099aa97b0eb4993b690.png
[http_blog.csdn.net_Rongbo_J_article_details_50446262]: http://blog.csdn.net/Rongbo_J/article/details/50446262
[http_blog.csdn.net_sun54429552_article_details_69666315]: http://blog.csdn.net/sun54429552/article/details/69666315