Интеграция NestJS с TypeORM для работы с базами данных

Введение

Современные веб-приложения требуют гибкой и надёжной работы с базами данных. Одним из ведущих фреймворков для разработки серверных приложений на TypeScript является NestJS. Его популярность связана с модульной архитектурой, масштабируемостью и поддержкой различных ORM. В этой статье поговорим о том, как интегрировать NestJS с TypeORM — одним из самых популярных решений для работы с реляционными базами данных в Node.js.

Преимущества связки NestJS и TypeORM

• Модульная архитектура: NestJS отлично структурирует код, а TypeORM легко интегрируется через отдельные модули.
• Типизация и безопасность: TypeScript-среда позволяет снизить количество ошибок за счёт строгой типизации.
• Поддержка множества СУБД: TypeORM работает с PostgreSQL, MySQL, MariaDB, SQLite и другими.
• Миграции, сиды, репозитории: TypeORM предоставляет полный инструментарий для управления схемой данных и логикой доступа.

Установка и настройка

1. Установка зависимостей:
   

   npm install --save @nestjs/typeorm typeorm pg

   В данном примере используем PostgreSQL, но вы можете выбрать свой драйвер.
2. Настройка модуля TypeORM:
   В app.module.ts подключите модуль TypeORM следующим образом:
   

   import { Module } from '@nestjs/common';
   import { TypeOrmModule } from '@nestjs/typeorm';
   
   @Module({
     imports: [
       TypeOrmModule.forRoot({
         type: 'postgres',
         host: 'localhost',
         port: 5432,
         username: 'user',
         password: 'password',
         database: 'testdb',
         autoLoadEntities: true,
         synchronize: true,
       }),
     ],
   })
   export class AppModule {}

   Эти параметры можно вынести в .env файл для повышения безопасности и гибкости.

Создание сущностей (Entities) и репозиториев

TypeORM использует сущности для описания таблиц. Пример сущности:

import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';

@Entity()
export class User {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;

  @Column()
  email: string;
}

Для работы с сущностью создайте сервис и контроллер, применив возможности dependency injection NestJS:

import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { User } from './user.entity';

@Injectable()
export class UserService {
  constructor(
    @InjectRepository(User)
    private userRepository: Repository,
  ) {}

  findAll(): Promise {
    return this.userRepository.find();
  }
}

Миграции и управление схемой

Одна из самых полезных функций TypeORM — поддержка миграций. Миграции позволяют контролировать изменения структуры БД во времени, что критично для проектов с несколькими разработчиками и сложными процессами развертывания.

1. Создайте миграцию:
   

   npx typeorm migration:create -n CreateUserTable

2. Опишите изменения в миграционном файле и примените их:
   

   npx typeorm migration:run

Работа с различными базами данных

TypeORM поддерживает работу с разными СУБД, такими как MySQL, PostgreSQL, SQLite, MSSQL и даже MongoDB. Это делает интеграцию с NestJS универсальной: достаточно изменить параметры подключения в конфиге, и ваше приложение будет работать с нужной БД.

Поддержка асинхронной конфигурации

В реальных приложениях часто требуется динамическая конфигурация, например, в зависимости от переменных окружения. NestJS позволяет использовать асинхронную инициализацию TypeORM:

TypeOrmModule.forRootAsync({
  useFactory: async () => ({
    type: 'postgres',
    host: process.env.DB_HOST,
    port: +process.env.DB_PORT,
    username: process.env.DB_USER,
    password: process.env.DB_PASS,
    database: process.env.DB_NAME,
    autoLoadEntities: true,
    synchronize: false,
  }),
})

Расширенные возможности

• QueryBuilder: Позволяет строить сложные SQL-запросы на TypeScript.
• Поддержка связей: TypeORM поддерживает отношения один-к-одному, один-ко-многим, многие-ко-многим.
• События и слушатели: Можно реагировать на изменения данных с помощью специальных хуков.
• Валидация и кастомные репозитории: Повышает качество и предсказуемость бизнес-логики.

Безопасность и производительность

Используя TypeORM с NestJS, легко реализовать авторизацию, проверку прав доступа, оптимизировать запросы и масштабировать приложение за счёт кэширования и распределения нагрузки.

Вывод

Интеграция NestJS с TypeORM — современное и надёжное решение для работы с реляционными базами данных в приложениях на Node.js. Такой подход обеспечивает масштабируемость, безопасность, гибкость и удобство сопровождения проекта.

Если вам нужна помощь с внедрением или доработкой интеграции NestJS и TypeORM, обратитесь к нашим специалистам — мы поможем реализовать проект любой сложности!
Подробнее о нашей услуге