서버 액션이란?
Coddy React 여정의 Next.js 핵심 (Next.js Essentials) 섹션에 포함된 레슨. 47개 중 29번째.
이제 서버의 데이터를 읽을 수 있습니다. 이제 나머지 절반인 데이터를 변경할 차례입니다.
얼마 전까지만 해도 텍스트 한 줄을 저장하려면 놀라울 만큼 번거로운 절차가 필요했습니다. 엔드포인트를 작성했죠:
// app/api/items/route.js
export async function POST(request) {
const body = await request.json();
saveItem(body.text);
return Response.json({ ok: true });
}…그런 다음 브라우저에서 호출했습니다:
await fetch('/api/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text }),
});폼에서 데이터베이스로 하나의 문자열을 전달하기 위해 두 개의 파일, URL, 메서드, 헤더, 그리고 양방향 JSON을 사용합니다.
Server Action은 모든 항목을 삭제합니다. 첫 번째 줄이 'use server'인 파일에 비동기 함수를 작성하세요:
// app/actions.js
'use server';
import { saveItem } from '../lib/db';
export async function addItem(formData) {
saveItem(formData.get('text'));
}…그리고 그 함수를 양식에 전달합니다:
<form action={addItem}>
<input name="text" />
<button type="submit">Add</button>
</form>이게 전부예요. 짚고 넘어갈 만한 세 가지 세부 사항이 있어요:
'use server'는 파일의 첫 번째 줄이어야 해요: 반대 방향을 가리키는'use client'와 같은 종류의 표식이에요. 여기서 내보내는 모든 항목이 서버에서 실행된다는 뜻이에요.- 함수 본문은 브라우저에 전달되지 않아요. 데이터베이스 자격 증명은 함수 안에 안전하게 보관돼요. 브라우저에는 호출할 수 있는 참조만 전달돼요.
- URL을 직접 작성하지 않았어요. Next.js가 엔드포인트를 만들어 줘요.
action={addItem}이 연결을 설정해요.
Fundamentals와의 한 가지 차이점은 이 양식 입력란이 비제어라는 점입니다. useState도, value도, onChange도 없습니다. 브라우저가 텍스트를 보관하며, 제출할 때 액션이 텍스트를 찾는 방법은 name 속성입니다.
직접 해보기
이 레슨에는 코드 챌린지가 없습니다.
이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.