【Google官方教程】第四課：在UI中顯示Bitmap

轉載聲明：Ryan的博客文章歡迎您的轉載，但在轉載的同時，請註明文章的來源出處，不勝感激！ :-) 

http://my.oschina.net/ryanhoo/blog/88484

譯者：Ryan Hoo

來源：https://developer.android.com/develop/index.html

譯者按： 在Google最新的文檔中，提供了一系列含金量至關高的教程。由於種種緣由而不爲人知，真是惋惜！Ryan將會細心整理，將之翻譯成中文，但願對開發者有所幫助。

        本系列是Google關於展現大Bitmap（位圖）的官方演示，能夠有效的解決內存限制，更加有效的加載並顯示圖片，同時避免讓人頭疼的OOM（Out Of Memory）。

-------------------------------------------------------------------------------------

譯文：

        這節課將咱們前面幾節課學習的東西都整合起來，向你展現如何使用後臺線程和Bitmap緩存加載多個Bitmap(位圖)到ViewPager和GridView組件中，並學習如何處理併發和配置變化問題。

實現加載Bitmap到ViewPager

        滑動瀏覽模式(Swipe View Pattern)是一種很好的瀏覽詳細圖片的方式。你可使用ViewPager組件配合PagerAdapter(適配器)來實現這種模式。然而，更加合適的適配器是FragmentStatePagerAdapter，它能夠在ViewPager退出屏幕的時候自動銷燬並存儲Fragments的狀態，使得內存依然保留下來。

        注意：若是你只有少許的圖片，而且確信它們不會超出程序的內存限制，使用常規的PagerAdapter或者FragmentPagerAdapter或許更加合適。

        這裏有一個包含ImageView的ViewPager的實現類，Main Activity(主活動)持有這個ViewPager和Adapter。

public class ImageDetailActivity extends FragmentActivity {
    public static final String EXTRA_IMAGE = "extra_image";

    private ImagePagerAdapter mAdapter;
    private ViewPager mPager;

    // A static dataset to back the ViewPager adapter
    public final static Integer[] imageResIds = new Integer[] {
            R.drawable.sample_image_1, R.drawable.sample_image_2, R.drawable.sample_image_3,
            R.drawable.sample_image_4, R.drawable.sample_image_5, R.drawable.sample_image_6,
            R.drawable.sample_image_7, R.drawable.sample_image_8, R.drawable.sample_image_9};

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.image_detail_pager); // Contains just a ViewPager

        mAdapter = new ImagePagerAdapter(getSupportFragmentManager(), imageResIds.length);
        mPager = (ViewPager) findViewById(R.id.pager);
        mPager.setAdapter(mAdapter);
    }

    public static class ImagePagerAdapter extends FragmentStatePagerAdapter {
        private final int mSize;

        public ImagePagerAdapter(FragmentManager fm, int size) {
            super(fm);
            mSize = size;
        }

        @Override
        public int getCount() {
            return mSize;
        }

        @Override
        public Fragment getItem(int position) {
            return ImageDetailFragment.newInstance(position);
        }
    }
}

        這裏有一個用來持有ImageView並顯示詳細信息的Fragment的實現類。看起來這彷佛是很是合理的方法，可是你可否看到這個方案的缺點呢？應該如何改善它呢？

public class ImageDetailFragment extends Fragment {
    private static final String IMAGE_DATA_EXTRA = "resId";
    private int mImageNum;
    private ImageView mImageView;

    static ImageDetailFragment newInstance(int imageNum) {
        final ImageDetailFragment f = new ImageDetailFragment();
        final Bundle args = new Bundle();
        args.putInt(IMAGE_DATA_EXTRA, imageNum);
        f.setArguments(args);
        return f;
    }

