Чистая архитектура в Node.js
2 года назад·10 мин. на чтение
Чистая архитектура (Clean Architecture) — это концепция разработки программного обеспечения, которая фокусируется на создании модульного и поддерживаемого кода. Архитектура позволяет разработчику создавать кодовую базу, которую легко понять, протестировать и расширить.
Основное внимание в чистой архитектуре уделяется отделению основной бизнес-логики приложения от деталей инфраструктуры. В этой статье мы обсудим чистую архитектуру в Node.js и рассмотрим, как реализовать ее в проектах Node.js примерами кода и как применять к ним концепции.
Вот как мы можем применить разделение ответственности к этому коду:
Вот как мы можем применить инверсию зависимостей к этому коду:
Чтобы следовать принципу SRP, мы можем разделить эти обязанности на отдельные классы:
Выявление и решение проблем
При разработке приложений Node.js мы часто сталкиваемся с некоторыми проблемами, такими как дублирование кода, неорганизованная кодовая база и тесная связь (tight coupling). В следующем разделе мы используем простой пример приложения Node.js, которое извлекает данные из базы данных и возвращает их в качестве ответа JSON. Чистая архитектура предлагает решения этих проблем, делая упор на следующие принципы:Разделение ответственности (Separation of Concerns, SoC)
Фундаментальный принцип разработки программного обеспечения, который подчеркивает важность разделения системы на отдельные модули или компоненты, каждый из которых несет определенную и независимую ответственность. В Node.js SoC часто реализуется с использованием модульной архитектуры, где каждый модуль отвечает за одну задачу или функциональность. Вот пример того, как разделение ответственности может быть применено к этому коду:В этом коде мы смешали задачи маршрутизации, извлечения данных и обработки ошибок в одном файле. Это может затруднить обслуживание и масштабирование кода по мере роста приложения.// index.js - Плохой код! const express = require('express') const app = express() const database = require('./database') app.get('/users', async (req, res) => { try { const users = await database.getUsers() res.json(users) } catch (error) { res.status(500).send('Internal Server Error') } }) app.listen(3000, () => { console.log('Server is listening on port 3000') })
// index.js const express = require('express') const app = express() const usersRouter = require('./routes/users') app.use('/users', usersRouter) app.listen(3000, () => { console.log('Server is listening on port 3000') })
// routes/users.js const express = require('express') const router = express.Router() const usersController = require('../controllers/users') router.get('/', usersController.getUsers) module.exports = router
В этом переработанном коде мы разделили задачи маршрутизации, контроллера и извлечения данных на три отдельных файла. Файл// controllers/users.js const database = require('../database') async function getUsers(req, res) { try { const users = await database.getUsers() res.json(users) } catch (error) { res.status(500).send('Internal Server Error') } } module.exports = { getUsers, }
index.js
отвечает за создание приложения Express и регистрацию маршрутов, файл routes/users.js
отвечает за обработку маршрута /users
и делегирование запроса usersController
, а файл controllers/users.js
отвечает за извлечение данных из базы данных и возврат ответа клиенту.
Разделив эти задачи, мы можем достичь лучшей модульности и удобства сопровождения кода. Например, если мы хотим добавить больше маршрутов, мы можем создать новый файл в routes
и зарегистрировать его в index.js
без изменения существующего кода. Аналогичным образом, если мы хотим изменить способ извлечения данных из базы данных, мы можем изменить database.js
файл без изменения маршрута или кода контроллера.
Инверсия зависимостей (Dependency Inversion, DI)
В Clean Architecture зависимости инвертируются, что означает, что модули более высокого уровня должны зависеть от модулей более низкого уровня. Это гарантирует, что бизнес-логика не будет связана с деталями инфраструктуры. Вот пример того, как инверсия зависимостей может быть применена к этому коду:// index.js - Плохой код! const express = require('express') const app = express() const usersController = require('./controllers/users') app.get('/users', async (req, res) => { try { const users = await usersController.getUsers() res.json(users) } catch (error) { res.status(500).send('Internal Server Error') } }) app.listen(3000, () => { console.log('Server is listening on port 3000') })
В этом коде// controllers/users.js const database = require('../database') async function getUsers() { try { const users = await database.getUsers() return users } catch (error) { throw new Error('Error retrieving users') } } module.exports = { getUsers, }
index.js
напрямую зависит от модуля usersController
, который в свою очередь напрямую зависит от модуля database
. Это нарушает принцип инверсии зависимостей, поскольку высокоуровневые модули не должны зависеть от низкоуровневых модулей.
// index.js const express = require('express') const app = express() const usersController = require('./controllers/users') const database = require('./database') app.get('/users', async (req, res) => { try { const users = await usersController.getUsers(database) res.json(users) } catch (error) { res.status(500).send('Internal Server Error') } }) app.listen(3000, () => { console.log('Server is listening on port 3000') })
В этом переработанном коде мы применили Dependency Inversion, передав модуль// controllers/users.js async function getUsers(database) { try { const users = await database.getUsers() return users } catch (error) { throw new Error('Error retrieving users') } } module.exports = { getUsers, }
database
в качестве параметра функции getUsers
в модуле usersController
. Таким образом, высокоуровневый модуль index.js
не зависит напрямую от низкоуровневого модуля database
, но оба зависят от абстракции функции getUsers
.
Применяя инверсию зависимостей, мы можем добиться большей модульности, гибкости и тестируемости кода. Например, если мы хотим переключиться на другую реализацию базы данных, мы можем создать новый модуль, реализующий функцию getUsers
, и передать ее в качестве getUsers
в модуле usersController
без изменения существующего кода. Точно так же мы можем легко имитировать модуль database
для целей модульного тестирования.
Принцип единой ответственности (Single Responsibility Principle, SRP)
Каждый модуль или функция должны нести единую ответственность. Это помогает в создании кодовой базы, которую легко понять и поддерживать. Вот пример в Node.js который иллюстрирует принцип SRP:В этом примере у нас есть класс// user.js - Плохой код! class User { constructor(name, email, password) { this.name = name; this.email = email; this.password = password; } saveToDatabase() { await database.saveUser(user) .then(() => { res.status(200).send() }) .catch(err => { res.status(400).send('Email Error') }); } sendWelcomeEmail() { await mailService.send(user, 'Welcome') .then(() => { res.status(200).send() }) .catch(err => { res.status(400).send('Email Error') }); } }
User
, который имеет две обязанности:
- Сохранение пользовательских данных в базе данных
- Отправка приветственного электронного письма пользователю
User
имеет несколько причин для изменения. Например, если мы решим изменить способ сохранения пользовательских данных в базе данных, нам также придется изменить класс User
, даже если это не связано с отправкой приветственного электронного письма.
Теперь у нас есть три класса, каждый из которых несет единую ответственность:class User { constructor(name, email, password) { this.name = name; this.email = email; this.password = password; } } class UserRepository { saveToDatabase(user) { await database.saveUser(user) .then(() => { res.status(200).send() }) .catch(err => { res.status(400).send('Email Error') }); } } class EmailService { sendWelcomeEmail(user) { await mailService.send(user, 'Welcome') .then(() => { res.status(200).send() }) .catch(err => { res.status(400).send('Email Error') }); } } }
User
: отвечает за представление пользователя.UserRepository
: отвечает за сохранение пользовательских данных в базе данных.EmailService
: отвечает за отправку приветственного электронного письма пользователю.
UserRepository
. Класс User
и класс EmailService
остаются неизменными.
Концепции и детальное проектирование
Чистая архитектура в Node.js основана на принципах чистой архитектуры, введенных Робертом С. Мартином (он же дядя Боб). В нем подчеркивается разделение ответственности, разъединение зависимостей и модульность. Цель состоит в том, чтобы создать кодовую базу, которую легко понять, протестировать и поддерживать. Основная идея Clean Architecture заключается в разделении приложения на разные слои, где каждый уровень несет определенную ответственность. Слои взаимодействуют друг с другом через четко определенные интерфейсы. Это позволяет легко модифицировать и тестировать приложение, не затрагивая другие части кодовой базы. Node.js — это популярная среда выполнения для создания веб-приложений. Он имеет обширную экосистему библиотек и фреймворков, которые можно использовать для реализации Clean Architecture. Вот некоторые из ключевых концепций чистой архитектуры в Node.js:Уровень инфраструктуры (Infrastructure Layer)
Уровень инфраструктуры отвечает за обработку внешних зависимостей, таких как базы данных, API или файловая система. Он должен быть отделен от уровня домена, чтобы обеспечить легкое тестирование и модификацию. Уровень инфраструктуры должен реализовывать интерфейсы, определенные уровнем домена. В Node.js уровень инфраструктуры может быть реализован с помощью пакетов или модулей. Например, можно использовать популярный пакет Knex.js для обработки запросов к базе данных. Уровень инфраструктуры должен быть спроектирован так, чтобы быть подключаемым, что позволяет легко заменять внешние зависимости. Вот пример модуля инфраструктуры, реализующего адаптер базы данных:Этот модуль предоставляет методы для получения пользователя по идентификатору и сохранения пользователя в базе данных с помощью библиотеки Knex.js.const knex = require('knex'); class UserDatabase { constructor(config) { this.db = knex(config); } async getById(id) { const data = await this.db('users').where({ id }).first(); return data ? User.create(data) : null; } async save(user) { const data = User.toData(user); const { id } = user; if (id) { await this.db('users').where({ id }).update(data); } else { const [newId] = await this.db('users').insert(data); user.id = newId; } } }
Уровень представления (Presentation Layer)
Уровень представления отвечает за отображение выходных данных приложения для пользователя и обработку вводимых пользователем данных. Он должен быть отделен от прикладного уровня и уровня инфраструктуры. Уровень представления может быть реализован с помощью веб-фреймворков, таких как Express.js или Hapi.js. В Node.js уровень представления может быть реализован с помощью веб-фреймворков или модулей. Веб-фреймворки предоставляют мощный и гибкий способ реализации уровня представления и размещения всей логики вместе. Вот пример модуля презентации, реализующего REST API с помощью веб-платформы Express.js:Этот модуль создает приложение Express.js, настраивает пользовательскую службу и базу данных, а также предоставляет конечные точки REST API для получения и обновления пользовательских данных.const express = require('express'); const bodyParser = require('body-parser'); const UserService = require('./services/user-service'); const UserDatabase = require('./infra/user-database'); const app = express(); app.use(bodyParser.json()); const userDatabase = new UserDatabase(config); const userService = new UserService(userDatabase); app.get('/users/:id', async (req, res) => { const { id } = req.params; try { const user = await userService.getUserById(id); res.json(user); } catch (error) { res.status(404).json({ error: error.message }); } }); app.put('/users/:id', async (req, res) => { const { id } = req.params; const { userData } = req.body; try { let user = await userService.getUserById(id); user = User.create({ ...user, ...userData }); await userService.saveUser(user); res.json(user); } catch (error) { res.status(404).json({ error: error.message }); } });
Прикладной уровень (Application Layer)
Прикладной уровень отвечает за оркестрацию взаимодействия между доменным уровнем и уровнем инфраструктуры. Он содержит варианты использования приложения, которые представляют взаимодействия между пользователем и системой. Прикладной уровень должен быть отделен от уровня домена и уровня инфраструктуры. В Node.js прикладной уровень может быть реализован с помощью классов или модулей. Классы обеспечивают четкое разделение ответственности и инкапсуляцию. Модули обеспечивают более простой подход к реализации прикладного уровня. Вот пример класса приложения, представляющего пользовательскую службу:Этот класс предоставляет методы для получения пользователя по идентификатору и сохранения пользователя с помощью модуля инфраструктуры UserDatabase.class UserService { constructor(userDatabase) { this.userDatabase = userDatabase; } async getUserById(id) { const user = await this.userDatabase.getById(id); if (!user) { throw new Error(`User not found with ID ${id}`); } return user; } async saveUser(user) { await this.userDatabase.save(user); } }
Уровень домена (Domain (Enterprise) Layer)
Доменный уровень является сердцем приложения, содержащим бизнес-логику и правила. Он должен быть независим от каких-либо внешних библиотек или фреймворков, что упрощает его тестирование и изменение. Доменный уровень является наиболее важной частью приложения, и любые изменения должны вноситься с большой осторожностью. В Node.js, уровень домена может быть реализован с помощью классов или модулей. Классы обеспечивают четкое разделение ответственности, инкапсуляцию и возможность повторного использования. Модули, с другой стороны, обеспечивают более простой подход к реализации доменного уровня. Вот пример класса домена, представляющего сущность пользователя:Этот класс инкапсулирует пользовательские данные и предоставляет методы для изменения имени и адреса электронной почты пользователя.class User { constructor(id, name, email) { this.id = id; this.name = name; this.email = email; } changeName(name) { this.name = name; } changeEmail(email) { this.email = email; } static create(data) { const { id, name, email } = data; return new User(id, name, email); } static toData(user) { const { id, name, email } = user; return { id, name, email }; } }
Использование сторонних npm пакетов
Использование сторонних пакетов — отличный способ повысить чистоту кода. Существует множество пакетов, которые могут помочь вам организовать кодовую базу и сделать ее более модульной. Например, можно использовать пакет, например Express.js для обработки маршрутизации и промежуточного ПО. Вы также можете использовать пакет, такой как Knex.js для обработки запросов к базе данных. Использование этих пакетов может помочь уменьшить дублирование кода и сделать базу кода более организованной. Вот еще несколько примеров использования сторонних пакетов:Lodash
Lodash — это служебная библиотека, предоставляющая широкий спектр функций для работы с массивами, объектами и другими структурами данных. Используя Lodash, можно избежать написания повторяющегося кода для таких задач, как фильтрация, сортировка и преобразование данных. Например, рассмотрим следующий код для фильтрации массива пользователей по возрасту:Используя Lodash, вы можете вместо этого написать следующий код:const users = [ { name: 'Alice', age: 25 }, { name: 'Bob', age: 30 }, { name: 'Charlie', age: 35 }, ]; const filteredUsers = users.filter(user => user.age >= 30);
Этот код более лаконичный и легкий для чтения, а использование функцииconst _ = require('lodash'); const users = [ { name: 'Alice', age: 25 }, { name: 'Bob', age: 30 }, { name: 'Charlie', age: 35 }, ]; const filteredUsers = _.filter(users, user => user.age >= 30);
filter
от Lodash дает понять, что делает код.
Moment.js или date-fns
Moment.js — это библиотека для синтаксического анализа, манипулирования и форматирования даты и времени. Используя Moment.js, можно избежать написания сложного кода манипуляции с датой и снизить вероятность ошибок. Например, рассмотрим следующий код для форматирования даты в виде строки:Используя Moment.js, вы можете вместо этого написать следующий код:const date = new Date(); const formattedDate = `${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}`;
Этот код легче читать и поддерживать, а использование функции format от Moment.js дает понять, что делает код.const moment = require('moment'); const date = new Date(); const formattedDate = moment(date).format('YYYY-MM-DD');
Winston
Winston — это библиотека логирования (журналирования), которая предоставляет множество функций для ведения журнала сообщений, включая различные уровни логов и настраиваемое форматирование. Используя Winston, вы можете избежать написания пользовательского кода ведения журнала и убедиться, что ваши журналы согласованы и легко читаются. Например, рассмотрим следующий код для регистрации сообщения:Используя Winston, вы можете вместо этого написать следующий кодconsole.log(`[${new Date().toISOString()}] INFO: User logged in`);
Этот код более настраиваемый и легко читаемый, а использование Winston дает понять, что делает код.const winston = require('winston'); const logger = winston.createLogger({ level: 'info', format: winston.format.combine( winston.format.timestamp(), winston.format.printf(info => `[${info.timestamp}] ${info.level}: ${info.message}`) ), transports: [ new winston.transports.Console(), new winston.transports.File({ filename: 'app.log' }), ], }); logger.info('User logged in');
Итоги
Чистая архитектура — это мощная концепция, которая может помочь вам создать модульный и поддерживаемый код в проектах Node.js. Следуя принципам чистой архитектуры, можно создать кодовую базу, которую легко понять, протестировать и расширить. Можно также использовать сторонние пакеты и различные структуры папок для повышения чистоты кода. Реализация Clean Architecture в проектах Node.js может помочь вам избежать распространенных ошибок, таких как дублирование кода, неорганизованная кодовая база и тесная связь.Обработка ошибок в Express.js
2 года назад·4 мин. на чтение
Пишем middleware для Express.js для обработки ошибок.
Из-за неопределенного характера JavaScript существует множество способов выполнения одной задачи. Это может стать как достоинством, так и недостатком, особенно при работе в более крупной команде. Именно здесь в игру вступают процессы и руководящие принципы.
Предусловия
- Установленный NodeJS
- Знание NodeJS и Express.js
- Знание того, как работает middleware в Express.js
Настройка проекта
Создадим базовое приложение Express.js с одним эндпоинтом. Этот эндпоинт (или ручка) будет методомPOST
, который принимает два входных параметра title
и author
.
Мы проверяем, существуют лиconst express = require('express'); const bodyParser = require('body-parser'); const app = express(); const port = 3000; app.use(bodyParser.json()); app.post('/post', async (req, res) => { const { title, author } = req.body; if (!title || !author) { return res.status(400).json({ status: 'error', message: 'Missing required fields: title or author' }); } try { const post = await db.post.insert({ title, author }); res.json(post); } catch (error) { return res.status(500).json({ status: 'error', message: 'Internal Server Error' }); } }); app.listen(port, () => console.log(`app is listening at http://localhost:${port}`) );
title
и author
, если нет, мы выбрасываем ошибку 400
и отправляем обратно JSON со статусом и сообщением.
Если title
и author
существуют, приложение все равно будет аварийно завершать работу, потому что db
не определена, и наш блок try
/catch
поймает его и отправит обратно ошибку 500
и JSON со статусом и сообщением.
Со временем, по мере роста количества эндпоинтов и проверок, ввод res.status(4xx).json({ some: JSON })
каждый раз может быстро стать громоздким, а также создать большую избыточность кода. Почему бы не сделать что-то вроде throw new BadRequest('message')
? Давайте посмотрим, как мы можем это реализовать.
Создание утилит для ошибок
Теперь создадим функции, которую мы можем использовать для генерации ошибок. Создадим новую папку/utils
и файл errors.js
.
Этот файл определяет, какие ошибки мы можем выбросить в нашем приложении. Класс// /utils/errors.js class GeneralError extends Error { constructor(message) { super(); this.message = message; } getCode() { if (this instanceof BadRequest) { return 400; } if (this instanceof NotFound) { return 404; } return 500; } } class BadRequest extends GeneralError { } class NotFound extends GeneralError { } module.exports = { GeneralError, BadRequest, NotFound };
GeneralError
расширяет Error
и используется для получения наших сообщений и кодов состояния.
Здесь у нас есть BadRequest
и NotFound
, которые расширяют GeneralError
. Мы также указываем их коды ошибок в блоке getCode
в GeneralError
.
Для простоты этой демонстрации у нас будут толькоBadRequest
и NotFound
. Если вы хотите добавить другие типы ошибок, все, что вам нужно сделать, это создать новый класс, который расширяет GeneralError
и обновить его код состояния внутри блока getCode
.
Создание middleware для обработки ошибок
Теперь мы сосредоточимся на реализации express middleware для обработки ошибок в нашем приложении. Создадим новый файл/middleware/handleErrors.js
.
Примечание: middleware для обработки ошибок принимает 4 аргумента (ошибка в качестве первого аргумента), а не 3 аргумента для обычного middleware . Функция middleware// /middleware/handleErrors.js const { GeneralError } = require('../utils/errors'); const handleErrors = (err, req, res, next) => { if (err instanceof GeneralError) { return res.status(err.getCode()).json({ status: 'error', message: err.message }); } return res.status(500).json({ status: 'error', message: err.message }); } module.exports = handleErrors;
handleErrors
проверяет, является ли переданная ошибка экземпляром GeneralError
. Если это так, мы возвращаем код состояния и тело JSON со статусом и сообщением.
Использование middleware для обработки ошибок
Давайте обновим наше приложение и эндпоинт, чтобы использовать наш недавно созданный middleware для обработки ошибок. Middleware для обработки ошибок должно быть помещено последним, после всех других middleware и маршрутов, чтобы оно функционировало должным образом.Во-первых, мы импортируемconst express = require('express'); const bodyParser = require('body-parser'); const handleErrors = require('./middleware/handleErrors'); const { BadRequest } = require('./utils/errors'); const app = express(); const port = 3000; app.use(bodyParser.json()); app.post('/post', async (req, res, next) => { const { title, author } = req.body; try { if (!title || !author) { throw new BadRequest('Missing required fields: title or author'); // строка 16 } const post = await db.post.insert({ title, author }); res.json(post); } catch (err) { next(err) } }); app.use(handleErrors); // строка 25 app.listen(port, () => console.log(`app is listening at http://localhost:${port}`) );
handleErrors
и регистрируем его как middleware, как показано в строке 25.
Мы также импортируем BadReqest
и обновляем строку 16, чтобы выбросить новый BadRequest
, если title
и author
отсутствуют.
Наконец, мы добавляем next
в качестве третьего аргумента в наш обработчик маршрута. Затем мы обновляем блок catch
, чтобы передать ошибки в next
чтобы наш обработчик ошибок мог обработать его.
Тестирование middleware для обработки ошибок
Для тестирования middleware используем Postman. Сначала мы делаем POST-запрос безbody
. Мы получаем ошибку 400 со статусом и сообщением в формате JSON.
Теперь давайте сделаем еще один запрос POST и передадим{ "status": "error", "message": "Missing required fields: title or author" }
title
и author
. На этот раз мы получаем ошибку 500 со статусом и сообщением в JSON.
Простое и чистое решение для обработки ошибок в приложении Express.js.{ "status": "error", "message": "db is not defined" }