미들웨어
Tower 레이어
미들웨어은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
미들웨어란 무엇인가요?
미들웨어는 핸들러 전후에 코드를 실행하여 요청/응답 주기를 감쌉니다. 로깅, 인증, 압축, 시간 제한에 사용합니다.
- Axum은
tower생태계를 기반으로 구축됩니다 - 미들웨어는 레이어로 추가됩니다
Service 트레이트
Tower는 Service를 정의합니다. Service는 요청을 받아 비동기적으로 응답을 생성하는 것입니다. 레이어는 하나의 서비스를 다른 서비스로 감쌉니다.
레이어 추가하기
.layer()를 사용하여 미들웨어를 연결합니다. 여기서는 tower_http에서 요청 추적 기능을 추가합니다.
use axum::{Router, routing::get};
use tower_http::trace::TraceLayer;
fn app() -> Router {
Router::new()
.route("/", get(|| async { "ok" }))
.layer(TraceLayer::new_for_http())
}레이어 순서
레이어는 아래에서 위로 감쌉니다. 마지막에 추가된 레이어가 가장 바깥쪽에 놓입니다. 요청은 바깥쪽에서 안쪽으로 흐르고, 응답은 안쪽에서 바깥쪽으로 흐릅니다.
use axum::{Router, routing::get};
use tower_http::{trace::TraceLayer, compression::CompressionLayer};
fn app() -> Router {
Router::new()
.route("/", get(|| async { "ok" }))
.layer(CompressionLayer::new())
.layer(TraceLayer::new_for_http())
}from_fn을 사용한 사용자 지정 미들웨어
middleware::from_fn은 비동기 함수를 미들웨어로 변환합니다. 이 함수는 요청과 체인의 나머지 부분을 호출할 Next를 받습니다.
use axum::{middleware::Next, response::Response, extract::Request};
async fn log_mw(req: Request, next: Next) -> Response {
println!("{} {}", req.method(), req.uri());
next.run(req).await
}사용자 지정 미들웨어 연결하기
함수를 from_fn으로 감싼 다음 레이어로 추가합니다.
use axum::{Router, routing::get, middleware};
fn app() -> Router {
Router::new()
.route("/", get(|| async { "ok" }))
.layer(middleware::from_fn(log_mw))
}요청 조기 종료하기
미들웨어는 next를 호출하지 않고 일찍 반환할 수 있으며, 인증에 유용합니다. 응답을 반환하면 체인이 중단됩니다.
use axum::{middleware::Next, response::Response, extract::Request, http::StatusCode};
async fn auth(req: Request, next: Next) -> Result<Response, StatusCode> {
if req.headers().contains_key("authorization") {
Ok(next.run(req).await)
} else {
Err(StatusCode::UNAUTHORIZED)
}
}미들웨어 체인 모델링하기
체인은 각 함수가 다음 함수를 호출하는 구조일 뿐입니다. 이 실행 가능한 예제는 전후 처리를 감싸는 방식을 모델링합니다.
fn handler() -> String {
"response".to_string()
}
fn logging<F: Fn() -> String>(next: F) -> String {
println!("-> request in");
let res = next();
println!("<- response out");
res
}
fn main() {
let out = logging(handler);
println!("body: {}", out);
}경로별 미들웨어
전체 앱이 아니라 메서드 라우터에서 .layer()를 호출하면 하나의 경로에만 레이어를 적용할 수 있습니다.
use axum::{Router, routing::get, middleware};
fn app() -> Router {
Router::new().route(
"/admin",
get(|| async { "admin" }).layer(middleware::from_fn(auth)),
)
}자주 사용하는 tower_http 레이어
tower_http 크레이트는 바로 사용할 수 있는 미들웨어를 제공합니다:
- 로깅을 위한
TraceLayer - gzip을 위한
CompressionLayer - CORS를 위한
CorsLayer - 요청 시간을 제한하는
TimeoutLayer
use tower_http::cors::CorsLayer;
fn cors() -> CorsLayer {
CorsLayer::permissive()
}ServiceBuilder로 레이어 쌓기
ServiceBuilder를 사용하면 여러 레이어를 깔끔하게 그룹화할 수 있습니다. 레이어를 위에서 아래 순서로 적용하므로 순서를 예측할 수 있습니다.
use tower::ServiceBuilder;
use tower_http::{trace::TraceLayer, compression::CompressionLayer};
fn stack() -> ServiceBuilder<impl Sized> {
ServiceBuilder::new()
.layer(TraceLayer::new_for_http())
.layer(CompressionLayer::new())
}빠른 확인
미들웨어에 대한 이해도를 확인해 보세요.
복습
tower 레이어를 사용한 미들웨어를 배웠습니다:
.layer()로 미들웨어를 추가하며, 마지막에 추가된 레이어가 가장 바깥쪽에 놓입니다from_fn은Next를 사용하여 사용자 지정 미들웨어를 만듭니다- 일찍 반환하여 체인을 중단할 수 있으며, 인증 등에 사용할 수 있습니다
tower_http는 추적, 압축, CORS, 시간 제한 레이어를 제공합니다
이로써 Axum 과정이 끝났습니다.
자주 묻는 질문
“미들웨어” 강의는 무료인가요?
네 — “미들웨어” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“미들웨어”에서 뭘 배우나요?
Tower 레이어 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“미들웨어” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.