atomic_http 0.9.3

# Atomic HTTP

고성능 HTTP 서버 라이브러리 - Arena 메모리 관리와 Zero-copy 기술을 활용한 최적화된 HTTP 서버

## 🚀 주요 기능

- **Arena 메모리 관리**: 효율적인 메모리 할당과 관리
- **Zero-copy 기술**: 메모리 복사 없는 파일 서빙
- **멀티파트 지원**: 고성능 파일 업로드 처리
- **비동기 처리**: Tokio 기반 비동기 I/O
- **타입 안전성**: Rust의 타입 시스템 활용

## 📦 설치

```toml
[dependencies]
atomic_http = { version = "0.6.0", features = ["arena"] }
```

## 🛠️ 기능별 Features

- `arena`: Arena 메모리 관리 (기본 활성화)
- `response_file`: 파일 응답 지원
- `env`: 환경변수 설정 지원
- `debug`: 디버그 출력 활성화

## 🧪 테스트 실행 가이드

### 📋 새로운 통합 테스트 (추천)

#### 1. 완전 통합 테스트
서버와 클라이언트를 자동으로 시작하고 종합적인 테스트 실행
```bash
# Arena + Zero-copy 모드
cargo run --example integrated_test --features arena

# 표준 모드
cargo run --example integrated_test
```

#### 2. 성능 비교 벤치마크
Arena 서버와 표준 서버의 성능을 직접 비교
```bash
# Arena vs 표준 서버 성능 비교
cargo run --example comparative_benchmark --features arena

# 릴리즈 모드로 정확한 성능 측정
cargo run --release --example comparative_benchmark --features arena
```

#### 3. 멀티파트 테스트
파일 업로드와 멀티파트 폼 데이터 처리 테스트
```bash
# Arena 멀티파트 테스트
cargo run --example integrated_multipart_test --features arena

# 표준 멀티파트 테스트  
cargo run --example integrated_multipart_test
```

### 🔧 간단한 테스트

#### 0. 문제 해결용 디버그 테스트
```bash
# Arena 서버 디버그
cargo run --example debug_test --features arena -- 9999

# 표준 서버 디버그
cargo run --example debug_test -- 9999
```

#### 1. 간단한 벤치마크 테스트 (추천)
```bash
# Arena 간단 벤치마크
cargo run --example simple_benchmark_test --features arena -- 9998

# 표준 간단 벤치마크  
cargo run --example simple_benchmark_test -- 9998
```

#### 2. 기본 서버 테스트
```bash
# Arena 서버
cargo run --example simple_server_test --features arena -- 9080

# 표준 서버
cargo run --example simple_server_test -- 9081
```

#### 2. 간단한 성능 테스트
```bash
# Arena 성능 테스트
cargo run --example simple_performance_test --features arena

# 표준 성능 테스트
cargo run --example simple_performance_test
```

### 📊 벤치마크

Criterion을 사용한 마이크로 벤치마크:
```bash
cargo bench
```

### 🔍 기존 테스트들 (레거시)

필요시 개별 기능 테스트:
```bash
# 기존 서버 테스트
cargo run --example server --features arena

# 부하 테스트 클라이언트 (별도 실행)
cargo run --example load_test_client -- -n 1000 -c 50

# 파일 서빙 테스트
cargo run --example file_serving_test --features arena,response_file

# 제로카피 테스트
cargo run --example zero_copy_test --features arena
```

## 📈 성능 특징

### Arena 서버의 장점
- ✅ **제로카피**: 메모리 복사 없음
- ✅ **낮은 메모리 사용량**: 원본 데이터만 유지  
- ✅ **빠른 파싱**: String 생성 없이 바이트 직접 접근
- ✅ **예측 가능한 성능**: GC 압박 없음
- ✅ **대용량 파일 최적화**: 메모리 효율적

### 표준 서버 특징
- 📝 **안정적이고 검증된 방식**
- 📝 **메모리 복사와 String 할당 포함**
- 📝 **상대적으로 높은 메모리 사용량**

## 💡 사용 예제

### 기본 서버 설정

