Verilerinizi depolamanın çevrimiçi veritabanı, yerel SQLite veritabanı veya hatta bir metin dosyası gibi birçok yolu vardır. Uygulamanız için en iyi çözümün hangisi olduğuna siz karar verirsiniz. Bu derste, güçlü tam metin araması sağlayabilecek bir SQLite sanal tablosunun nasıl oluşturulacağı gösterilmektedir. Tablo, dosyadaki her satırda bir kelime ve tanım çifti içeren bir metin dosyasından alınan verilerle doldurulur.
Sanal Tabloyu oluşturun
Sanal tablo, SQLite tablosuna benzer şekilde davranır ancak veritabanı dosyası yerine geri çağırma aracılığıyla bellekteki bir nesneyi okur ve yazar. Sanal tablo oluşturmak istiyorsanız tablo için bir sınıf oluşturun:
Kotlin
class DatabaseTable(context: Context) { private val databaseOpenHelper = DatabaseOpenHelper(context) }
Java
public class DatabaseTable { private final DatabaseOpenHelper databaseOpenHelper; public DatabaseTable(Context context) { databaseOpenHelper = new DatabaseOpenHelper(context); } }
DatabaseTable
grubunda, SQLiteOpenHelper
kapsamını genişleten bir iç sınıf oluşturun. SQLiteOpenHelper
sınıfı, veritabanı tablonuzun gerektiğinde oluşturulabilmesi ve yükseltilebilmesi için geçersiz kılmanız gereken soyut yöntemleri tanımlar. Örneğin, burada bir sözlük uygulaması için kelimeler içerecek bir veritabanı tablosu belirten bazı kodları görebilirsiniz:
Kotlin
private const val TAG = "DictionaryDatabase" // The columns we'll include in the dictionary table const val COL_WORD = "WORD" const val COL_DEFINITION = "DEFINITION" private const val DATABASE_NAME = "DICTIONARY" private const val FTS_VIRTUAL_TABLE = "FTS" private const val DATABASE_VERSION = 1 private const val FTS_TABLE_CREATE = "CREATE VIRTUAL TABLE $FTS_VIRTUAL_TABLE USING fts3 ($COL_WORD, $COL_DEFINITION)" class DatabaseTable(context: Context) { private val databaseOpenHelper: DatabaseOpenHelper init { databaseOpenHelper = DatabaseOpenHelper(context) } private class DatabaseOpenHelper internal constructor(private val helperContext: Context) : SQLiteOpenHelper(helperContext, DATABASE_NAME, null, DATABASE_VERSION) { private lateinit var mDatabase: SQLiteDatabase override fun onCreate(db: SQLiteDatabase) { mDatabase = db mDatabase.execSQL(FTS_TABLE_CREATE) } override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { Log.w( TAG, "Upgrading database from version $oldVersion to $newVersion , which will " + "destroy all old data" ) db.execSQL("DROP TABLE IF EXISTS $FTS_VIRTUAL_TABLE") onCreate(db) } } }
Java
public class DatabaseTable { private static final String TAG = "DictionaryDatabase"; // The columns we'll include in the dictionary table public static final String COL_WORD = "WORD"; public static final String COL_DEFINITION = "DEFINITION"; private static final String DATABASE_NAME = "DICTIONARY"; private static final String FTS_VIRTUAL_TABLE = "FTS"; private static final int DATABASE_VERSION = 1; private final DatabaseOpenHelper databaseOpenHelper; public DatabaseTable(Context context) { databaseOpenHelper = new DatabaseOpenHelper(context); } private static class DatabaseOpenHelper extends SQLiteOpenHelper { private final Context helperContext; private SQLiteDatabase mDatabase; private static final String FTS_TABLE_CREATE = "CREATE VIRTUAL TABLE " + FTS_VIRTUAL_TABLE + " USING fts3 (" + COL_WORD + ", " + COL_DEFINITION + ")"; DatabaseOpenHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); helperContext = context; } @Override public void onCreate(SQLiteDatabase db) { mDatabase = db; mDatabase.execSQL(FTS_TABLE_CREATE); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { Log.w(TAG, "Upgrading database from version " + oldVersion + " to " + newVersion + ", which will destroy all old data"); db.execSQL("DROP TABLE IF EXISTS " + FTS_VIRTUAL_TABLE); onCreate(db); } } }
Sanal Tabloyu Doldur
Artık tabloda veri depolanacak. Aşağıdaki kod, kelimeleri ve tanımlarını içeren bir metin dosyasını (res/raw/definitions.txt
konumunda bulunur) nasıl okuyacağınızı, dosyayı nasıl ayrıştırılacağını ve dosyadaki her bir satırının sanal tabloya satır olarak nasıl ekleneceğini gösterir. Bu işlem, kullanıcı arayüzünün kilitlenmesini önlemek için başka bir iş parçacığında yapılır. DatabaseOpenHelper
iç sınıfınıza aşağıdaki kodu ekleyin.
İpucu: Bu ileti dizisinin tamamlandığına dair kullanıcı arayüzü etkinliğinizi bildirmek için bir geri çağırma ayarlamak da isteyebilirsiniz.
Kotlin
private fun loadDictionary() { Thread(Runnable { try { loadWords() } catch (e: IOException) { throw RuntimeException(e) } }).start() } @Throws(IOException::class) private fun loadWords() { val inputStream = helperContext.resources.openRawResource(R.raw.definitions) BufferedReader(InputStreamReader(inputStream)).use { reader -> var line: String? = reader.readLine() while (line != null) { val strings: List<String> = line.split("-").map { it.trim() } if (strings.size < 2) continue val id = addWord(strings[0], strings[1]) if (id < 0) { Log.e(TAG, "unable to add word: ${strings[0]}") } line = reader.readLine() } } } fun addWord(word: String, definition: String): Long { val initialValues = ContentValues().apply { put(COL_WORD, word) put(COL_DEFINITION, definition) } return database.insert(FTS_VIRTUAL_TABLE, null, initialValues) }
Java
private void loadDictionary() { new Thread(new Runnable() { public void run() { try { loadWords(); } catch (IOException e) { throw new RuntimeException(e); } } }).start(); } private void loadWords() throws IOException { final Resources resources = helperContext.getResources(); InputStream inputStream = resources.openRawResource(R.raw.definitions); BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream)); try { String line; while ((line = reader.readLine()) != null) { String[] strings = TextUtils.split(line, "-"); if (strings.length < 2) continue; long id = addWord(strings[0].trim(), strings[1].trim()); if (id < 0) { Log.e(TAG, "unable to add word: " + strings[0].trim()); } } } finally { reader.close(); } } public long addWord(String word, String definition) { ContentValues initialValues = new ContentValues(); initialValues.put(COL_WORD, word); initialValues.put(COL_DEFINITION, definition); return database.insert(FTS_VIRTUAL_TABLE, null, initialValues); }
Tabloyu doldurmak için, uygun olan durumlarda loadDictionary()
yöntemini çağırın. Tabloyu oluşturduktan hemen sonra DatabaseOpenHelper
sınıfının onCreate()
yöntemi iyi bir yer olabilir:
Kotlin
override fun onCreate(db: SQLiteDatabase) { database = db database.execSQL(FTS_TABLE_CREATE) loadDictionary() }
Java
@Override public void onCreate(SQLiteDatabase db) { database = db; database.execSQL(FTS_TABLE_CREATE); loadDictionary(); }
Sorguyu ara
Sanal tabloyu oluşturup doldurduktan sonra verilerde arama yapmak için SearchView
tarafından sağlanan sorguyu kullanın. Sorguyu arayan bir SQL deyimi oluşturmak için DatabaseTable
sınıfına aşağıdaki yöntemleri ekleyin:
Kotlin
fun getWordMatches(query: String, columns: Array<String>?): Cursor? { val selection = "$COL_WORD MATCH ?" val selectionArgs = arrayOf("$query*") return query(selection, selectionArgs, columns) } private fun query( selection: String, selectionArgs: Array<String>, columns: Array<String>? ): Cursor? { val cursor: Cursor? = SQLiteQueryBuilder().run { tables = FTS_VIRTUAL_TABLE query(databaseOpenHelper.readableDatabase, columns, selection, selectionArgs, null, null, null) } return cursor?.run { if (!moveToFirst()) { close() null } else { this } } ?: null }
Java
public Cursor getWordMatches(String query, String[] columns) { String selection = COL_WORD + " MATCH ?"; String[] selectionArgs = new String[] {query+"*"}; return query(selection, selectionArgs, columns); } private Cursor query(String selection, String[] selectionArgs, String[] columns) { SQLiteQueryBuilder builder = new SQLiteQueryBuilder(); builder.setTables(FTS_VIRTUAL_TABLE); Cursor cursor = builder.query(databaseOpenHelper.getReadableDatabase(), columns, selection, selectionArgs, null, null, null); if (cursor == null) { return null; } else if (!cursor.moveToFirst()) { cursor.close(); return null; } return cursor; }
getWordMatches()
yöntemini çağırarak bir sorgu arayın. Eşleşen sonuçlar, yineleyebileceğiniz veya ListView
oluşturmak için kullanabileceğiniz bir Cursor
içinde döndürülür.
Bu örnek, aranabilir etkinliğin handleIntent()
yönteminde getWordMatches()
çağrısını verir. Daha önce oluşturduğunuz amaç filtresi nedeniyle, aranabilir etkinliğin ACTION_SEARCH
amacı içindeki sorguyu ek olarak aldığını unutmayın:
Kotlin
private val db = DatabaseTable(this) ... private fun handleIntent(intent: Intent) { if (Intent.ACTION_SEARCH == intent.action) { val query = intent.getStringExtra(SearchManager.QUERY) val c = db.getWordMatches(query, null) // process Cursor and display results } }
Java
DatabaseTable db = new DatabaseTable(this); ... private void handleIntent(Intent intent) { if (Intent.ACTION_SEARCH.equals(intent.getAction())) { String query = intent.getStringExtra(SearchManager.QUERY); Cursor c = db.getWordMatches(query, null); // process Cursor and display results } }