Данный репозиторий устарел

Пожалуйста, посетите https://gitee.com/648823596/QuickDAO3 для просмотра последней версии.

QuickDAO

QuickDAO — это простой, удобный и легковесный Java ORM-фреймворк.

Поддержка баз данных

Последняя версия 2.10 поддерживает следующие базы данных, и список будет пополняться...

• MySQL
• SQLite
• H2
• Postgre
• SQL Server (версии выше 2012)

Подробная документация (gitbook)

Для быстрого ознакомления с QuickDAO и его использования была написана документация в формате gitbook. Посетите, чтобы ознакомиться с ней.

Замечания

В среде SpringBoot из-за проблем с загрузчиком классов рекомендуется использовать с осторожностью, так как это может привести к непредвиденным проблемам!

На данный момент QuickDAO не тестировался в условиях высокой параллельности, поэтому рекомендуется использовать его с осторожностью в проектах с высокой нагрузкой. Этот проект подходит для небольших и средних проектов, предоставляя хорошо упакованные API для взаимодействия с базой данных и сокращая объём шаблонного кода, что максимально повышает эффективность разработки!

Сейчас QuickDAO использует фреймворк Logback для логирования. На уровне DEBUG будут выводиться выполняемые SQL-запросы!

Быстрый старт

1. Создание класса сущности

// Класс пользователя
public class User {
    private long id;
    private String username;
    private String password;
}

Класс сущности должен содержать поле id. Если есть аннотация @Id, то свойство, помеченное этой аннотацией, используется как id, иначе в качестве id используется свойство с именем id.

Тип поля id должен быть long!

2. Импорт QuickDAO

QuickDAO основан на JDBC и по умолчанию поддерживает только пулы соединений для повышения эффективности.

• Импортируйте commons-dbcp (или другой DataSource-реализацию).
• Импортируйте последнюю версию QuickDAO.

<dependency>
   <groupId>commons-dbcp</groupId>
   <artifactId>commons-dbcp</artifactId>
   <version>1.4</version>
</dependency>
<dependency>
  <groupId>cn.schoolwow</groupId>
  <artifactId>QuickDAO</artifactId>
  <version>2.10</version>
</dependency>

3. Использование QuickDAO

QuickDAO поддерживает автоматическое создание таблиц и добавление полей. После настройки QuickDAO в коде Java больше не требуется выполнять какие-либо операции с базой данных.

BasicDataSource mysqlDataSource = new BasicDataSource();
mysqlDataSource.setDriverClassName("com.mysql.jdbc.Driver");
mysqlDataSource.setUrl("jdbc:mysql://127.0.0.1:3306/quickdao");
mysqlDataSource.setUsername("root");
mysqlDataSource.setPassword("123456");
// Указываем пакет, в котором находится класс сущности
cn.schoolwow.quickdao.dao.DAO dao = QuickDAO.newInstance()
                    .dataSource(mysqlDataSource)
                    .packageName("cn.schoolwow.quickdao.entity")
                    .build();
// Все последующие операции выполняются с использованием объекта dao

Обратная связь

На данный момент QuickDAO всё ещё находится в стадии разработки и улучшения. Если у вас возникли проблемы, пожалуйста, создайте Issue, автор оперативно отреагирует и постарается решить проблему. Также мы приветствуем активное участие и PR-вклады от заинтересованных разработчиков, чтобы совместно улучшить проект QuickDAO!

Лицензия с открытым исходным кодом

Это программное обеспечение использует лицензию GPLv3 с открытым исходным кодом!