#6 - Universal Image Loader. Часть 3 - Использование [RU+EN]

English version - "Universal Image Loader. Part 3 - Usage"

Предыдущие статьи:

• "Universal Image Loader. Часть 1 - Введение"
• "Universal Image Loader. Часть 2 - Конфигурация"

    В прошлой статье мы проинициализировали ImageLoader конфигурацией и теперь он готов к непосредственному использованию по назначению.
    Для этого он имеет 4 перегруженных метода:

void displayImage(String url, ImageView view)
void displayImage(String url, ImageView view, DisplayImageOptions options)
void displayImage(String url, ImageView view, ImageLoadingListener listener)
void displayImage(String url, ImageView view, DisplayImageOptions options, ImageLoadingListener listener)

    Первый вариант - все просто: говорим из какого URL-а загрузить картинку и в какой ImageView отобразить. Опции отображения (DisplayImageOptions) в этом случае будут взяты из конфигурации (defaultDisplayImageOptions(...)).
    Второй вариант: вот мы уже можем определить отдельные опции для конкретной задачи. Приведем сначала примерчик создания своих опций:

DisplayImageOptions options = new DisplayImageOptions.Builder()
    .showStubImage(R.drawable.stub_image)
    .showImageForEmptyUrl(R.drawable.image_for_empty_url)
    .resetViewBeforeLoading()
    .cacheInMemory()
    .cacheOnDisc()
    .decodingType(ImageScaleType.EXACT)
    .build();

    Да, опять Builder. Как говорилось в первой статье, с помощью DisplayImageOptions мы можем указать:

• надо ли отображать картинку-заглушку в ImageView, пока загружается реальная картинка, и какую именно заглушку отображать;
• надо ли отображать какую-либо картинку в ImageView, если URL картинки был передан пустым (null), и какую именно картинку отображать;  
• "обнулять" ли ImageView перед началом загрузки; 
• надо ли кэшировать загруженную картинку в памяти;
• надо ли кэшировать загруженную картинку на файловой системе.
• декодировать изображение максимально быстро (ImageScaleType.POWER_OF_2) или максимально экономно для оперативной памяти (ImageScaleType.EXACT).

    Так вот, мы можем передавать эти опции при каждом вызове метода displayImage(), а можем указать дефолтные в конфигурации для инициализации, и они будут использоваться во всех случаях, когда опции не были явно переданы при вызове метода.
    Третий вариант: в дополнение ко всему вы можете "прослушивать" процесс загрузки и отображения картинки с помощью интерфейса ImageLoadingListener:

public interface ImageLoadingListener {
    void onLoadingStarted();
    void onLoadingFailed();
    void onLoadingComplete();
    void onLoadingCancelled();
}

    Ну а четвертый вариант - самый мощный: можете и опции определить, и "слушать" процесс.

    Советы и рекомендации

1. Для того, чтобы ImageLoader смог выполнить свое предназначение, ему необходимо передать корректные параметры. И речь не столько о URL картинки, сколько об ImageView. Если вы создаете объект ImageView в коде (а не с помощью LayoutInflater), то в передавайте конструктор текущий Activity, а не контекст приложения:

ImageView imageView = new ImageView(getApplicationContext()); // НЕ ПРАВИЛЬНО!

ImageView imageView = new ImageView(MyActivity.this); // правильно
ImageView imageView = new ImageView(getActivity()); // правильно (для Fragment'ов)

2. Параметры maxImageWidthForMemoryCache(...) и maxImageHeightForMemoryCache(...) стоит настраивать в конфигурации только если вы хотите загружать в ImageView картинки размера, превышающего размеры экрана устройства (например для последующего увеличения). Во всех остальных случаях этого делать не нужно: эти параметры по умолчанию учитывают размеры экрана, что позволяет экономить память при работе с Bitmap'ами.
3. Устанавливайте размер пула потоков в конфигурации с умом: большой размер пула (> 10) позволит работать множеству потоков одновременно, что может сильно сказаться на отзывчивости UI. Но это можно поправить установкой более низкого приоритета для потоков: чем ниже приоритет, тем отзывчивей UI во время работы ImageLoader'а, но тем долльше грузятся картинки. Отзывчивость UI крайне важна для списков (плавная прокрутка), поэтому стоит поиграться с натройкой параметров threadPoolSize(...) и threadPriority(...) для подбора оптимальной конфигурации для вашего приложения.
4. Настройки memoryCacheSize(...) и memoryCache(...) перекрывают друг друга, используйте только одну из них для одного объекта конфигурации.
5. Настройки discCacheSize(...), discCacheFileCount(...) и discCache(...) перекрывают друг друга, используйте только одну из них для одного объекта конфигурации. 
6. Если при использовании ImageLoader'а в приложении вы всегда (или почти всегда) передаете в метод displayImage(...) одни и те же опции загрузки (DisplayImageOptions), то тогда разумным решением будет задать данные опции в конфигурации ImageLoader в качестве опций по умолчанию (метод defaultDisplayImageOptions(...)). Тогда данные опции не обязательно будет каждый раз указывать при вызове displayImage(...), т.к. если в метод явно не переданы опции, то для данной задачи будут использоваться дефолтные опции.
7. Большой разницы в скорости между типами декодирования POWER_OF_2 и EXACT нет, но рекомендуется использовать POWER_OF_2 для разного рода списков (где нужно отображать много картинок небольшого размера), а  EXACT для галерей (когда нужно отображать картинки в больших размерах).

    На этом, пожалуй, Я завершу свой затянувшийся рассказ об Universal Image Loader'е.
    Иходники проекта по прежнему доступны на GitHub.