npm i @ntbl/handle --save

import Handle from '@ntbl/handle'
// Импорт модели sequelize
import { Article } from '../models/db'

// Передача статьи в Handle и создание экземпляра
const article = new Handle(Article)

// Создание промежуточного программного обеспечения для запроса всех данных текущей модели
const find = article.findAll()

// Привязка к маршруту
router.get('/article/find', find)

// Предыдущий способ написания

const Article sequelize.import(__dirname + './article')
const article = new Handle(Article)

// Использование загрузчика после
// Обратите внимание, что вам всё ещё нужно передать sequelize
// Внутренний метод использует sequelize.import() для загрузки файла модели
const article = Handle.load(sequelize, __dirname + './article')

// Прохождение через все файлы .js в указанном каталоге (по умолчанию игнорируются index.js и файлы, начинающиеся с _) и их загрузка
// Возвращает объект, где ключ — это имя файла, а значение — экземпляр Handle
// Также возвращает объект с именем _models, содержащий экземпляры моделей sequelize
const db = Handle.loadAll(sequelize, __dirname, {
    // Помимо объекта параметров конструктора Handle,
    // также поддерживает правила сопоставления (поддерживает запись glob)
    rule: '/**/!(index|_)*.js',  // По умолчанию
})

router.get('/article/find', article.findAll())

const find = artcile.process(async function (d) {
    // Проверка данных
    // Опущено
    
    // Запрос пользователя
    const userData = await user
        .where('username', 'password')
        .rawFindOne()
    // Запрос статей текущего пользователя
    const result = await this
        .where(['id', userData.id])
        .rawFindAll()
    // Возврат рекомендованных статей
    return result.filter(e => e.type === 'recommend')
})

// Наконец, привязка к маршруту
router.get('/article/find', find)

// Это повлияет на всё приложение
// Не передавайте прокси-серверу объект, он перезапишет значения по умолчанию
Handle.defaults.proxy.findAll.method = 'post'

// Пусть весь экземпляр действует
// Это нормально, потому что это пустой объект
article.options.proxy = {
  findAll: {
    method: 'post'  
  }
}

// Сделать текущий вызов эффективным
article
  .method('post')
  .findAll()

article
    // uid ☞ идентификатор пользователя
    // Запросить все данные статьи указанного пользователя
    .where('uid')
    .findAll()

article
    // Запросите данные указанной статьи пользователя, удовлетворяющие двум условиям одновременно
    .where('uid', 'id')
    .findAll()

article
    // Запросить данные статьи с id = 1
    // Обратите внимание, что необходимо передать массив
    .where(['id', 1])
    .findAll()

article
    // Используйте псевдоним aid для запроса данных статьи
    // Внешнее использование псевдонима aid, внутреннее использование id
    .where(['id', '@aid'])
    .findAll()

article
    // Запросить данные статьи, используя id или uid
    // Если ни id, ни uid не указаны, это означает отсутствие каких-либо ограничений условий, и это вернёт все данные
    // Вы должны быть осторожны!
    .where(['!id', '!uid'])
    .findAll()

article
    // Запросить данные статьи больше указанного id
    .where('id >')
    .findAll()

where 支持的所有 Op 便捷写法。

let opTag = {
    '>': 'gt',
    '>=': 'gte',
    '<': 'lt',
    '<=': 'lte',
    '!=': 'ne',
    '=': 'and',
    '#and': 'and',
    '#or': 'or',
    '#gt': 'gt',
    '#gte': 'gte',
    '#lt': 'lt',
    '#lte': 'lte',
    '#ne': 'ne',
    '#eq': 'eq',
    '#not': 'not',
    '#between': 'between',
    '#notBetween': 'notBetween',
    '#in': 'in',
    '#notIn': 'notIn',
    '#like': 'like',
    '#notLike': 'notLike',
    '#iLike': 'iLike',
    '#regexp': 'regexp',
    '#iRegexp': 'iRegexp',
    '#notIRegexp': 'notIRegexp',
    '#overlap': 'overlap',
    '#contains': 'contains',
    '#contained': 'contained',
    '#any': 'any',
    '#col': 'col',
};

/*

以下接口参数逻辑, может помочь нам выполнить ☞

1. Запрос данных всех статей указанного пользователя.
2. Запрос данных статей указанного пользователя и указанных данных статьи.
3. Запрос данных статей указанного пользователя с приблизительным соответствием указанному заголовку статьи.

Обратите внимание, что id и title являются необязательными,
а uid должен быть указан.
*/
full: db.article
    .where('uid')
    .where('!id')
    .where(['!title #like', d => `%${d.title}%`])
    .findAll();

