Android для начинающих: Общие сведения об адаптерах и видах-адаптерах

() translation by (you can also view the original English article)

Виды адаптеров настолько повсеместны, что вам нелегко найти популярное приложение для Android, которое их не использует. Название может показаться незнакомым, но если вы думаете, что никогда не видели адаптер, вы, вероятно, ошибаетесь. Каждый раз, когда вы видите элементы интерфейса Android, отображающие элементы пользовательского интерфейса в виде списка, сетки или стека, вы видите представление адаптера в действии.

Представление адаптера, как следует из его названия, является объектом View. Это означает, что вы можете добавить его в свои действия так же, как вы добавляете любой другой виджет пользовательского интерфейса. Однако он не может отображать данные самостоятельно. Его содержимое всегда определяется другим объектом, адаптером. В этом уроке я покажу вам, как создавать адаптеры и использовать их для подачи различных видов адаптеров, таких как ListView и GridView.

Вам легче учиться с видео? Почему бы не проверить наш курс:

Android

Начало работы с Android

Пол Требилкокс-Руис

1. Что такое адаптер?

Адаптер - это объект класса, который реализует интерфейс Adapter. Он действует как связь между набором данных и видом адаптера, объектом класса, который расширяет абстрактный класс AdapterView. Набор данных может быть любым, что представляет данные структурированным образом. Массивы, объекты List и объекты Cursor являются обычно используемыми наборами данных.

Адаптер отвечает за извлечение данных из набора данных и за создание объектов View на основе этих данных. Сгенерированные объекты View затем используются для заполнения любого вида адаптера, привязанного к адаптеру.

Вы можете создавать собственные классы адаптеров с нуля, но большинство разработчиков предпочитают использовать или расширять классы адаптеров, предоставляемые Android SDK, такие как ArrayAdapter и SimpleCursorAdapter. В этом уроке мы сосредоточимся на классе ArrayAdapter.

2. Как работают представления адаптера?

Представления адаптеров могут очень эффективно отображать большие наборы данных. Например, виджеты ListView и GridView могут отображать миллионы элементов без какого-либо заметного запаздывания, при этом память и загрузка процессора очень низки. Как они это делают? Различные виды адаптеров следуют различным стратегиям. Однако, вот что большинство из них обычно делает.

Они отображают только те объекты View, которые либо уже присутствуют на экране, либо собираются перемещаться по экрану. Таким образом, память, потребляемая представлением адаптера, может быть постоянной и независимой от размера набора данных.
Они также позволяют разработчикам свести к минимуму дорогостоящие операции раздувания макетов и перерабатывать существующие объекты View, которые перемещаются за пределы экрана. Это снижает потребление процессора.

3. Создание `ArrayAdapter`

Чтобы создать адаптер, вам необходимо следующее:

набор данных
файл ресурсов, содержащий макет сгенерированных объектов View

Кроме того, поскольку класс ArrayAdapter может работать только со строками, вам нужно убедиться, что макет сгенерированных объектов View содержит хотя бы один виджет TextView.

Шаг 1. Создание набора данных

Класс ArrayAdapter может использовать как массивы, так и объекты List в качестве наборов данных. Пока давайте будем использовать массив в качестве набора данных.

String[] cheeses = {
            "Parmesan",
            "Ricotta",
            "Fontina",
            "Mozzarella",
            "Cheddar"
          };

Шаг 2. Создание файла ресурсов

Создайте новый XML-файл макета, корневым элементом которого является LinearLayout и назовите его item.xml. Перетащите в него Large text виджет и установите значение его атрибута id в cheese_name. XML-файл макета должен выглядеть так:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="@dimen/activity_horizontal_margin">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Large Text"
        android:id="@+id/cheese_name" />
</LinearLayout>

Шаг 3: Создайте адаптер

В своей деятельности создайте новый экземпляр класса ArrayAdapter, используя его конструктор. В качестве аргументов передайте имя файла ресурсов, идентификатор TextView и ссылку на массив. Теперь адаптер готов.

ArrayAdapter<String> cheeseAdapter = 
    new ArrayAdapter<String>(this,
        R.layout.item,
        R.id.cheese_name,
        cheeses
    );

4. Создание списка

Чтобы отобразить вертикально прокручиваемый список элементов, вы можете использовать виджет ListView. Чтобы добавить виджет в свою деятельность, вы можете перетащить его в файл XML макета или создать его с помощью своего конструктора в вашем Java-коде. А пока давайте сделаем последнее.

1	ListView cheeseList = new ListView(this);

Как правило, никакие другие виджеты пользовательского интерфейса не помещаются внутри макета, содержащего ListView. Поэтому передайте ListView методу setContentView() вашей деятельности, чтобы он занимал весь экран.

