Существует множество способов хранения ваших данных, например, в онлайн-базе данных, в локальной базе данных SQLite или даже в текстовом файле. Вам решать, какое решение будет лучшим для вашего приложения. В этом уроке показано, как создать виртуальную таблицу SQLite, которая может обеспечить надежный полнотекстовый поиск. Таблица заполняется данными из текстового файла, который содержит пару слов и определений в каждой строке файла.
Создайте виртуальную таблицу
Виртуальная таблица ведет себя аналогично таблице SQLite, но считывает и записывает объект в памяти посредством обратных вызовов, а не в файл базы данных. Чтобы создать виртуальную таблицу, создайте для нее класс:
Котлин
class DatabaseTable(context: Context) {
private val databaseOpenHelper = DatabaseOpenHelper(context)
}
Ява
public class DatabaseTable {
private final DatabaseOpenHelper databaseOpenHelper;
public DatabaseTable(Context context) {
databaseOpenHelper = new DatabaseOpenHelper(context);
}
}
Создайте внутренний класс в DatabaseTable , расширяющий SQLiteOpenHelper . Класс SQLiteOpenHelper определяет абстрактные методы, которые необходимо переопределить, чтобы при необходимости можно было создавать и обновлять таблицу базы данных. Например, вот код, который объявляет таблицу базы данных, содержащую слова для словарного приложения:
Котлин
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)
}
}
}
Ява
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);
}
}
}
Заполните виртуальную таблицу
Теперь таблице нужны данные для хранения. Следующий код показывает, как читать текстовый файл (расположенный в res/raw/definitions.txt ), содержащий слова и их определения, как анализировать этот файл и как вставлять каждую строку этого файла в качестве строки в виртуальный файл. стол. Все это делается в другом потоке, чтобы предотвратить блокировку пользовательского интерфейса. Добавьте следующий код во внутренний класс DatabaseOpenHelper .
Совет: Вы также можете настроить обратный вызов, чтобы уведомлять активность вашего пользовательского интерфейса о завершении этого потока.
Котлин
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)
}
Ява
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);
}
Вызовите метод loadDictionary() там, где это необходимо, чтобы заполнить таблицу. Хорошим местом будет метод onCreate() класса DatabaseOpenHelper сразу после создания таблицы:
Котлин
override fun onCreate(db: SQLiteDatabase) {
database = db
database.execSQL(FTS_TABLE_CREATE)
loadDictionary()
}
Ява
@Override
public void onCreate(SQLiteDatabase db) {
database = db;
database.execSQL(FTS_TABLE_CREATE);
loadDictionary();
}
Поиск запроса
Когда виртуальная таблица создана и заполнена, используйте запрос, предоставленный вашим SearchView , для поиска данных. Добавьте следующие методы в класс DatabaseTable , чтобы создать инструкцию SQL, выполняющую поиск по запросу:
Котлин
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
}
Ява
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() . Любые совпадающие результаты возвращаются в Cursor , по которому можно перебирать или использовать для создания ListView . В этом примере вызывается getWordMatches() в методе handleIntent() действия с возможностью поиска. Помните, что действие с возможностью поиска получает запрос внутри намерения ACTION_SEARCH в качестве дополнительного из-за ранее созданного фильтра намерений:
Котлин
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
}
}
Ява
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
}
}