Чӣ тавр шумо ба сохтани базаи додаҳо мебаромадед…

Використовуючи бібліотеку Room Persistence Library.

Додавання залежностей:

// build.gradle (рівень додатку)
dependencies {
    def room_version = "2.5.2" // або актуальна версія

    implementation("androidx.room:room-runtime:$room_version")
    annotationProcessor("androidx.room:room-compiler:$room_version") // Для Kotlin використовуйте kapt("...")

    // За бажанням: підтримка Kotlin Extensions та Coroutines для Room
    implementation("androidx.room:room-ktx:$room_version")
}

Визначення Entities (таблиць):

Створюю клас, аннотований як @Entity. Кожне поле буде стовпцем, а @PrimaryKey — первинним ключем.

// User.java
import androidx.room.Entity;
import androidx.room.PrimaryKey;

@Entity(tableName = "users")
public class User {
    @PrimaryKey(autoGenerate = true)
    public int id;

    public String firstName;
    public String lastName;
}

Визначення DAO (Data Access Object):

Створюю інтерфейс, аннотований як @Dao, з методами для доступу до даних (insert, update, delete, query).

// UserDao.java
import androidx.room.Dao;
import androidx.room.Delete;
import androidx.room.Insert;
import androidx.room.OnConflictStrategy;
import androidx.room.Query;
import androidx.room.Update;

import java.util.List;

@Dao
public interface UserDao {
    @Query("SELECT * FROM users")
    List<User> getAll();

    @Query("SELECT * FROM users WHERE id IN (:userIds)")
    List<User> loadAllByIds(int[] userIds);

    @Query("SELECT * FROM users WHERE first_name LIKE :first AND " +
           "last_name LIKE :last LIMIT 1")
    User findByName(String first, String last);

    @Insert(onConflict = OnConflictStrategy.IGNORE)
    void insertAll(User... users);

    @Delete
    void delete(User user);

    @Update
    void updateUsers(User... users);
}

Визначення бази даних:

Створюю абстрактний клас, що розширює RoomDatabase, аннотований @Database. Включаю список сутностей та DAO.

// AppDatabase.java
import androidx.room.Database;
import androidx.room.RoomDatabase;

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();
}

Ініціалізація бази даних:

Отримую екземпляр бази даних, зазвичай у класі Application або Activity (хоча Application переважніше для синглтона).

// В Activity або класі Application
import android.content.Context;
import androidx.room.Room;

public class DatabaseInitializer {
    private static AppDatabase db;

    public static synchronized AppDatabase getDatabase(Context context) {
        if (db == null) {
            db = Room.databaseBuilder(context.getApplicationContext(),
                           AppDatabase.class, "database-name")
                    // .allowMainThreadQueries() // Не рекомендується для production
                    // .fallbackToDestructiveMigration() // Обережно з міграціями
                    .build();
        }
        return db;
    }
}

Виконання операцій з даними:

Отримавши екземпляр DAO, виконую операції з базою даних, переважно у фоновому потоці (наприклад, використовуючи AsyncTask, Executors, Coroutines, RxJava).

// В Activity або будь-якому іншому місці
new Thread(() -> {
   AppDatabase db = DatabaseInitializer.getDatabase(getApplicationContext());
   UserDao userDao = db.userDao();

   // Вставка
   User user1 = new User();
   user1.firstName = "John";
   user1.lastName = "Doe";
   userDao.insertAll(user1);

   // Читання
   List<User> allUsers = userDao.getAll();
   // ... обробка даних
}).start();

Цей підхід забезпечує абстракцію над SQLite, спрощує управління базою даних і надає компіляторну перевірку запитів.

Чӣ тавр шумо ба сохтани базаи додаҳо мебаромадед?