JSON과 상태
공유 상태와 직렬화
JSON과 상태은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
JSON 반환하기
Axum에서는 JSON 응답을 쉽게 만들 수 있습니다. 직렬화할 수 있는 모든 Serialize 형식을 Json으로 감싸면 콘텐츠 형식을 설정하고 본문을 직렬화합니다.
use axum::Json;
use serde::Serialize;
#[derive(Serialize)]
struct User { id: u32, name: String }
async fn get_user() -> Json<User> {
Json(User { id: 1, name: "Alice".into() })
}컬렉션 직렬화하기
직렬화할 수 있는 항목의 Vec은 JSON 배열이 됩니다. 추가 작업은 필요하지 않습니다.
use axum::Json;
use serde::Serialize;
#[derive(Serialize)]
struct Item { id: u32 }
async fn list() -> Json<Vec<Item>> {
Json(vec![Item { id: 1 }, Item { id: 2 }])
}일반 Rust로 JSON 모델링하기
JSON 직렬화는 구조체를 문자열로 변환하는 작업일 뿐입니다. serde_json에서는 to_string을 호출합니다. 여기서는 수동 형식을 사용해 그 개념을 나타냅니다.
struct User { id: u32, name: String }
fn to_json(u: &User) -> String {
format!("{{\"id\":{},\"name\":\"{}\"}}", u.id, u.name)
}
fn main() {
let u = User { id: 1, name: "Alice".to_string() };
println!("{}", to_json(&u));
}공유 상태란 무엇인가요?
공유 상태는 데이터베이스 풀이나 설정처럼 모든 처리기가 접근할 수 있는 데이터입니다. Axum은 State 추출기로 이 상태를 전달합니다.
앱 상태 정의하기
공유 데이터를 담는 구조체를 정의하세요. 복제 비용을 낮추기 위해 Arc으로 감싸는 경우가 많습니다.
use std::sync::Arc;
#[derive(Clone)]
struct AppState {
name: Arc<String>,
}라우터에 상태 연결하기
상태를 with_state에 전달하세요. Axum이 상태를 저장하고 이를 요청하는 처리기에 제공합니다.
use axum::{Router, routing::get};
async fn handler() -> &'static str { "ok" }
fn app(state: AppState) -> Router {
Router::new().route("/", get(handler)).with_state(state)
}처리기에서 상태 읽기
State 매개변수를 추가하면 처리기 내부에서 상태의 복제본을 받을 수 있습니다.
use axum::extract::State;
async fn handler(State(state): State<AppState>) -> String {
state.name.to_string()
}변경 가능한 공유 상태
변경되는 데이터라면 Arc 안의 Mutex와 같은 잠금으로 보호하세요. 이렇게 하면 동시에 안전하게 변경할 수 있습니다.
use std::sync::{Arc, Mutex};
#[derive(Clone)]
struct Counter {
count: Arc<Mutex<u32>>,
}Mutex 뒤의 값 변경하기
뮤텍스를 잠그고 값을 변경하면 가드가 해제됩니다. 다음 실행 가능한 예는 처리기가 수행할 증가 작업을 그대로 보여 줍니다.
use std::sync::{Arc, Mutex};
fn main() {
let count = Arc::new(Mutex::new(0u32));
{
let mut guard = count.lock().unwrap();
*guard += 1;
}
println!("count = {}", *count.lock().unwrap());
}JSON 수신 및 반환하기
입력 JSON과 출력 JSON을 결합하세요. 본문을 역직렬화하고 변환한 다음 JSON으로 반환합니다. 생성한 뒤 응답하는 일반적인 패턴입니다.
use axum::Json;
use serde::{Serialize, Deserialize};
#[derive(Deserialize)]
struct Input { name: String }
#[derive(Serialize)]
struct Output { greeting: String }
async fn greet(Json(i): Json<Input>) -> Json<Output> {
Json(Output { greeting: format!("Hi {}", i.name) })
}FromRef로 하위 상태 사용하기
상태에 여러 데이터가 들어 있을 때 FromRef를 파생하면 처리기가 필요한 부분만 추출할 수 있습니다.
use axum::extract::FromRef;
#[derive(Clone)]
struct Pool;
#[derive(Clone, FromRef)]
struct AppState {
pool: Pool,
}빠른 확인
JSON과 상태에 대한 이해도를 확인해 보세요.
복습
JSON과 공유 상태를 배웠습니다.
Serialize형식을Json으로 감싸 응답합니다Clone상태 구조체를 정의하며, 대개Arc으로 감쌉니다with_state로 연결하고State로 읽습니다- 변경 가능한 공유 데이터에는
Arc<Mutex>를, 하위 상태에는FromRef를 사용합니다
다음으로 tower 계층을 사용한 미들웨어를 알아봅니다.
자주 묻는 질문
“JSON과 상태” 강의는 무료인가요?
네 — “JSON과 상태” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“JSON과 상태”에서 뭘 배우나요?
공유 상태와 직렬화 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“JSON과 상태” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.