Cursor
Изучим объект Cursor. Не путайте его с курсором мыши, который бегает у вас на экране.
Работа с курсором
- Курсор — это набор строк в табличном виде
- Для доступа курсора вы должны использовать метод moveToFirst(), так как курсор размещается перед первой строкой
- Вы должны знать названия столбцов
- Вы должны знать типы столбцов
- Все методы доступа к массивам основываются на номере столбца, поэтому сначала нужно преобразовать название столбца в номер столбца
- Курсор является случайным (random cursor) — вы можете переходить вперед, назад и со строки на строку
- Поскольку курсор является случайным, у него можно запрашивать количество строк (row count)
Класс Cursor содержит немало возможностей для навигации (но не ограничивается только ими):
- moveToFirst() — перемещает курсор на первую строку в результате запроса;
- moveToNext() — перемещает курсор на следующую строку;
- moveToLast() — перемещает курсор на последнюю строку;
- moveToPrevious() — перемещает курсор на предыдущую строку;
- getCount() — возвращает количество строк в результирующем наборе данных;
- getColumnIndexOrThrow() — возвращает индекс для столбца с указанным именем (выбрасывает исключение, если столбец с таким именем не существует);
- getColumnName() — возвращает имя столбца с указанным индексом;
- getColumnNames() — возвращает массив строк, содержащий имена всех столбцов в объекте Cursor;
- moveToPosition() — перемещает курсор на указанную строку;
- getPosition() — возвращает текущую позицию курсора
Также Android предоставляет следующие методы:
- isBeforeFirst()
- isAfterLast() — полезный метод, сигнализирующий о достижении конца запроса. Используется в циклах
- isClosed()
И другие методы, о которых можно узнать в документации или из примеров.
Курсор обязательно следует закрывать методом close() для освобождения памяти.
Наглядно о курсорах
Чтобы было проще понять, что такое курсоры, представляйте их в виде таблицы. Пусть у нас есть таблица из столбцов: _id (идентификатор) и catname (имя котов). Допустим, мы ввели в базу имена четырех котов и таблица базы данных выглядит таким образом:
_id | catname |
---|---|
1 | Мурзик |
2 | Васька |
3 | Барсик |
4 | Рыжик |
Как было сказано выше, при работе с курсорами необходимо вызвать метод moveToFirst() (перейти к первой строке), после чего таблица будет выглядеть следующим образом:
_id | catname |
---|---|
1 | Мурзик |
2 | Васька |
3 | Барсик |
4 | Рыжик |
Как видите, после вызова метода первая строчка таблицы подсвечена. Именно данные этой строки и содержит сейчас курсор. Можно проверить следующим образом. Добавим новую кнопку в проект и напишем код:
На первой строке содержатся данные 1, Мурзик. Мы не знаем, как хранятся данные в курсоре, но нам это и не нужно. С помощью метода getColumnIndex() с указанием имени колонки мы можем извлечь данные, которые хранятся в них.
Теперь вызовем метод moveToNext() (перейти к следующей строке). Таблица будет выглядеть уже так:
_id | catname |
---|---|
1 | Мурзик |
2 | Васька |
3 | Барсик |
4 | Рыжик |
Код для проверки:
Если вызвать метод moveToNext() ещё раз, то переместимся на третью позицию. А теперь представьте ситуацию, что у нас в базе более ста котов, и чтобы узнать имя 85-го кота, нам придётся 85 раз вызывать метод. Не удобно. К счастью, есть метод moveToPosition() (перейти в позицию), в котором сразу можно указать нужную строку (отсчет идет от 0):
А таблица выглядит уже так:
_id | catname |
---|---|
1 | Мурзик |
2 | Васька |
3 | Барсик |
4 | Рыжик |
Надеюсь, вы поняли общий принцип работы с курсором. Теперь вы можете понять, как выглядит курсор после вызова метода moveToLast() (перейти на последнюю запись).
Если нам надо получить имена всех котов из таблицы базы данных, то нужно последовательно вызывать методы moveToNext(). Это проще сделать через цикл. Условием для остановки цикла является проверка возвращаемого значения метода. Если вернётся значение false, значит мы дошли до конца таблицы. В данном случае не нужно вызывать метод moveToFirst(), чтобы не пропустить первую запись:
Цикл можно переписать по другому. Метод isAfterLast() возвращает true, когда курсор с последней записи пытается переместиться в никуда. А пока курсор возвращает false, можно двигать его на следующую позицию. Пример будет выглядеть так:
В примерах мы извлекали строковое значение записи через метод getString():
По аналогии можно получить числовое значение, например, номер ресурса изображения.
Думаю, приведённых примеров достаточно, чтобы понять с чем едят курсоры. Они совсем не страшные.
Устаревшие методы (deprecated)
Начиная с Android 3.0, многие методы для работы с курсором считаются устаревшими.
- startManagingCursor()
- stopManagingCursor()
- managedQuery()
- reQuery()
При использовании устаревших методов вы можете получить исключение типа:
Кроме того, студия будет подчёркивать устаревшие методы, от которых желательно избавляться в новых проектах.
Наиболее распространён метод managedQuery(), в сети постоянно натыкаюсь на примеры с использованием данного метода.
Обычно, код выглядит следующим образом:
Данный код следует переработать следующим образом:
Метод reQuery() следует заменить на вызов LoaderManager.
Класс CursorLoader и связанный с ним LoaderManager гарантируют, что запросы будут выполняться асинхронно.
Мне пока не приходилось использовать данный приём в своей практике, поэтому просто скопирую из других источников:
- реализуйте интерфейс в вашем классе как LoaderManager.LoaderCallbacks
- в методе onCreate() инициализируйте loader как First implement the interface in your class as getLoaderManager().initLoader(0, null, this);
- вместо reQuery используйте getLoaderManager().restartLoader(0, null, this);
- переопределите три метода onCreateLoader(), onLoadFinished(), onLoaderReset()
MatrixCursor
Иногда попадаются примеры с использованием класса MatrixCursor. Сам пока не изучал, оставлю вам в качестве домашнего задания. Небольшой пример на память:
Источник
Полный список
— используем SimpleCursorAdapter для построения списка
— добавляем и удаляем записи в списке
Важное замечание! Урок более не актуален, т.к. в нем используются методы, которые гугл объявил устаревшими. Если вы просто зашли посмотреть, как использовать SimpleCursorAdapter, то вместо этого урока рекомендую прочитать Урок 136. Если же вы идете последовательно по урокам, то вполне можно прочесть и понять этот урок, а потом просто акутализируете свои знания в Уроке 136.
После нескольких уроков посвященных SimpleAdapter мы знаем про него достаточно и представляем схему его работы. И теперь нам будет нетрудно усвоить SimpleCursorAdapter. Он отличается тем, что в качестве данных используется не коллекция Map, а Cursor с данными из БД. И в массиве from, соответственно, мы указываем не ключи Map-атрибутов, а наименования полей (столбца) курсора. Значения из этих полей будут сопоставлены указанным View-компонентам из массива to.
Также немного отличается от SimpleAdapter стандартный биндинг и внешний ViewBinder. SimpleCursorAdapter умеет работать с TextView и ImageView компонентами и их производными, а Checkable-производные не воспримет . А при использовании ViewBinder, необходимо реализовать его метод boolean setViewValue (View view, Cursor cursor, int columnIndex). На вход он принимает View-компонент для биндинга, cursor с данными и номер столбца, из которого надо взять данные. Позиция курсора уже установлена в соответствии с позицией пункта списка. Не буду снова расписывать примеры использования, т.к. они будут очень похожи на примеры из предыдущих уроков по SimpleAdapter. Если там все было понятно, то и здесь проблем не должно возникнуть.
Итак, давайте накидаем пример использования SimpleCursorAdapter. Список будет отображать картинку и текст. Также реализуем возможность добавления и удаления данных из списка. Добавлять будем кнопкой, а удалять с помощью контекстного меню.
Project name: P0521_SimpleCursorAdapter
Build Target: Android 2.3.3
Application name: SimpleCursorAdapter
Package name: ru.startandroid.develop.p0521simplecursoradapter
Create Activity: MainActivity
Обычно в уроках я тексты для кнопок и прочего указывал напрямую. Делал я это не со зла, а чтобы не перегружать урок лишней информацией. Но с последними обновлениями Eclipse стал ругаться примерно так: [I18N] Hardcoded string «какой-то текст», should use @string resource. Ошибка не критична и запуску приложения никак не помешает, но некоторых она смущает. Да и действительно, хардкод – это плохо. С этого урока постараюсь следовать правилам хорошего тона и использовать файлы ресурсов. На нашем текущем уровне знаний это не должно стать помехой в понимании и усвоении уроков.
Тут кроме названия приложения я записал тексты для кнопки и контекстного меню
Кнопка для добавления записи и список.
Layout для пункта списка item.xml:
Картинка и текст.
Т.к. SimpleCursorAdapter – это адаптер для работы с данными из БД, то нам нужно эту БД организовать. Чтобы не загромождать MainActivity.java, я вынесу код по работе с БД в отдельный класс DB. Создаем класс DB.java в том же пакете, где и MainActivity.java
Здесь все нам знакомо по прошлым урокам SQLite.
Мы создаем несколько public методов, чтобы Activity могла через них работать с данными:
open – установить соединение
close – закрыть соединение
getAllData – получить курсор со всеми данными из таблицы
addRec – добавить запись
delRec – удалить запись
Это методы-оболочки для работы с БД, которые предоставят MainActivity только те возможности, какие ей нужны.
Вложенный класс DBHelper – для создания и управления БД. В методе onCreate мы создаем таблицу и заполняем ее сгенерированными данными. Метод onUpgrade я оставил пустым, т.к. в этом примере не планирую обновлять версию БД.
Хорошо, что мы создали DB.java. Благодаря ему в MainActivity.java все красиво, прозрачно и удобно. Смотрим код.
В onCreate мы организуем подключение к БД, получаем курсор и просим Activity присмотреть за ним. Теперь при смене Lifecycle-состояний Activity, оно будет менять соответствующим образом состояния курсора. Затем настраиваем биндинг – формируем массивы, которые укажут адаптеру, как сопоставлять данные из курсора и View-компоненты. В R.id.ivImg пойдет значение из поля img, а в R.id.tvText – значение из поля txt. Имена полей мы здесь указываем public-константами класса DB. Далее мы создаем адаптер и настраиваем список на его использование. В конце добавляем контекстное меню к списку.
В методе onButtonClick мы генерируем и добавляем запись в БД и обновляем курсор методом requery, чтобы получить свежие данные из БД.
При создании контекстного меню, в методе onCreateContextMenu, мы добавляем пункт для удаления.
В методе onContextItemSelected мы обрабатываем нажатие пункта контекстного меню. Чтобы получить данные по пункту списка, для которого был совершен вызов контекстного меню, мы используем метод getMenuInfo. Объект AdapterContextMenuInfo содержит данные о View, id и позиции пункта списка. Нам нужно id. Этот id равен значению поля _id для соответствующей записи в курсоре. Мы вызываем метод удаления записи и обновляем курсор.
В методе onDestroy мы закрываем подключение к БД. Это будет происходить при закрытии Activity.
Все сохраняем и запускаем.
Нажав на кнопку, мы добавляем запись. А вызвав контекстное меню (долгое нажатие) для пункта списка можно его удалить.
Мы рассмотрели возможность добавления и удаления записей в списке при использовании SimpleCursorAdapter. Возможность редактирования я рассматривать не стал. Это не особо усложнило бы урок, но сделало бы его больше и размыло бы тему. А я стараюсь делать уроки максимально заточенными под конкретную тему. Для тех, кому интересно редактирование – гугл любезно создал такой пример на официальном сайте — http://developer.android.com/resources/tutorials/notepad/index.html. Мой пример похож на него, так что будет проще разобраться.
Кстати, в этом уроке мы встретили список, в котором id пункта может не совпадать с позицией. Для теста попробуйте повесить обработку нажатия на пункт списка и посмотреть, что позиция – это будет позиция пункта в списке, а id – это идентификатор записи из БД (поле _id). Чтобы это работало, необходимо поле-идентификатор в таблице называть _id, т.к. курсор будет использовать его, как id. Иначе получим ошибку.
На следующем уроке:
— используем SimpleCursorTreeAdapter для построения списка
Присоединяйтесь к нам в Telegram:
— в канале StartAndroid публикуются ссылки на новые статьи с сайта startandroid.ru и интересные материалы с хабра, medium.com и т.п.
— в чатах решаем возникающие вопросы и проблемы по различным темам: Android, Kotlin, RxJava, Dagger, Тестирование
— ну и если просто хочется поговорить с коллегами по разработке, то есть чат Флудильня
— новый чат Performance для обсуждения проблем производительности и для ваших пожеланий по содержанию курса по этой теме
Источник
Какое использование курсора в разработке под Android?
Я просматривал некоторые коды в Интернете, касающиеся подключения к базе данных, поиска. Я видел Cursor cur1= moveToFirst() во многих кодах, я хотел знать, как используется курсор и почему мы используем moveToFirst() , поскольку я новичок в Android.
7 ответов
Курсор — это интерфейс, который представляет собой двухмерную таблицу любой базы данных. Когда вы пытаетесь получить некоторые данные с помощью оператора SELECT , база данных сначала создает объект CURSOR и возвращает вам ссылку на него.
Указатель этой возвращенной ссылки указывает на 0-е место , которое иначе называется перед первым положением Курсора , поэтому, когда вы хотите извлекать данные из курсора, вам нужно сначала перейти к первой записи, поэтому мы должны использовать moveToFirst
Когда вы вызываете метод moveToFirst () для Курсора , он переводит указатель курсора в первое место . Теперь вы можете получить доступ к данным, содержащимся в первой записи .
Интерфейс курсора обеспечивает произвольный доступ для чтения и записи к набору результатов, возвращаемому запросом к базе данных.
Реализации курсора не требуется синхронизировать, поэтому код, использующий Cursor из нескольких потоков, должен выполнять свою собственную синхронизацию при использовании Cursor.
Используйте интерфейс Курсор для сбора данных.
Он похож на Cursor в PL/SQL тем, что содержит одну или несколько строк, возвращаемых некоторыми запросами с указателем.
В интерфейсе Cursor доступны следующие методы, которые проходят через Cursor , устанавливая Cursor pointer в желаемое положение:
- moveToFirst ()
- moveToLast ()
- moveToNext ()
- moveToPrevious ()
- moveToPosition (позиция)
Курсор — это то, в чем будет храниться любой результат SQL-запроса.
Курсор похож на ResultSet в java, у него есть строки, возвращаемые некоторыми запросами с его указателем. moveToFirst() , moveToNext() и moveToPosition(position) устанавливают указатель на желаемую позицию.
Курсор представляет результат запроса и в основном указывает на одну строку результата запроса. Таким образом, Android может эффективно буферизовать результаты запроса; поскольку он не должен загружать все данные в память.
Чтобы получить количество элементов результирующего запроса, используйте метод getCount() .
Для перемещения между отдельными строками данных вы можете использовать методы moveToFirst() и moveToNext() . Метод isAfterLast() позволяет проверить, достигнут ли конец результата запроса.
Курсор предоставляет типизированные методы get * (), например getLong(columnIndex) , getString(columnIndex) для доступа к данным столбца для текущей позиции результата. «ColumnIndex» — это номер столбца, к которому вы обращаетесь.
Курсор также предоставляет метод getColumnIndexOrThrow(String) , который позволяет получить индекс столбца для имени столбца таблицы.
Курсор необходимо закрыть с помощью вызова метода close() . Запрос возвращает объект Cursor.
Проще говоря, Cursor — это интерфейс, который возвращает сбор данных вашего запроса. moveToFirst() используется для указания позиции курсора, откуда вы хотите получать данные от курсора. Существуют методы moveToLast() , moveToNext() , moveToPrevious() , moveToPosition(position) , с помощью которых вы можете перемещаться по курсору желаемым образом.
Например, у вас есть данные в вашем курсоре
moveToFirst() — Если вы используете cursor.moveToFirst() , то в этом случае он будет указывать на Lalit, так как это первые данные в вашем курсоре. Получить следующие данные от курсора вы можете использовать moveToNext() .
moveToLast() — это укажет Чандру как текущие данные в вашем курсор. Чтобы получить предыдущие данные от курсора, вы можете использовать moveToPrevious()
Источник