    // Empty constructor, required as per Fragment docs
    public ImageDetailFragment() {}

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mImageNum = getArguments() != null ? getArguments().getInt(IMAGE_DATA_EXTRA) : -1;
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        // image_detail_fragment.xml contains just an ImageView
        final View v = inflater.inflate(R.layout.image_detail_fragment, container, false);
        mImageView = (ImageView) v.findViewById(R.id.imageView);
        return v;
    }

    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        final int resId = ImageDetailActivity.imageResIds[mImageNum];
        mImageView.setImageResource(resId); // Load image into ImageView
    }
}

        但願你能注意到：這些圖片是在UI線程從資源中讀取過來的，而這極有可能致使應用掛起甚至被強制關閉。使用在「非UI線程處理Bitmap」一課中提到的AsyncTask，直接將圖片加載和處理移到後臺線程中。

        任何額外的處理(例如調整大小或者從網絡獲取圖片)能夠放在BitmapWorkerTask中而不會影響到主UI線程的響應性。若是後臺線程作的不單單是直接從硬盤直接加載圖片，那麼如「緩存Bitmap」一課中說的，將圖片緩存到內存或者硬盤是有利於程序優化的。這裏是對內存緩存的一些額外修改：

public class ImageDetailActivity extends FragmentActivity {
    ...
    private LruCache<String, Bitmap> mMemoryCache;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        ...
        // initialize LruCache as per Use a Memory Cache section
    }

    public void loadBitmap(int resId, ImageView imageView) {
        final String imageKey = String.valueOf(resId);

        final Bitmap bitmap = mMemoryCache.get(imageKey);
        if (bitmap != null) {
            mImageView.setImageBitmap(bitmap);
        } else {
            mImageView.setImageResource(R.drawable.image_placeholder);
            BitmapWorkerTask task = new BitmapWorkerTask(mImageView);
            task.execute(resId);
        }
    }

    ... // include updated BitmapWorkerTask from Use a Memory Cache section
}

        將上面的代碼片斷整合在一塊兒會讓你的ViewPager具有優良的響應性能，能夠實現最小的加載延遲，根據你的圖片加載須要或多或少的進行後臺處理。

實現加載Bitmap到GridView

        網格列表控件(Grid List Building Block)對於顯示圖片數據集很是有用，也可使用GridView組件來實現，若是用戶上下滾動的話，有不少圖片處於就緒狀態，隨時能夠顯示在屏幕上。若是要實現這種類型的控制，你必須確保UI保持流暢性，內存使用處於控制之中並且併發也要被正確地處理(取決於GridView回收子視圖的方式)。

        首先，這裏有一個標準的GridView實現，將ImageView子控件存放在Fragment中。咱們再一次思考這個問題，這個方法看起來彷佛很是完美且合乎情理，可是有沒有辦法讓它便得更好呢？

public class ImageGridFragment extends Fragment implements AdapterView.OnItemClickListener {
    private ImageAdapter mAdapter;

    // A static dataset to back the GridView adapter
    public final static Integer[] imageResIds = new Integer[] {
            R.drawable.sample_image_1, R.drawable.sample_image_2, R.drawable.sample_image_3,
            R.drawable.sample_image_4, R.drawable.sample_image_5, R.drawable.sample_image_6,
            R.drawable.sample_image_7, R.drawable.sample_image_8, R.drawable.sample_image_9};