```rust
use atomic_http::*;
use http::StatusCode;

#[tokio::main]
async fn main() -> Result<(), SendableError> {
    let mut server = Server::new("127.0.0.1:8080").await?;
    
    loop {
        let accept = server.accept().await?;
        
        tokio::spawn(async move {
            let (request, mut response) = accept.parse_request_arena_writer().await?;
            
            // JSON 파싱 (Zero-copy)
            let data: MyData = request.get_json_arena()?;
            
            // 응답 생성 (Arena 할당)
            let result = serde_json::json!({
                "status": "success",
                "data": data
            });
            response.body_mut().set_arena_json(&result)?;
            *response.status_mut() = StatusCode::OK;
            
            response.responser_arena().await?;
            
            Ok::<(), SendableError>(())
        });
    }
}
```

### 멀티파트 파일 업로드

```rust
// Arena 멀티파트 처리
match request.get_multi_part_arena()? {
    Some(form) => {
        // 텍스트 필드 접근
        for i in 0..form.text_fields.len() {
            let name = form.get_text_field_name(i);
            let value = form.get_text_field_value(i);
        }
        
        // 파일 처리
        for part in &form.parts {
            let filename = part.get_file_name();
            let file_data = part.get_body(); // Zero-copy 접근
            
            // 파일 저장
            tokio::fs::write(filename?, file_data).await?;
        }
    }
    None => {
        // JSON 또는 다른 형식 처리
    }
}
```

## 🔧 환경 설정

환경변수를 통한 서버 설정 (env 피쳐 활성화 시):

```bash
export NO_DELAY=true
export READ_TIMEOUT_MILISECONDS=5000
export READ_BUFFER_SIZE=8192
export ROOT_PATH="/var/www"
export ZERO_COPY_THRESHOLD=1048576
export ENABLE_FILE_CACHE=true
```

## 🏗️ 개발 및 기여

### 요구사항
- Rust 1.77 이상
- Tokio 런타임

### 컴파일
```bash
# 기본 빌드
cargo build

# Arena + Zero-copy 모든 기능
cargo build --features arena,response_file,env

# 릴리즈 빌드  
cargo build --release --features arena
```

### 테스트 
```bash
# 단위 테스트
cargo test

# 통합 테스트
cargo run --example integrated_test --features arena

# 성능 벤치마크
cargo bench
```

## 📄 라이선스

Apache License 2.0

## 🤝 기여

이슈와 풀 리퀘스트를 환영합니다. 주요 변경사항은 먼저 이슈를 열어 논의해 주세요.

## 📞 지원

- GitHub Issues: [프로젝트 이슈](https://github.com/rabbitson87/atomic_http/issues)
- 문서: [docs.rs](https://docs.rs/atomic_http)

---

**추천 테스트 순서:**

1. `cargo run --example debug_test --features arena` - 기본 동작 확인
2. `cargo run --example simple_benchmark_test --features arena` - 간단한 벤치마크
3. `cargo run --example integrated_test --features arena` - 전체 기능 확인
4. `cargo run --example comparative_benchmark --features arena` - 성능 비교
5. `cargo bench` - 마이크로 벤치마크

각 테스트는 서버와 클라이언트를 자동으로 관리하므로 별도 설정이 필요하지 않습니다.

## 🚨 문제 해결

### 벤치마크 실패 문제
만약 `comparative_benchmark`에서 요청이 실패한다면:

1. **기본 테스트부터 실행**:
   ```bash
   cargo run --example debug_test --features arena
   ```

2. **간단한 벤치마크 실행**:
   ```bash
   cargo run --example simple_benchmark_test --features arena
   ```

3. **포트 충돌 확인**:
   ```bash
   # 다른 포트 사용
   cargo run --example simple_benchmark_test --features arena -- 8888
   ```

### 일반적인 문제들
- **컴파일 오류**: `cargo clean && cargo build --features arena`
- **연결 실패**: 방화벽이나 포트 사용 중인지 확인
- **성능 측정**: `--release` 모드로 실행

### 로그 확인
각 테스트는 상세한 로그를 출력하므로 실패 지점을 쉽게 파악할 수 있습니다.