Nestjs

Fundamentals (기초)

Techniques (기법)

Security (보안)

GraphQL

WebSockets

Microservices

OpenAPI (Swagger)

CLI

Recipes (레시피)

FAQ

기타

핵심 패턴 요약

요청 처리 순서

Middleware → Guards → Interceptors (pre) → Pipes → Controller → Interceptors (post) → Exception Filter

모듈 구조

@Module({
  imports: [OtherModule],
  controllers: [UserController],
  providers: [UserService],
  exports: [UserService],
})
export class UserModule {}

컨트롤러

@Controller('users')
export class UserController {
  constructor(private readonly userService: UserService) {}

  @Get()
  findAll() { return this.userService.findAll(); }

  @Get(':id')
  findOne(@Param('id', ParseIntPipe) id: number) { return this.userService.findOne(id); }

  @Post()
  create(@Body() dto: CreateUserDto) { return this.userService.create(dto); }
}

서비스

@Injectable()
export class UserService {
  constructor(@InjectRepository(User) private repo: Repository<User>) {}

  findAll() { return this.repo.find(); }
}

유효성 검사

// DTO
export class CreateUserDto {
  @IsString() @MinLength(2) name: string;
  @IsEmail() email: string;
}

// main.ts
app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));

가드

@Injectable()
export class AuthGuard implements CanActivate {
  canActivate(context: ExecutionContext): boolean {
    const request = context.switchToHttp().getRequest();
    return this.validate(request);
  }
}

CLI 명령어

nest new project-name       # 새 프로젝트
nest g resource users       # CRUD 리소스
nest g module users         # 모듈
nest g controller users     # 컨트롤러
nest g service users        # 서비스
nest g guard auth           # 가드
nest g pipe validation      # 파이프

사용법

상세 내용이 필요하면 docs/ 폴더의 해당 파일을 직접 열어 읽으세요.

예시:

• Controllers 상세: docs/controllers.md
• TypeORM 설정: docs/recipes/sql-typeorm.md
• 인증 구현: docs/security/authentication.md