    // Empty constructor as per Fragment docs
    public ImageGridFragment() {}

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mAdapter = new ImageAdapter(getActivity());
    }

    @Override
    public View onCreateView(
            LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        final View v = inflater.inflate(R.layout.image_grid_fragment, container, false);
        final GridView mGridView = (GridView) v.findViewById(R.id.gridView);
        mGridView.setAdapter(mAdapter);
        mGridView.setOnItemClickListener(this);
        return v;
    }

    @Override
    public void onItemClick(AdapterView<?> parent, View v, int position, long id) {
        final Intent i = new Intent(getActivity(), ImageDetailActivity.class);
        i.putExtra(ImageDetailActivity.EXTRA_IMAGE, position);
        startActivity(i);
    }

    private class ImageAdapter extends BaseAdapter {
        private final Context mContext;

        public ImageAdapter(Context context) {
            super();
            mContext = context;
        }

        @Override
        public int getCount() {
            return imageResIds.length;
        }

        @Override
        public Object getItem(int position) {
            return imageResIds[position];
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @Override
        public View getView(int position, View convertView, ViewGroup container) {
            ImageView imageView;
            if (convertView == null) { // if it's not recycled, initialize some attributes
                imageView = new ImageView(mContext);
                imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
                imageView.setLayoutParams(new GridView.LayoutParams(
                        LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
            } else {
                imageView = (ImageView) convertView;
            }
            imageView.setImageResource(imageResIds[position]); // Load image into ImageView
            return imageView;
        }
    }
}

        固然，問題仍是這個方法在UI線程中處理圖片。這種方式或許是和處理小而簡單的圖片(系統資源的加載和緩存)，若是須要作任何的處理，UI就會被阻塞(甚至引發ANR(Application Not Responding))。

        和前一節相同的處理方式，咱們在異步線程中進行處理和緩存。然而，考慮到GridView回收子視圖的方式，你須要謹慎處理併發問題。可使用「在非UI線程中處理Bitmap」一課中提到的技巧。這裏是更新的解決方案：

public class ImageGridFragment extends Fragment implements AdapterView.OnItemClickListener {
    ...

    private class ImageAdapter extends BaseAdapter {
        ...

        @Override
        public View getView(int position, View convertView, ViewGroup container) {
            ...
            loadBitmap(imageResIds[position], imageView)
            return imageView;
        }
    }

    public void loadBitmap(int resId, ImageView imageView) {
        if (cancelPotentialWork(resId, imageView)) {
            final BitmapWorkerTask task = new BitmapWorkerTask(imageView);
            final AsyncDrawable asyncDrawable =
                    new AsyncDrawable(getResources(), mPlaceHolderBitmap, task);
            imageView.setImageDrawable(asyncDrawable);
            task.execute(resId);
        }
    }

    static class AsyncDrawable extends BitmapDrawable {
        private final WeakReference<BitmapWorkerTask> bitmapWorkerTaskReference;

        public AsyncDrawable(Resources res, Bitmap bitmap,
                BitmapWorkerTask bitmapWorkerTask) {
            super(res, bitmap);
            bitmapWorkerTaskReference =
                new WeakReference<BitmapWorkerTask>(bitmapWorkerTask);
        }

        public BitmapWorkerTask getBitmapWorkerTask() {
            return bitmapWorkerTaskReference.get();
        }
    }

    public static boolean cancelPotentialWork(int data, ImageView imageView) {
        final BitmapWorkerTask bitmapWorkerTask = getBitmapWorkerTask(imageView);

        if (bitmapWorkerTask != null) {
            final int bitmapData = bitmapWorkerTask.data;
            if (bitmapData != data) {
                // Cancel previous task
                bitmapWorkerTask.cancel(true);
            } else {
                // The same work is already in progress
                return false;
            }
        }
        // No task associated with the ImageView, or an existing task was cancelled
        return true;
    }

    private static BitmapWorkerTask getBitmapWorkerTask(ImageView imageView) {
       if (imageView != null) {
           final Drawable drawable = imageView.getDrawable();
           if (drawable instanceof AsyncDrawable) {
               final AsyncDrawable asyncDrawable = (AsyncDrawable) drawable;
               return asyncDrawable.getBitmapWorkerTask();
           }
        }
        return null;
    }

    ... // include updated BitmapWorkerTask class

        注意：相同的代碼也能夠很好的適配ListView。

        這裏的實現方法容許靈活地處理和加載圖片，而且不會影響UI的流暢性。在後臺線程中，你能夠從網絡加載圖片，調整大幅的數碼相機照片的大小，並在處理任務結束的時候將圖片顯示在UI界面中。

        要了解在本節課中討論到的概念和完整代碼，請參閱示例程序。

        BitmapFun:http://vdisk.weibo.com/s/hNgFB