article
    // принимает один параметр запроса
    // по умолчанию это name
    .fuzzyQuery('title')
    .findAll()

article
    // необязательно
    .fuzzyQuery('!title')
    .findAll()

article
    // на каждой странице 10 записей данных
    // count — количество записей на странице, по умолчанию 15
    // page — номер страницы, начиная с которой нужно начать, по умолчанию 0
    .pagination(10)
    .findAll()

article
    // сортировка по дате создания в порядке убывания
    .order(['createdAt', 'DESC'])
    .findAll()

article
    // запросить данные статьи, одновременно
    // запрашивая данные пользователя и комментарии каждой статьи
    .include(User, Comment)
    .findAll()

article
    // удалить поле status
    // запретить пользователям обновлять его
    .remove('status')
    .update()

article
    // изменить значение поля status на fall
    set('status', 'fall')
    .update()

it(условие, условие выполнено, условие не выполнено)

// поле
// когда comment == ture, выполнить f1, иначе f2
// обратите внимание, что внутреннее сравнение использует равенство
it('comment', f1, f2)

// функция
// когда count больше 2, выполнить f1, иначе f2
it(d => d.count > 2, f1, f2)

// другое, f1, f2. Может быть функцией или массивом функций
it('comment', f1, [f1, f2, f3])

// условие невыполнения может быть опущено
it('comment', [f1, f2, f3])

article
    // когда комментарий,
    // одновременно запрашивать данные комментариев каждой статьи
    .it('comment', include(Comment))

not(условие, не выполнено, выполнено)

article
    itField('sort', {
      // когда sort = 'name', выполнить
      'name': f1,    
      // когда sort = 'age', выполнить
      'age': [f2, f3],   
      // когда sort = 'height', выполнить
      'height': f4          
    })
    .findAll()

// импортировать независимый объект функций Scopes
const Scopes = Handle.Scopes
const {where, pagination, fuzzyQuery, include, order, it, merge} = Scopes

function nb () {
  // использовать функцию слияния для объединения нескольких функций инструментов
  return merge(
    where('uid'),
    where('!id'),
    fuzzyQuery('!title'),
    order(['createdAt', 'DESC']),
    pagination(10),
  )
}


article
    .scope(nb)
    .findAll()

Handle.Scope.myUtil = function (d) {
   // вернуть полный объект параметров
    return {
        where: {
            uid: d.uid
        }
        // другие параметры
    }
}

article
    .myUtil()
    .findAll() **Является этапом для случаев, когда необходимо выполнить многотабличные операции над интерфейсом и дополнительно обработать возвращаемые данные.** Также это один из шагов при реализации более сложных интерфейсов.

```js
const find = artcile.process(async function (d) {
    // 数据校验
    // Опущено
    
    // Запрос пользователя
    const userData = await user
        .where('username', 'password')
        .rawFindOne()
    // Запрос текущих статей пользователя
    const result = await this
        .where(['id', userData.id])
        .rawFindAll()
    // Возврат только рекомендованных статей
    return result.filter(e => e.type === 'recommend')
})

articleStar.process('post', async function (d) {})

articleStar.transaction(async function (d) {
  /** Обработка, связанная с транзакциями */
  return /** Обработанные данные */
}),

new Handle(model, {
    // before-перехватчик выполняется перед операцией с базой данных
    before (data, ctx, next) {
    
    }
    // after-перехватчик выполняется после операции с базой данных
    after (result, ctx, next) {
        
    }
    // data-перехватчик может выполнять некоторую обработку до возврата данных на фронт или после перехвата исключений
    data (err, result, ctx, next) {
        
    }
})

article
    .before(function (data) {
      const {title} = data
      if (!title) {
        // Выбрасывается исключение
        // Оно будет перехвачено глобальным data-перехватчиком
        throw new Error('Заголовок статьи не может быть пустым')
      }
    
      if (title.length < 1 || title.code.length > 25) {
        throw new Error('Длина заголовка статьи должна быть от 2 до 25 символов')
      }
      return data
    })
    .create()

article
    .after(function (data) {
      // Возвращается только количество статей
      return data.length
    })
    .where('uid')
    .findAll()

// Увеличение поля hot
article
  .raw('hot')
  .increment('id')