Работаем с огромными числами без потери точности

🔢 Что такое BigInt?

BigInt — это тип, который позволяет безопасно работать с большими целочисленными значениями. Наибольшее число, которое JavaScript может надежно представить с помощью примитива Number, — это 2^53 – 1, выраженное константой MAX_SAFE_INTEGER.

В отличие от стандартного типа Number, BigInt способен представлять целые числа с произвольной точностью, что позволяет избежать проблем при работе с очень большими числами.

🌐 Как использовать BigInt?

Чтобы создать BigInt, добавьте n в конец целочисленного литерала или используйте функцию BigInt():

const hugeNumber = 9007199254740991n; // BigInt

const anotherHugeNumber = BigInt("9007199254740991"); // также BigInt

Пример потери точности:

// Обычные числа

let regularNumber = 9007199254740992; // это максимальное целое число в JavaScript

console.log(regularNumber); // Вывод: 9007199254740992

console.log(regularNumber + 1); // Вывод: 9007199254740992 (потеря точности)

// Использование BigInt

let bigIntNumber = BigInt("9007199254740992000"); // используем строку для создания BigInt

console.log(bigIntNumber); // Вывод: 9007199254740992000n

console.log(bigIntNumber + 1n); // Вывод: 9007199254740992001n (без потери точности)

👾 Когда стоит использовать?

1. Когда вам нужно работать с очень большими числами, которые не помещаются в обычные числовые типы (например факториалы, числа Фибоначчи, большие простые числа).

Пример:

function factorial(n) {

if (n === 0n) return 1n;

return n * factorial(n - 1n);

}

const result = factorial(1000n); // очень большое число!

1. Когда вы обрабатываете большие объемы данных, например в финансовых приложениях или аналитике.

Пример:

const transactions = [1097857843333489700n, 297678444489000n, 506553670n, 1507899978870n]; // большие суммы

const totalAmount = transactions.reduce((sum, amount) => sum + amount, 0n);

⚠️ Ограничения:

1. BigInt не может быть использован с методами Math и не должен смешиваться с обычными числами типа Number в арифметических операциях.
2. Будьте осторожны при преобразовании между BigInt и Number (возможна потеря точности).

Прежде чем настроить подключение, необходимо запустить саму базу данных. В нашем примере Postgres мы развернем в docker-окружении. Пример docker-compose может быть следующим:

version: '3.7'

networks:
    backend-network:
        external:
            name: "backend-network"

services:
    postgres:
        image: postgres:14.0
        container_name: postgres
        restart: always
        environment:
            POSTGRES_USER: "${POSTGRES_USER}"
            POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}"
        volumes:
            - ./data:/var/lib/postgresql/data:rw
        networks:
            - backend-network

    # Adminer container
    adminer:
        image: adminer:latest
        container_name: adminer
        restart: always
        depends_on:
          - postgres
        ports:
          - 9019:8080
        networks:
            - backend-network

volumes:
    data:
        driver: local

В примере для удобства просмотра через веб-интерфейс добавлен adminer. Для подключения к веб-интерфейсу необходимо в адресной строке браузера набрать http://<IP-адрес-сервера>:8080

В файле .env заполняем переменные: POSTGRES_USER — пользователь БД, POSTGRES_PASSWORD — пароль для подключения к БД.

Запускаем окружение с помощью команды:

docker-compose up -d

Проверяем статус

[centos@vm-01]$ docker-compose ps
Name                   Command                 State     Ports
------------------------------------------------------------------
adminer         entrypoint.sh php -S [::]: ...   Up      0.0.0.0:9019->8080/tcp
postgres-14.0   docker-entrypoint.sh postgres    Up      5432/tcp

Заходим в контейнер с помощью команды docker exec -it postgres-14.0 bash

Для подключения к созданной БД используем команду psql -Uusername, где username — это пользователь БД, заданный в переменной POSTGRES_USER в файле .env

При успешном подключении должна появиться командная строка, например:

81fbb2d54a29:/# psql -Uusername
psql (14.8)
Type "help" for help.
postgreadmin=#

Создаем БД с помощью команды:

CREATE DATABASE strapidb WITH OWNER username;

Проверяем, что база данных успешно создана, набрав команду: \l

postgreadmin-# \l
                                         List of databases
     Name      |    Owner     | Encoding |  Collate   |   Ctype    |       Access privileges
---------------+--------------+----------+------------+------------+-------------------------------
   strapidb    |   username   | UTF8     | en_US.utf8 | en_US.utf8 |

Теперь в docker-окружении Strapi в файле .env указываем данные для подключения к нашей созданной БД, например:

DATABASE_CLIENT=postgres
DATABASE_HOST=postgres-14.0
DATABASE_PORT=5432
DATABASE_NAME=strapidb
DATABASE_USERNAME=username
DATABASE_PASSWORD=12345678

