# mini-tomcat

**Repository Path**: jsoulmate/mini-tomcat

## Basic Information

- **Project Name**: mini-tomcat
- **Description**: 迷你tomcat
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-27
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mini-tomcat

一个简易版的Tomcat实现，用于学习和理解Tomcat的核心功能和原理。

## 项目简介

`mini-tomcat` 是一个简化版的Tomcat服务器实现，旨在帮助开发者理解Tomcat的基本工作原理，包括请求处理、Servlet管理和HTTP通信等核心概念。该项目适合用于学习和教学目的。

## 功能特性

- 支持基本的HTTP请求处理（GET, POST, PUT, DELETE）
- 实现了简单的Servlet映射机制
- 提供了注解驱动的URL映射方式
- 包含了请求和响应的基本处理类

## 核心组件

- **TomcatMain**: 主类，负责启动服务器并处理客户端连接
- **AbstractServlet**: 抽象Servlet类，定义了处理HTTP方法的接口
- **RequestUrl**: 注解，用于指定Servlet的URL映射
- **MyRequest & MyResponse**: 请求和响应的封装类
- **SmileServlet**: 示例Servlet实现
- **ServletMapping & ServletMappingConfig**: Servlet映射配置类
- **FindFileHaveAnnotation**: 工具类，用于扫描带有注解的类

## 使用方法

1. 克隆项目到本地
2. 使用Maven构建项目
3. 运行 `TomcatMain` 类启动服务器
4. 通过浏览器或HTTP客户端访问 `http://localhost:8080/smile` 测试示例Servlet

## 示例代码

```java
@RequestUrl("/smile")
public class SmileServlet extends AbstractServlet {
    @Override
    public void doGet(MyRequest myRequest, MyResponse myResponse) throws IOException {
        myResponse.write("Hello, this is the SmileServlet GET response!");
    }

    @Override
    public void doPost(MyRequest myRequest, MyResponse myResponse) throws IOException {
        myResponse.write("Hello, this is the SmileServlet POST response!");
    }
}
```

## 学习资源

- [Tomcat官方文档](https://tomcat.apache.org/)
- [Servlet规范文档](https://jakarta.ee/specifications/servlet/)
- [HTTP协议详解](https://developer.mozilla.org/zh-CN/docs/Web/HTTP)

## 贡献指南

欢迎贡献代码和文档，以帮助完善这个项目。请遵循以下步骤：
1. Fork项目
2. 创建新分支
3. 提交代码更改
4. 创建Pull Request

## 许可证

本项目采用MIT许可证。详情请参阅 [LICENSE](LICENSE) 文件。