하이퍼레이인: 루스트 웹 프레임워크를 통한 성능 향상과 개발 경험

프로그래밍/소프트웨어 개발

웹 개발

대상자

• 웹 개발자, 특히 루스트 언어를 사용하는 개발자
• 중간 수준의 루스트 프로그래밍 이해가 필요
• Rust 웹 프레임워크의 성능과 사용법에 관심 있는 개발자

핵심 요약

• Hyperlane은 Rust로 작성된 고성능, 가볍고 개발자 친화적인 웹 프레임워크
• wrk 테스트 기준, 하이퍼레이인의 QPS(요청 처리량)은 120,000+으로 actix-web, axum보다 우수
• Context 추상화를 통해 코드 가독성과 편의성을 높임
• send()와 send_once() 메서드는 연결 유지 여부에 따라 다른 동작을 수행

섹션별 세부 요약

1. 하이퍼레이인 소개

• Hyperlane은 Rust의 안전성과 동시성을 활용한 고성능 웹 프레임워크
• zero platform dependency를 통해 플랫폼에 따른 의존성을 최소화
• 모던한 개발 경험 제공을 목표로 설계됨

2. 성능 테스트 결과

• wrk 테스트 (단일 코어): Hyperlane(QPS 120,000+) > actix-web(QPS 90,000+) > axum(QPS 80,000+)
• ab 테스트 (10,000 요청, 100 병렬성): Hyperlane(QPS 110,000+) > actix-web(QPS 85,000+) > axum(QPS 75,000+)
• 성능 테스트 결과는 고성능 서버 개발에 적합한 프레임워크임을 강조

3. `Context` 추상화 활용

• 기존 프레임워크에서 ctx.get_request().await.get_method()처럼 중첩된 메서드 호출이 필요했음
• 하이퍼레이인은 ctx.get_request_method().await처럼 간결하게 처리 가능
• getter/setter 자동 생성을 통해 코드 가독성 향상

4. RESTful API 구현 시 편의성

• 메서드 매크로를 통해 GET, POST, DELETE 요청을 간단하게 처리 가능
• 예시:

```rust

async fn user_api(ctx: Context) {

// GET/POST 요청 처리 로직

}

async fn delete_user(ctx: Context) {

// DELETE 요청 처리 로직

}

```

5. `async` 키워드 사용 유의

• async 키워드를 누락하면 컴파일러 오류 발생
• Rust의 비동기 프로그래밍 모델은 세심한 주의가 필요

6. 응답 처리 API 비교

• send(): 연결 유지, 응답 전송
• send_once(): 연결 즉시 종료
• 응답 처리 방식 선택 시 TCP 연결 유지 여부를 고려해야 함

7. 미들웨어 워크플로우

• "onion model" 구조로 요청/응답 흐름 관리
• 요청: Middleware 1 (외부) → Middleware 2 (내부) → Controller → 응답 흐름 반복
• 미들웨어는 요청 전후 모두에 적용 가능

8. 로깅 미들웨어 구현 예시

• log_middleware 미들웨어 구현 예시:

```rust

async fn log_middleware(ctx: Context, next: Next) {

let start_time = Instant::now();

println!("Request started at: {:?}", start_time);

next.await;

let duration = start_time.elapsed();

println!("Request duration: {:?}", duration);

}

```

• 요청 시간 측정 및 로깅을 통해 성능 분석 및 디버깅에 활용 가능

결론

• Hyperlane은 Rust 웹 프레임워크에서 고성능, 간결한 API, 강력한 미들웨어 지원을 제공
• async 키워드 사용, send()/send_once() 선택, 미들웨어 구조 이해가 실무 적용에 핵심
• Rust 개발자에게 추천되는 고성능 웹 프레임워크로, 학습 및 프로젝트 개발에 적합