DATABASE_CLIENT — указывает на то, что в качестве клиента Strapi будет использовать Postgres.

DATABASE_HOST — указывает наименование запущенного контейнера Postgres, в нашем примере это postgres-14.0.

DATABASE_PORT — порт, на котором работает БД.

DATABASE_NAME — имя базы данных, в нашем примере strapidb.

DATABASE_USERNAME — пользователь, указанный в переменной POSTGRES_USER,

DATABASE_PASSWORD — пароль, указанный в переменной POSTGRES_PASSWORD.

Вернуться в Chulakov Dev

Прежде чем перейти к подробному рассмотрению способов копирования данных, давайте сперва разберемся, в чем разница между передачей данных по значению и по ссылке.

Как мы знаем, в JavaScript данные в переменную передаются либо по значению, либо по ссылке. В первом случае по значению передаются только примитивы. К ним относятся такие типы, как строка, число, булево значение, символ и т.д. А во втором случае по ссылке передаются объекты.

Что значит передача по значению? Это когда в переменной записывается конкретное значение, которое имеет свой уникальный адрес в памяти.

Пример:

let user1 = "Ivan";

let user2 = "Alex";

Также мы можем скопировать в переменную user2 другую переменную user1. И обе эти переменные будут иметь уникальные адреса в памяти и между собой никак не будут связаны.

В случае передачи по ссылке при копировании объекта мы лишь присваиваем ссылку на данные, то есть назначаем адрес памяти объекта оригинальной переменной.

Поверхностное копирование

Рассмотрим способы поверхностного копирования объектов.

1. Самый короткий и простой способ скопировать объект — это использовать синтаксис spread.

Пример:

const person = { name: "Ivan", age: 23 };

const clonedPerson = { ...person }; // Object { name: "Ivan", age: 23 }

2. Также для копирования объекта можно использовать метод Object.assign().

Пример:

const person = { name: "Ivan", age: 23 };

const clonedPerson = Object.assign({}, person); // Object { name: "Ivan", age: 23 }

Проблема с этими двумя подходами заключается в том, что они просто создают новый объект, который имеет точную копию значений в исходном объекте. Но, если любое из полей объекта является ссылкой на другие объекты, копируются только ссылочные адреса, то есть копируется только адрес памяти. Изменение такого поля ссылки будет отражено в обоих объектах.

Получается, что эти два метода являются полезными, но они не сработают, когда у вас есть вложенный объект для копирования.

Глубокое копирование

Теперь давайте рассмотрим современные способы глубокого копирования объектов.

1. В JavaScript есть функция structuredClone() для глубокого копирования массивов или объектов. Она доступна в NodeJS начиная с версии 17.0.0. StructuredClone может клонировать бесконечно вложенные объекты и массивы, циклические ссылки, широкий спектр типов JavaScript, такие как Date, Set, Map, Error, RegExp, ArrayBuffer, Blob, File, ImageData и многие другие. Однако structuredClone не копирует функции, DOM-узлы и дескрипторы свойств.

2. Применение комбинации JSON.parse() и JSON.stringify(). На самом деле это отличный способ и на удивление производительный, но есть некоторые нюансы. Такой метод может обрабатывать только объекты базовых типов, поэтому, например, new Date превратится в [object Object].

3. Использование функции cloneDeep библиотеки Lodash. Отметим, что cloneDeep работает на основе рекурсивного обхода объекта, а это «дорогая операция», поэтому лучше использовать ее, когда это действительно необходимо. К тому же мы всегда можем написать подобную функцию самостоятельно.

Заключение

При создании копии нужно убедиться, хотим ли мы обновлять оригинал при изменении этой копии или нет.

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

Нужно понимать, что глубокое копирование может сильно влиять на производительность, поэтому используйте его, лишь когда это действительно необходимо.

Вернуться в Chulakov Dev

ㅤ

ㅤ

Инструкция

Docker-compose-файл может выглядеть следующим образом:

version: '3.7'

networks:
    frontend:
        external:
            name: frontend-network
    backend-network:
        external:
            name: backend-network

            
services:
    strapi-app:
        image: gitlab.org/docker/images/strapi:4.11.5-1.0.0
        logging:
            driver: 'json-file'
            options:
                max-file: '2'
                max-size: '5m'
        container_name: strapi
        restart: always
        env_file: .env
        environment:
            PORT: ${PORT}
            DATABASE_CLIENT: ${DATABASE_CLIENT}
            DATABASE_HOST: ${DATABASE_HOST}
            DATABASE_PORT: ${DATABASE_PORT}
            DATABASE_NAME: ${DATABASE_NAME}
            DATABASE_USERNAME: ${DATABASE_USERNAME}
            DATABASE_PASSWORD: ${DATABASE_PASSWORD}
            JWT_SECRET: ${JWT_SECRET}
            ADMIN_JWT_SECRET: ${ADMIN_JWT_SECRET}
            APP_KEYS: ${APP_KEYS}
            API_TOKEN_SALT: ${API_TOKEN_SALT}
            NODE_ENV: ${NODE_ENV}
        volumes:
            - ./../../app/src:/opt/app/src
            - ./../../app/public/uploads:/opt/app/public/uploads
            - ./../../app/config:/opt/app/config
        networks:
            - backend-network

