Обновление Rust-библиотеки Ormlib до версии 1.0.1. Что изменилось и почему это важно?08.10.2023 16:45

Я рад сообщить, что вышла новая версия моей Rust-библиотеки для объектно-реляционного отображения — Ormlib 1.0.1. В этой версии было проделано много работы по улучшению архитектуры библиотеки.

В предыдущей версии 0.3.3, Ormlib работал только с базой данных SQLite. Это ограничивало сферы применения библиотеки. В версии 1.0.1 была проделана большая работа по рефакторингу кода, чтобы абстрагировать ее от конкретной реализации СУБД.

1f7f181c0c3828ec4097c365a9363c3c.png

После рефакторинга я использовал механизм «features», который позволяет компилировать Ormlib либо с поддержкой SQLite, либо с поддержкой MySQL.

[dependencies]
ormlib = {version = "1.0.1", features = ["sqlite"]} # or "mysql"
ormlib_derive = "1.0.1"

Для реализации этой возможности был создан трейт ORMTrait, который определяет общий интерфейс для работы с ORM.

Этот трейт реализуется отдельно для SQLite и MySQL. Таким образом я получил гибкую архитектуру, которая позволит в будущем добавлять поддержку и других СУБД.

Трейт ORMTrait предоставляет следующие базовые методы для работы с базой данных:

  • add() — добавляет данные в базу данных

  • close() — закрывает соединение с базой данных

  • find_one() — ищет одну запись по ID

  • find_many() — ищет несколько записей по условию

  • find_all() — ищет все записи

  • modify() — изменяет запись

  • remove() — удаляет запись

  • query() — выполняет произвольный запрос

  • query_update() — выполняет произвольный запрос с обновлением данных

  • protect() — экранирует строку от SQL-инъекций

  • init() — выполняет инициализацию базы данных

Чтобы перейти на использование новой версии Ormlib, необходимо код: 

use ormlib::{ORM, ORMError};

заменить на: 

use ormlib::sqlite::ORM; // для перехода на mysql заменить на use ormlib::mysql::ORM;
use ormlib::{ORMError, ORMTrait};

Код библиотеки доступен на GitHub по ссылке https://github.com/evgenyigumnov/orm-lib.

© Habrahabr.ru