Cube-orm

Cube-orm — это ORM для Android, который представляет собой простую обёртку SQLite. Он автоматически создаёт таблицы и обновляет их версии, а также реализует базовые операции CRUD для одной таблицы. Это повышает эффективность разработки баз данных.

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

Чтобы использовать Cube-orm в Android Studio, добавьте следующую зависимость:

compile 'com.github.supersanders:cube-orm:3.1@aar'

Для конфигурации обфускации используйте следующее правило:

-keep public class * extends com.sanders.db.IDColumn

Соглашения

Все сущности должны наследовать класс IDColumn.java и соответствовать следующим соглашениям об именах:

• Таблица и класс Java: | Таблица | Класс Java | Примечание | | --- | --- | --- | | table_name | TableName | Имя таблицы должно начинаться со строчной буквы, а слова разделяться символом подчёркивания (можно использовать только строчные буквы). |

• Поля таблицы и свойства класса Java: | Поле таблицы | Свойство класса Java | Примечание | | --- | --- | --- | | field_name | fieldName | Имена полей таблицы начинаются со строчных букв, а слова разделяются символом подчёркивания. Именование свойств класса Java соответствует правилам именования CamelCase. |

Создание базы данных

Существует два способа создания базы данных:

1. Системное создание базы данных: поддерживается автоматическое создание таблиц и обновление версий. Если используется автоматическое обновление, и тип поля таблицы изменяется, будет создана новая таблица, а старая таблица будет сохранена как 表名_oldVersion. Необходимо вручную перенести данные в новую таблицу.

2. Внешняя база данных: не поддерживается автоматическое создание таблиц или обновление. Кроме того, имя первичного ключа должно быть primary_key.

Системное создание таблиц

Используйте DBContext для автоматического создания таблиц. Каждая таблица соответствует POJO-сущности, которая наследует класс IDColumn.java:

DBContext dbContext = new DBContext("数据库名称", 数据库名称, new OnDBUpgrade() {
    @Override
    public boolean onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        //return false 自己处理升级，return true 自动处理
        return false;
    }
});

dbContext.addTableBean(TableModel.class).addTableBean(TableBean.class);
DBProxy db = dbContext.buildDBProxy(this);

Или используйте DBContextUse для создания базы данных:

DBContextUse dbContextUse = new DBContextUse("数据库名称", 数据库版本, OnDBUpgrade);
dbContextUse.addSql(create table sql).addSql(create table sql);
DBProxy db = dbContextUse.buildDBProxy(getApplicationContext());

Класс DBProxy.java содержит все операции с базой данных.

Внешняя база данных

Установите внешнюю базу данных, где имя первичного ключа обязательно должно быть primary_key:

DBFile dbFile = new DBFile(file path or File);
DBProxy db = dbFile.buildDBProxy();