데이터 모델을 위한 재사용 가능한 패턴
실제 모델에 제네릭 패턴을 적용합니다. Paginated , Result , Pick/Omit/Partial을 사용한 DTO, id를 키로 하는 맵을 다룹니다.
데이터 모델을 위한 재사용 가능한 패턴은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 3개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
소개
목표: 일반적인 데이터 형태를 제네릭 타입으로 묶어 타입 안전성을 잃지 않고 구조를 재사용합니다.
- Paginated<T>
- Result<T,E>
- Pick/Omit/Partial을 사용한 DTO
- id를 키로 사용하는 맵
Paginated<T>
Paginated<T>는 메타데이터를 한곳에서 관리하면서 목록의 항목 타입 T를 정확하게 유지합니다.
type Paginated<T> = {
items: T[];
total: number;
page: number;
pageSize: number;
};
type User = { id: number; name: string };
const page1: Paginated<User> = {
items: [{ id: 1, name: "Ada" }],
total: 10,
page: 1,
pageSize: 5,
};
console.log(page1.items[0].name);Result<T,E>
Result<T,E>는 판별자(ok)를 사용해 성공과 실패를 명시적으로 모델링하므로 안전하게 분기할 수 있습니다.
type Ok<T> = { ok: true; data: T };
type Err<E = string> = { ok: false; error: E };
type Result<T, E = string> = Ok<T> | Err<E>;
function readUser(id: number): Result<{ id: number; name: string }> {
return id > 0 ? { ok: true, data: { id, name: "Ada" } } : { ok: false, error: "not found" };
}
const r = readUser(1);
if (r.ok) {
console.log(r.data.name);
} else {
console.error(r.error);
}DTO 패턴
Pick/Omit/Partial을 사용하면 핵심 모델에서 간결한 DTO 타입을 도출할 수 있어 중복이 발생하지 않습니다.
type User = { id: number; name: string; email?: string; role: "user" | "admin" };
type UserCreateDto = Pick<User, "name" | "email">; // fields required to create
// Update = partial editable fields
type UserUpdateDto = Partial<Pick<User, "name" | "email">>;
const createBody: UserCreateDto = { name: "Ada", email: "a@x.io" };
const updateBody: UserUpdateDto = { name: "Ada L." };MapById<T>
MapById<T>는 빠르게 조회할 수 있도록 엔터티를 id별로 색인합니다. id가 존재하도록 T에 제약을 둡니다.
type Key = string | number;
type MapById<T extends { id: Key }> = Record<Key, T>;
const byId: MapById<{ id: number; name: string }> = {
1: { id: 1, name: "Ada" },
2: { id: 2, name: "Lin" },
};
console.log(byId[1].name);팁
팁:
- 패턴은 작고 조합 가능하게 유지합니다.
- 상태 머신에는 판별 유니언을 우선합니다.
- 모델에서 DTO를 도출하고 수동 복사는 피합니다.
Paginated<T> 확인
빠른 확인: 제네릭 Paginated<T>를 정의하는 이유는 무엇입니까?
요약
요약: 반복되는 형태를 일반화합니다. Paginated<T>, Result<T,E>, Pick/Omit/Partial을 사용한 DTO, id로 색인된 맵을 활용합니다. 작은 도우미 타입은 여러 기능에서 확장해 사용할 수 있습니다.
자주 묻는 질문
“데이터 모델을 위한 재사용 가능한 패턴” 강의는 무료인가요?
네 — “데이터 모델을 위한 재사용 가능한 패턴” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
“데이터 모델을 위한 재사용 가능한 패턴”에서 뭘 배우나요?
실제 모델에 제네릭 패턴을 적용합니다. Paginated , Result , Pick/Omit/Partial을 사용한 DTO, id를 키로 하는 맵을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 3번째 강의입니다.
“데이터 모델을 위한 재사용 가능한 패턴” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 제네릭 인터페이스와 타입 별칭
- 조건부 타입(입문)과 유니온에 대한 분배
- 데이터 모델을 위한 재사용 가능한 패턴