1	setContentView(cheeseList);

Чтобы связать ListView с адаптером, созданным нами на предыдущем шаге, вызовите метод setAdapter(), как показано ниже.

1	cheeseList.setAdapter(cheeseAdapter);

Если вы сейчас запустите свое приложение, вы сможете увидеть содержимое массива в виде списка.

5. Создание сетки

Чтобы отобразить вертикально прокручиваемую двумерную сетку элементов, вы можете использовать виджет GridView. И ListView, и GridView являются подклассами абстрактного класса AbsListView, и они имеют много общего. Поэтому, если вы знаете, как использовать его, вы также знаете, как использовать другие.

Используйте конструктор класса GridView для создания нового экземпляра и передайте его методу setContentView() вашей активности.

1	GridView cheeseGrid = new GridView(this);
2	setContentView(cheeseGrid);

Чтобы установить количество столбцов в сетке, вызовите его метод setNumColumns(). Я собираюсь сделать это двухколоночной сеткой.

1	cheeseGrid.setNumColumns(2);

Обычно вы хотите настроить ширину столбцов и расстояние между ними, используя методы setColumnWidth(), setVerticalSpacing() и setHorizontalSpacing(). Обратите внимание, что эти методы используют пиксели в качестве единиц.

1	cheeseGrid.setColumnWidth(60);
2	cheeseGrid.setVerticalSpacing(20);
3	cheeseGrid.setHorizontalSpacing(20);

Теперь вы можете привязать GridView к адаптеру, который мы создали ранее, с помощью метода setAdapter().

1	cheeseGrid.setAdapter(cheeseAdapter);

Запустите приложение еще раз, чтобы посмотреть, как выглядит GridView.

6. Добавление слушателей событий

Возможно прослушивание событий щелчка и длинных кликов на элементах внутри вида адаптера. В качестве примера добавим прослушиватель событий щелчка в GridView.

Создайте новый экземпляр анонимного класса, который реализует интерфейс AdapterView.OnItemClickListener и передает его методу setOnItemClickListener() объекта GridView. Android Studio автоматически создает заглушку для метода onItemClick() интерфейса. Вы заметите, что параметры метода включают целое число, определяющее позицию элемента списка. Вы можете использовать это целое число, чтобы узнать, какой элемент в наборе данных пользователь нажал.

Следующий код иллюстрирует, как отображать простое сообщение в качестве закутки каждый раз, когда элемент в GridView будет нажат.

cheeseGrid.setOnItemClickListener(new AdapterView.OnItemClickListener() {
    @Override
    public void onItemClick(AdapterView<?> adapterView,
                            View view, int position, long rowId) {

        // Generate a message based on the position
        String message = "You clicked on " + cheeses[position];

        // Use the message to create a Snackbar
        Snackbar.make(adapterView, message, Snackbar.LENGTH_LONG)
                .show(); // Show the Snackbar
    }
});

Если вы запустите приложение и щелкните любой элемент в сетке, в нижней части экрана появится сообщение. Обратите внимание, что вы можете использовать один и тот же код для прослушивания событий щелчка по элементам внутри ListView.

7. Расширение `ArrayAdapter`

ArrayAdapter может обрабатывать только один виджет TextView внутри макета создаваемых им объектов View. Чтобы расширить свои возможности, вы должны расширить его. Однако прежде чем мы это сделаем, давайте создадим несколько более сложный набор данных.

Вместо строк, скажем, наш набор данных содержит объекты следующего класса:

static class Cheese {
    String name;
    String description;

    public Cheese(String name, String description) {
        this.name = name;
        this.description = description;
    }
}

Это набор данных, который мы будем использовать:

Cheese[] cheeses = {
        new Cheese("Parmesan", "Hard, granular cheese"),
        new Cheese("Ricotta", "Italian whey cheese"),
        new Cheese("Fontina", "Italian cow's milk cheese"),
        new Cheese("Mozzarella", "Southern Italian buffalo milk cheese"),
        new Cheese("Cheddar", "Firm, cow's milk cheese"),
};

Как вы можете видеть, класс Cheese содержит два поля, name и description. Чтобы отображать оба поля в списках или сетках, макет элементов должен содержать два виджета TextView.

Создайте новый XML-файл макета и назовите его custom_item.xml. Добавьте в него виджеты Large text и Small text. Установите атрибут id первого виджета на имя cheese_name, а второй - на cheese_description. Содержимое XML-файла макета должно выглядеть следующим образом:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="@dimen/activity_horizontal_margin">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Large Text"
        android:id="@+id/cheese_name" />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceSmall"
        android:text="Small Text"
        android:id="@+id/cheese_description" />
</LinearLayout>

