5.0.1 • Published 5 years ago

kids-db v5.0.1

Weekly downloads
1
License
ISC
Repository
-
Last release
5 years ago

DB

const { DB } = require(`kids-db`);

Constructor

Инициализация новой инстанции

const db = new DB(DB_Name, options); // => this
ПараметрТипОписание
optionsObjectОпции

Options

Общие опции

ОпцияТипОписаниеПо умолчанию
ttlnumberВремя жизни элементов в оперативной памяти в секундах180
staticbooleanБудут ли элементы автоматически очищаться из оперативной памятиfalse
modestringРежим работы БДJSON

Например

new DB(`users`, {
	ttl: 300,
	mode: `BSON`,
});

init

Инициализирует БД

db.init(); // => Promise<true>

statistics

Возвращает текущую статистику для БД

db.statistics(); // => Promise<Object>
ПараметрТипОписание
namestringНазвание БД
pathstringПуть к БД
elementsnumberКоличество элементов в БД
elements_in_memnumberКоличество элементов в оперативной памяти
ttlnumberВремя жизни элемента в оперативной памяти в секундах
last_accessnumberВремя последнего обращения к БД в миллисекундах, прошедших с 1 января 1970 года
last_changenumberВремя последнего изменения в БД в миллисекундах, прошедших с 1 января 1970 года
creatednumberВремя создания БД в миллисекундах, прошедших с 1 января 1970 года

save_all_elements_in_mem

Сохраняет все элементы из оперативной памяти, в постоянную память

db.save_all_elements_in_mem(); // => Promise<true>

set_ttl

Сохраняет все элементы из оперативной памяти, в постоянную память

db.set_ttl(ttl); // => Promise<true>
ПараметрТипОписание
ttlnumberВремя жизни элемента в оперативной памяти в секундах

elements

Возвращает обьект с функциями для взаимодействия с элементами БД

db.elements; // => Promise<Object>
ПараметрТипОписание
getfunctionФункция получения элемента
createfunctionФункция создания элемента
updatefunctionФункция обновления элемента
savefunctionФункция сохранения элемента
deletefunctionФункция удаления элемента

get

Возвращает выбранный элемент

db.elements.get(element_id, options); // => Promise<Object>
ПараметрТипОписание
element_idstringИдентификатор элемента
optionsObjectОпции

create

Создает новый элемент

db.elements.create(element_id, data, options); // => Promise<Object>
ПараметрТипОписание
element_idstringИдентификатор элемента
dataobjectДанные элемента
optionsObjectОпции

update

Обновляет выбранный элемент

db.elements.update(element_id, data, options); // => Promise<Object>
ПараметрТипОписание
element_idstringИдентификатор элемента
dataobjectДанные элемента
optionsObjectОпции

save

Сохраняет выбранный элемент

db.elements.save(element_id); // => Promise<true>
ПараметрТипОписание
element_idstringИдентификатор элемента

delete

Удаляет выбранный элемент

db.elements.delete(element_id); // => Promise<true>
ПараметрТипОписание
element_idstringИдентификатор элемента

exists

Проверяет существование элемента

db.elements.exists(element_id); // => Promise<boolean>
ПараметрТипОписание
element_idstringИдентификатор элемента

list

Выводит массив в котором содержатся все идентификаторы существующих элементов

db.elements.list(); // => Promise<Array>

extended_list

Выводит массив в котором содержатся все идентификаторы существующих элементов и дополнительная информация о них

db.elements.extended_list(); // => Promise<Array>

get_selected

Возвращает массив с выбранными элементами

db.elements.get_selected(element_id); // => Promise<Array>
ПараметрТипОписание
elements_idsarrayМассив с идентификаторами элементов которые нужно получить

get_all

Возвращает массив со всеми существующими элементами

db.elements.get_all(); // => Promise<Array>

File

load

Инициализация новой инстанции с выбранным элементом

const file = db.load(id, options); // => Promise<this>
//OR
const file = db.create(id, file_data, options); // => Promise<this>
ПараметрТипОписание
idstringИдентификатор файла, который нужно получить
optionsObjectОпции

data

Получает данные которые содержатся в выбранном элементе

file.data(); // => Promise<Object>

save

Сохраняет выбранный элемент в постоянную память

file.save(); // => Promise<true>

update

Обновляет выбранный элемент

file.update(new_data); // => Promise<Object>
ПараметрТипОписание
new_dataobjectНовые данные, которые должны содержаться в выбранном элементе

delete

Навсегда удаляет выбранный элемент с оперативной и постоянной памяти

file.delete(); // => Promise<true>

File_Options

Общие опции

ОпцияТипОписаниеПо умолчанию
ttlnumberВремя жизни элемента в оперативной памяти в секундахОпции
staticbooleanБудет ли элемент автоматически очищаться из оперативной памятиОпции

settings

const { setting } = require(`kids-db`);

set_database_dir

Изменяет папку в которой будут храниться данные

settings.set_database_dir(new_dir); // => Promise<true>
ПараметрТипОписание
new_dirstringНазвание папки в которой будут храниться все данные

set_database_dir

Изменяет путь в котором будет храниться папка с данными

settings.set_database_path(new_path); // => Promise<true>
ПараметрТипОписание
new_pathstringПуть к папке в которой хранятся все данные

set_database_dir

Изменяет путь в котором будет храниться папка с данными

settings.set_full_path(new_path); // => Promise<true>
ПараметрТипОписание
new_pathstringПолный путь к папке в которой хранятся все данные

enable_autoclear_cache

Включает автоматическую очистку элементов из оперативной

settings.enable_autoclear_cache(); // => Promise<true>

disable_autoclear_cache

Отключает автоматическую очистку элементов из оперативной

settings.disable_autoclear_cache(); // => Promise<true>
5.0.1

5 years ago

4.0.0

5 years ago

5.0.0

5 years ago

3.0.1

5 years ago

3.0.0

5 years ago

2.1.0

5 years ago

2.0.1

5 years ago

2.0.0

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago