rust 50 lines · 7 steps

Building a typed create_user handler in Axum

An Axum POST handler that deserializes JSON, validates, inserts via sqlx, and returns a typed 201 response.

Explained by highlit
Axum Intermediate serde extractors sqlx error-handling json-api
1use axum::{extract::State, http::StatusCode, response::IntoResponse, Json};
2use serde::{Deserialize, Serialize};
3use uuid::Uuid;
4 
5#[derive(Debug, Deserialize)]
6pub struct CreateUser {
7 name: String,
8 email: String,
9 #[serde(default)]
10 role: Role,
11}
12 
13#[derive(Debug, Default, Deserialize, Serialize)]
14#[serde(rename_all = "lowercase")]
15pub enum Role {
16 #[default]
17 Member,
18 Admin,
19}
20 
21#[derive(Debug, Serialize)]
22pub struct UserResponse {
23 id: Uuid,
24 name: String,
25 email: String,
26 role: Role,
27}
28 
29pub async fn create_user(
30 State(pool): State<PgPool>,
31 Json(payload): Json<CreateUser>,
32) -> Result<impl IntoResponse, ApiError> {
33 if payload.email.trim().is_empty() {
34 return Err(ApiError::UnprocessableEntity("email is required".into()));
35 }
36 
37 let user = sqlx::query_as!(
38 UserResponse,
39 r#"INSERT INTO users (name, email, role)
40 VALUES ($1, $2, $3)
41 RETURNING id, name, email, role AS "role: Role""#,
42 payload.name,
43 payload.email,
44 payload.role as Role,
45 )
46 .fetch_one(&pool)
47 .await?;
48 
49 Ok((StatusCode::CREATED, Json(user)))
50}
01 / 01
STEP 01

Walkthrough

Space play ←→ step click any line
Three takeaways
  1. 1Deriving Deserialize and Serialize lets serde map JSON directly onto strongly-typed structs and enums.
  2. 2Axum extractors like State and Json declare a handler's dependencies and inputs in its signature.
  3. 3sqlx's query_as! checks SQL against the database at compile time and maps rows straight into a struct.

Related explainers

rust 
use std::collections::HashMap;
use std::sync::{Arc, Mutex};
use std::thread;
 

Aggregating metrics across threads in Rust

concurrency shared-state mutex
Intermediate 7 steps
go 
package main
 
import (
	"errors"

Parsing and validating CLI flags in Go

cli-parsing validation error-handling
Intermediate 8 steps
java 
public class ThumbnailProcessor {
 
    private static final int MAX_CONCURRENCY = 4;
 

Bounded parallel thumbnail rendering in Java

concurrency thread-pool futures
Intermediate 7 steps
rust 
use std::sync::{mpsc, Arc, Mutex};
use std::thread;
use std::time::Duration;
 

Building a thread pool in Rust

concurrency channels thread-pool
Advanced 9 steps
rust 
use std::time::Instant;
use tracing::info;
 
pub struct Timer {

A scope-guard timer with Drop in Rust

raii drop-guard timing
Intermediate 7 steps
rust 
use std::collections::HashMap;
 
pub struct Memoizer<K, V, F> {
    cache: HashMap<K, V>,

A generic memoizer in Rust

memoization generics caching
Intermediate 6 steps

Share this explainer

Here's the card — post it anywhere.

Building a typed create_user handler in Axum — share card
Made with highlit — turn any snippet into a walkthrough like this in about a minute.
Explain your code