როგორ შექმნიდით მონაცემთა ბაზას?

მომხმარებელი Room Persistence Library-ს ვიყენებ:

1. დამოკიდებულებების დამატება:

   // 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")
   }
   

2. 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;
   }
   

3. DAO (მონაცემთა წვდომის ობიექტი) განსაზღვრა:

   ქმნი ინტერფეისს, რომელიც ანოტირებულია @Dao-ით, მეთოდებით მონაცემთა წვდომისთვის:

   // 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);
   }
   

4. ბაზის განსაზღვრა:

   ქმნი აბსტრაქტულ კლასს, რომელიც განავრცობს 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();
   }
   

5. ბაზის ინიციალიზაცია:

   იღებ ბაზის მაგალითს, ჩვეულებრივ Application ან Activity კლასში:

   // 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() // რეკომენდებული არაა წარმოებისთვის
                       // .fallbackToDestructiveMigration() // ფრთხილად მიგრაციებთან
                       .build();
           }
           return db;
       }
   }
   

6. მონაცემთა ოპერაციების შესრულება:

   მიღებული DAO-ის მაგალითით, ვასრულებ ოპერაციებს ბაზაზე, უმჯობესია ფონის ნაკადში:

   // 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-ზე დაფუძნებული ბაზის აბსტრაქციას, გამარტივებს მართვას და უზრუნველყოფს კომპილატორული შემოწმებას.