ArrayAdapter также должен иметь возможность обрабатывать два виджета TextView. Измените свою деятельность, создайте новый анонимный класс, который расширяет класс ArrayAdapter и переопределяет его метод getView(). Убедитесь, что вы передаете массив как аргумент его конструктору.

ArrayAdapter<Cheese> cheeseAdapter = 
        new ArrayAdapter<Cheese>(this, 0, cheeses) {
            @Override
            public View getView(int position,
                                View convertView,
                                ViewGroup parent) {

            }
        };

Внутри метода getView() вы должны использовать параметр position в качестве индекса массива и выбрать элемент в этом индексе.

1	Cheese currentCheese = cheeses[position];

Второй параметр метода getView() - это то, что позволяет нам повторно использовать объекты View. Если вы проигнорируете это, производительность вашего адаптера будет плохой. Когда метод getView() вызывается в первый раз, convertView имеет значение null. Вы должны инициализировать его, изменяя файл ресурсов, который определяет макет элементов списка. Для этого обратитесь к макету LayoutInflater с помощью метода getLayoutInflater() и вызовите его метод inflate().

// Inflate only once
if(convertView == null) {
    convertView = getLayoutInflater()
                    .inflate(R.layout.custom_item, null, false);
}

На этом этапе вы можете использовать findViewById(), чтобы получить ссылку на виджеты TextView внутри макета и вызвать их методы setText() для их инициализации с использованием данных из массива.

TextView cheeseName = 
    (TextView)convertView.findViewById(R.id.cheese_name);
TextView cheeseDescription = 
    (TextView)convertView.findViewById(R.id.cheese_description);

cheeseName.setText(currentCheese.name);
cheeseDescription.setText(currentCheese.description);

Наконец, верните convertView, чтобы он мог использоваться для заполнения любого вида адаптера, связанного с адаптером.

1	return convertView;

8. Использование держателя вида

Метод getView() многократно вызывается видом адаптера для заполнения. Поэтому вы должны попытаться свести к минимуму количество операций, которые вы в нем выполняете.

На предыдущем шаге вы могли заметить, что, хотя мы убедились, что макет элементов списка заполняется только один раз, метод findViewById(), который потребляет много циклов процессора, вызывается каждый раз, когда метод вызывается getView().

Чтобы избежать этого и улучшить производительность представления адаптера, нам нужно сохранить результаты метода findViewById() внутри объекта convertView. Для этого мы можем использовать объект view holder, который представляет собой не что иное, как объект класса, который может хранить виджеты, присутствующие в макете.

Поскольку в макете есть два виджета TextView, класс владельца представления должен также иметь два виджета TextView. Я назвал класс ViewHolder.

1	static class ViewHolder{
2	TextView cheeseName;
3	TextView cheeseDescription;
4	}

В методе getView() после раздувания макета вы можете теперь инициализировать объект держателя вида с помощью метода findViewById().

ViewHolder viewHolder = new ViewHolder();
viewHolder.cheeseName =
        (TextView)convertView.findViewById(R.id.cheese_name);
viewHolder.cheeseDescription =
        (TextView)convertView.findViewById(R.id.cheese_description);

Чтобы сохранить объект-держатель вида в convertView, используйте его метод setTag().

1	// Store results of findViewById
2	convertView.setTag(viewHolder);

И теперь, каждый раз, когда вызывается getView(), вы можете получить объект держателя вида из convertView с помощью метода getTag() и обновить виджеты TextView внутри него, используя их методы setText().

TextView cheeseName = 
    ((ViewHolder)convertView.getTag()).cheeseName;
TextView cheeseDescription = 
    ((ViewHolder)convertView.getTag()).cheeseDescription;
    
cheeseName.setText(currentCheese.name);
cheeseDescription.setText(currentCheese.description);

Если вы запустите приложение сейчас, вы увидите, что GridView отображает две строки текста в каждой ячейке.

GridView with two lines of text per item

Заключение

В этом уроке вы узнали, как создать адаптер и использовать его для заполнения различных видов адаптеров. Вы также узнали, как создать свой собственный адаптер. Хотя мы ориентируемся только на классы ArrayAdapter, ListView и GridView, вы можете использовать те же методы для других адаптеров и адаптеров, которые предлагает Android SDK.

Android Support Library включает в себя класс RecyclerView. Он очень похож на вид адаптера, но не является подклассом класса AdapterView. Вы должны использовать его, если хотите создать более сложные списки, особенно те, которые используют несколько файлов макета для своих элементов. Чтобы узнать больше об этом, вы можете обратиться к этому учебнику Envato Tuts +.

Чтобы узнать больше о классе AdapterView и его подклассах, вы можете обратиться к его документации.