Class Sql

constructor

• new Sql(appContext?: AppContext): Sql

  Создает новый экземпляр класса Sql Инициализирует подключение к базе данных

  Parameters

  • OptionalappContext: AppContext

  Returns Sql

  Example

  const sql = new Sql();
  Copy

appContext

database

sql.database = 'myapp';
Copy

host

sql.host = 'mongodb://localhost:27017';
Copy

pass

sql.pass = 'password';
Copy

user

sql.user = 'admin';
Copy

close

• close(): Promise<void>

  Закрывает соединение с базой данных Освобождает ресурсы и очищает состояние подключения

  Returns Promise<void>

  Example

  sql.close();
  console.log('Database connection closed');
  Copy

connect

• connect(): Promise<boolean>

  Устанавливает соединение с базой данных

  Returns Promise<boolean>

  Promise - true если подключение успешно, false в противном случае

  Example

  const connected = await sql.connect();
  if (connected) {
    console.log('Connected to database');
  }
  Copy

escapeString

• escapeString(text: string | number): string

  Экранирует специальные символы в строке В текущей реализации просто преобразует значение в строку

  Parameters

  • text: string | number

    Текст для экранирования

  Returns string

  Экранированная строка

  Example

  const safe = sql.escapeString("O'Connor");
  console.log(safe); // "O'Connor"
  Copy

initParam

• initParam(host: string, user: string, pass: string, database: string): void

  Устанавливает параметры подключения к базе данных

  Parameters

  • host: string

    Адрес сервера базы данных

  • user: string

    Имя пользователя

  • pass: string

    Пароль пользователя

  • database: string

    Имя базы данных

  Returns void

  Example

  sql.initParam(
    'mongodb://localhost:27017',
    'admin',
    'password',
    'myapp'
  );
  Copy

isConnected

• isConnected(): Promise<boolean>

  Проверяет состояние подключения к базе данных

  Returns Promise<boolean>

  Promise - true если подключение активно, false в противном случае

  Example

  const isAlive = await sql.isConnected();
  if (isAlive) {
    console.log('Database connection is active');
  }
  Copy

query

• query(callback: TQueryCb): Promise<any>

  Выполняет произвольный запрос к базе данных

  Parameters

  • callback: TQueryCb

    Функция обратного вызова для выполнения запроса

  Returns Promise<any>

  Promise с результатом запроса или null в случае ошибки

  Example

  const result = await sql.query(async (client, db) => {
    const collection = db.collection('users');
    const users = await collection.find({}).toArray();
    return { status: true, data: users };
  });
  
  if (result) {
    console.log('Query result:', result);
  }
  Copy

standardInit

• standardInit(): Promise<boolean>

  Инициализирует подключение к базе данных из конфигурации Загружает параметры подключения из appContext.config.db

  Returns Promise<boolean>

  Promise - true если инициализация успешна, false в противном случае

  Example

  const initialized = await sql.standardInit();
  if (initialized) {
    console.log('Database connection initialized');
  }
  Copy