volumes:
  strapi-data:
    name: "strapi-data"

Создаем файл с переменными окружения с именем .env

Пример заполнения переменных окружения

PORT=3000 — порт, по которому доступно приложение Node.JS.
HOST_URL — адрес, по которому приложение будет доступно в браузере.
API_HTTP_SCHEME=http:// — при локальной разработке используется http-схема.
API_HTTP_DOMAIN=admin.hostname.local — API-адрес для получения изображений.
CLIENT_API_URL=http://admin.hostname.local/api — адрес, по которому осуществляется получение данных API с клиента через DNS-сервер.
SSR_API_URL=http://strapi-nginx/api — адрес, по которому будем получать данные при выполнении запроса с сервера NODE JS.
ASSET_PREFIX= — используется для отображения статики.
STRAPI_PORT=1337 — порт, на котором работает Strapi.
APP_KEYS="examplekey1,examplekey2" — секретные ключи для cookies.
API_TOKEN_SALT=example — используется для шифрования канала.
ADMIN_JWT_SECRET=examplekey — JWT-ключ для административной панели.
JWT_SECRET=examplekey — JWT-ключ для пользовательских прав.
NODE_ENV=development — запуск сборки разработчика, production — prod режим.
DATABASE_CLIENT=postgres — используемый клиент базы данных.
DATABASE_HOST=strapiDB — название хоста, на котором развернута база данных.
DATABASE_PORT=5432 — порт, на котором работает postgres.
DATABASE_NAME=strapidb — название базы данных.
DATABASE_USERNAME=strapi — имя пользователя базы данных.
DATABASE_PASSWORD=12345678 — пароль к базе данных.

Запускаем приложение с помощью команды

docker-compose up -d

В файле /etc/hosts необходимо указать хост, по которому наше приложение будет доступно с браузера. В нашем случае это:

127.0.0.1 admin.hostname.local

Вернуться в Chulakov Dev

ㅤ

Пошаговая инструкция

1. После клонирования репозитория в корневой папке проекта удаляем файл yarn.lock и запускаем команду

yarn setup

2. После завершения процесса запускаем команду

yarn publish:packages

3. В интерфейсе выбираем опцию Custom version и указываем новую версию пакетов, например 4.11.5-1.0.0.

4. В папке Images/base удаляем yarn.lock. В файле package.json для образов, где указана старая версия, например 4.5.6, добавляем новый префикс, например 4.11.5-1.0.0.

5. Для формирования нового файла yarn.lock, находясь в директории Images/base, запускаем команду

yarn

6. Для запуска проекта в среде Docker запускаем процесс сборки образа

docker build --build-arg NODE_ENV=development -t 
gitlab.org/docker/images/strapi:4.11.5-1.0.0 -f Dockerfile .

Если требуется продакшен сборка, то команда будет

docker build --build-arg NODE_ENV=production -t 
gitlab.org/docker/images/strapi:4.11.5-1.0.0 -f Dockerfile .

7. Загружаем образ в репозиторий

docker push gitlab.org/docker/images/strapi:4.11.5-1.0.0

Пример docker-compose-файла для запуска Strapi может выглядеть следующим образом:

services:
    app:
        image: gitlab.org/docker/images/strapi:4.11.5-1.0.0
        logging:
            driver: 'json-file'
            options:
                max-file: '2'
                max-size: '5m'
        container_name: strapi
        restart: always
        env_file: .env
        environment:
            PORT: ${PORT}
            DATABASE_CLIENT: ${DATABASE_CLIENT}
            DATABASE_HOST: ${DATABASE_HOST}
            DATABASE_PORT: ${DATABASE_PORT}
            DATABASE_NAME: ${DATABASE_NAME}
            DATABASE_USERNAME: ${DATABASE_USERNAME}
            DATABASE_PASSWORD: ${DATABASE_PASSWORD}
            JWT_SECRET: ${JWT_SECRET}
            ADMIN_JWT_SECRET: ${ADMIN_JWT_SECRET}
            APP_KEYS: ${APP_KEYS}
            API_TOKEN_SALT: ${API_TOKEN_SALT}
            NODE_ENV: ${NODE_ENV}
        volumes:
            - ./../../app/src:/opt/app/src
            - ./../../app/public/uploads:/opt/app/public/uploads
            - ./../../app/config:/opt/app/config
        networks:
            - private-network

Вернуться в Chulakov Dev