추출기
요청 구문 분석
추출기은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
추출기란 무엇인가요?
추출기는 요청의 일부를 대신 꺼내 주는 처리기 매개변수입니다. Axum은 매개변수의 형식을 확인하고 값을 채웁니다.
- 요청을 직접 분석할 필요가 없습니다
- 형식 기반이며 조합할 수 있습니다
Path 추출기
Path는 동적인 URL 세그먼트를 캡처합니다. 내부 형식에 따라 세그먼트를 분석하는 방식이 결정됩니다.
use axum::extract::Path;
async fn user(Path(id): Path<u32>) -> String {
format!("user {}", id)
}여러 경로 매개변수
튜플을 추출해 여러 세그먼트를 캡처하세요. 순서는 경로 패턴과 일치합니다.
use axum::extract::Path;
async fn item(Path((cat, id)): Path<(String, u32)>) -> String {
format!("{} / {}", cat, id)
}Query 추출기
Query는 serde를 사용해 URL 쿼리 문자열을 구조체로 역직렬화합니다. 필터와 페이지 매김에 유용합니다.
use axum::extract::Query;
use serde::Deserialize;
#[derive(Deserialize)]
struct Page { page: u32 }
async fn list(Query(p): Query<Page>) -> String {
format!("page {}", p.page)
}JSON 본문 추출기
Json은 요청 본문을 구조체로 역직렬화합니다. 구조체에는 Deserialize를 파생해야 합니다.
use axum::Json;
use serde::Deserialize;
#[derive(Deserialize)]
struct NewUser { name: String }
async fn create(Json(u): Json<NewUser>) -> String {
format!("created {}", u.name)
}헤더 추출기
HeaderMap 추출기 또는 형식이 지정된 헤더 추출기로 헤더에 접근하세요. 인증 토큰을 처리할 때 유용합니다.
use axum::http::HeaderMap;
async fn show(headers: HeaderMap) -> String {
match headers.get("x-api-key") {
Some(v) => format!("key: {:?}", v),
None => "no key".to_string(),
}
}추출기 순서가 중요합니다
Json처럼 본문을 소비하는 추출기는 매개변수 목록의 마지막에 와야 합니다. 본문은 한 번만 읽을 수 있기 때문입니다.
use axum::{Json, extract::Path};
use serde::Deserialize;
#[derive(Deserialize)]
struct Body { value: i32 }
async fn h(Path(id): Path<u32>, Json(b): Json<Body>) -> String {
format!("{} {}", id, b.value)
}일반 Rust로 추출 모델링하기
추출은 요청에서 형식이 지정된 데이터를 분석하는 작업일 뿐입니다. 여기서는 쿼리와 비슷한 문자열을 숫자로 역직렬화합니다.
fn parse_query(q: &str) -> Option<u32> {
q.strip_prefix("page=")?.parse().ok()
}
fn main() {
println!("{:?}", parse_query("page=3"));
println!("{:?}", parse_query("bad"));
}선택적 추출
추출기를 Option으로 감싸 치명적인 오류가 발생하지 않도록 하세요. 값이 없거나 올바르지 않으면 오류 응답 대신 None이 반환됩니다.
use axum::extract::Query;
use serde::Deserialize;
#[derive(Deserialize)]
struct Filter { q: String }
async fn search(filter: Option<Query<Filter>>) -> String {
match filter {
Some(Query(f)) => f.q,
None => "no filter".to_string(),
}
}거부
추출에 실패하면 거부가 반환되고, 이는 HTTP 오류 응답이 됩니다. 예를 들어 잘못된 JSON은 자동으로 422 응답이 됩니다.
use axum::extract::rejection::JsonRejection;
use axum::Json;
async fn create(body: Result<Json<i32>, JsonRejection>) -> String {
match body {
Ok(Json(n)) => format!("ok {}", n),
Err(_) => "bad body".to_string(),
}
}추출기 결합하기
처리기에서 여러 추출기를 동시에 사용할 수 있습니다. Axum은 요청의 각 부분에서 각각의 값을 채웁니다.
use axum::{Json, extract::{Path, Query}};
use serde::Deserialize;
#[derive(Deserialize)]
struct Q { sort: String }
#[derive(Deserialize)]
struct B { name: String }
async fn h(Path(id): Path<u32>, Query(q): Query<Q>, Json(b): Json<B>) -> String {
format!("{} {} {}", id, q.sort, b.name)
}빠른 확인
추출기에 대한 이해도를 확인해 보세요.
복습
추출기로 요청을 분석하는 방법을 배웠습니다.
- URL 세그먼트에는
Path, 쿼리 문자열에는Query를 사용합니다 - 본문에는
Json을 사용하며, 반드시 마지막에 둡니다 - 헤더에는
HeaderMap을 사용합니다 Option과Result로 실패를 안전하게 처리합니다
다음으로 공유 상태와 JSON 응답을 알아봅니다.
자주 묻는 질문
“추출기” 강의는 무료인가요?
네 — “추출기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“추출기”에서 뭘 배우나요?
요청 구문 분석 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“추출기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.