android-smart-image-view源码分析

2401_84537603

于 2024-04-29 06:28:00 发布

阅读量456

点赞数 29

分类专栏：程序员文章标签： android

本文链接：https://blog.csdn.net/2401_84537603/article/details/138299285

版权

程序员专栏收录该内容

215 篇文章 0 订阅

订阅专栏

/**

使用Handler刷新UI

private Handler mHandler = new Handler(){

public void handleMessage(android.os.Message msg) {

Bitmap bitmap = (Bitmap) msg.obj;//获取到Bitmap对象

SmartImageView.this.setImageBitmap(bitmap);//setImageBitmap

};

/**

设置图片的网络路径，加载一个网络的图片
@param path

public void setImageUrl(final String path){

new Thread(){

public void run() {

try {

//创建链接对象

URL url = new URL(path);

HttpURLConnection conn = (HttpURLConnection) url.openConnection();

//设置请求方式

conn.setRequestMethod(“GET”);

//设置Timeout

conn.setConnectTimeout(5000);

int code = conn.getResponseCode();

//返回码为200时

if(code == 200){

//读取服务端返回的数据流

InputStream is = conn.getInputStream();

//将该图片数据流转化成位图

Bitmap bitmap = BitmapFactory.decodeStream(is);

//Handler发送消息给主线程,更新UI

Message msg = Message.obtain();

msg.obj = bitmap;

mHandler.sendMessage(msg);

}

} catch (Exception e) {

e.printStackTrace();

}

};

}.start();

}

布局文件中引入我们定义的控件：

<RelativeLayout xmlns:android=“http://schemas.android.com/apk/res/android”

xmlns:tools=“http://schemas.android.com/tools”

android:layout_width=“match_parent”

android:layout_height=“match_parent”>

<Button

android:id=“@+id/btn”

android:layout_width=“match_parent”

android:layout_height=“wrap_content”

android:onClick=“onClick”

android:text=“获取网络图片” />

<com.example.smartimageview.SmartImageView

android:id=“@+id/iv_coco”

android:layout_width=“wrap_content”

android:layout_height=“wrap_content”

android:layout_below=“@+id/btn”

android:scaleType=“fitXY” />

主Activity中使用我们刚刚定义的控件：

package com.example.smartimageview;

import android.os.Bundle;

import android.support.v7.app.ActionBarActivity;

import android.view.View;

import android.view.View.OnClickListener;

public class MainActivity extends ActionBarActivity implements OnClickListener{

String mUrl = “http://e.hiphotos.baidu.com/baike/c0%3Dbaike150%2C5%2C5%2C150%2C50/sign=79b94a3be21190ef15f69a8daf72f673/bd3eb13533fa828b5a920735f81f4134960a5ab7.jpg”;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

}

@Override

public void onClick(View v) {

if (v.getId() == R.id.btn) {

SmartImageView siv = (SmartImageView) findViewById(R.id.iv_coco);

siv.setImageUrl(mUrl);

}

效果图如下：

OK！已经完成主要功能。不过只是简单的完成了下载图片和显示图片的功能，但是并未涉及到图片的缓存，压缩，以及错处理等情况。所以需要一步一步去拓展。比如可以在返回的Code不为200时，加个else并发个消息给Handler，在Handler中去处理加载失败显示的错误图片资源就好。

三、源码分析

==========

从github上clone该项目，可以看到整个项目的代码只包含7个Java源文件，同时，还可进行扩展，方便使用者根据实际图片的来源进行扩展。我们来看看Class逻辑图：

上面有提到，SmartImageView继承自ImageView并自定义了一些方法，能够方便的显示网络图片。在Android中，图片的显示最终都绘制到画布canvas上以位图的形式显示，所以通过逻辑图可以看出定义了一个 SmartImage 接口，而里面有一个返回值为Bitmap的getBitmap方法：

package com.loopj.android.image;

import android.content.Context;

import android.graphics.Bitmap;

public interface SmartImage {

public Bitmap getBitmap(Context context);

}

为什么会定义这个getBitmap方法呢，因为需要加载的图片来源是不一样的，如：从网络加载或从系统联系人头像加载，所以分别让不同来源的类去实现这个接口，然后在该方法中处理逻辑。如图：

我们来看下这三个类的具体代码：

【BitmapImage（仅仅是传入Bitmap的实例然后返回）】---->

package com.loopj.android.image;

import android.content.Context;

import android.graphics.Bitmap;

/**

实现SmartImage接口

public class BitmapImage implements SmartImage {

//定义Bitmap对象

private Bitmap bitmap;

//构造方法

public BitmapImage(Bitmap bitmap) {

this.bitmap = bitmap;

}

//实现getBitmap方法

public Bitmap getBitmap(Context context) {

return bitmap;

}

【WebImage（根据Url获取图片资源，需要注意的是这里用到了缓存，注意代码注释）】---->

package com.loopj.android.image;

import java.io.InputStream;

import java.net.URL;

import java.net.URLConnection;

import android.content.Context;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

public class WebImage implements SmartImage {

//超时设置

private static final int CONNECT_TIMEOUT = 5000;

private static final int READ_TIMEOUT = 10000;

//缓存对象

private static WebImageCache webImageCache;

//WebImage的构造方法，获取URL

private String url;

public WebImage(String url) {

this.url = url;

}

//实现方法，处理相应的业务逻辑

public Bitmap getBitmap(Context context) {

// Don’t leak context

if(webImageCache == null) {

webImageCache = new WebImageCache(context);

}

// Try getting bitmap from cache first

//此处做了简单的二级缓存（内存缓存和磁盘缓存）

Bitmap bitmap = null;

if(url != null) {

//先从缓存获取bitmap对象

bitmap = webImageCache.get(url);

if(bitmap == null) {

//未找到则从网络加载

bitmap = getBitmapFromUrl(url);

if(bitmap != null){

//加载后将bitmap对象put到缓存中

webImageCache.put(url, bitmap);

}

return bitmap;

}

/**

根据Url获取网络图片资源
@param url
@return

private Bitmap getBitmapFromUrl(String url) {

Bitmap bitmap = null;

try {

URLConnection conn = new URL(url).openConnection();

conn.setConnectTimeout(CONNECT_TIMEOUT);

conn.setReadTimeout(READ_TIMEOUT);

bitmap = BitmapFactory.decodeStream((InputStream) conn.getContent());

} catch(Exception e) {

e.printStackTrace();

}

return bitmap;

}

/**

提供移除缓存的方法
@param url

public static void removeFromCache(String url) {

if(webImageCache != null) {

webImageCache.remove(url);

}

【ContactImage（系统联系人头像的获取，通过在构造函数传入联系人的ID，然后在getBitmap方法中根据ID查找对应的联系人头像）】---->

package com.loopj.android.image;

import java.io.InputStream;

import android.content.ContentUris;

import android.content.ContentResolver;

import android.content.Context;

import android.provider.ContactsContract;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.net.Uri;

获取联系人头像资源

public class ContactImage implements SmartImage {

/****************************************************************************************************

注：Android系统中访问其他app的数据时，一般都是通过ContentProvider实现，
一个ContentProvider类实现了一组标准的方法接口，能够让其他app保存或者读取它提供的各种数据类型。
其他app通过ContentResolver接口就可以访问ContentProvider提供的数据。
备注：（获取的是手机的联系人头像，而不是Sim卡中的联系人头像的。Sim卡由于容量限制等原因，无联系人头像数据）
–使用时记得添加获取联系人头像的权限

*****************************************************************************************************/

//联系人头像ID

private long contactId;

public ContactImage(long contactId) {

this.contactId = contactId;

}

public Bitmap getBitmap(Context context) {

Bitmap bitmap = null;

//获取ContentResolver实例

ContentResolver contentResolver = context.getContentResolver();

try {

//根据ID生成查找联系人的Uri

关于withAppendedId方法：

Open Declaration Uri android.content.ContentUris.withAppendedId(Uri contentUri, long id)

Appends the given ID to the end of the path.

Parameters:

contentUri – to start with

id – to append

Returns:

a new URI with the given ID appended to the end of the path */

Uri uri = ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI, contactId);

//调用Contact类中的openContactPhotoInputStream获得图像InputStream对象

InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(contentResolver, uri);

if(input != null) {

//将数据流decode为bitmap对象并返回

bitmap = BitmapFactory.decodeStream(input);

}

} catch(Exception e) {

e.printStackTrace();

}

return bitmap;

}

那ContactImage中联系人ID是怎么来的呢，其实也是通过ContentResolver查出来的，下面示例代码：

private static final int DISPLAY_NAME_INDEX = 0;

private static final int PHONE_NUMBER_INDEX = 1;

private static final int PHOTO_ID_INDEX = 2;

private static final int CONTACT_ID_INDEX = 3;

private static final String[] PHONES_PROJECTION = new String[] {

Phone.DISPLAY_NAME, Phone.NUMBER, Phone.PHOTO_ID,Phone.CONTACT_ID };

private void getPhoneContact(Context context) {

ContentResolver contentResolver = context.getContentResolver();

Cursor cursor = contentResolver.query(Phone.CONTENT_URI, PHONES_PROJECTION, null, null, null);

if (cursor != null) {

while(cursor.moveToNext()) {

String displayName = cursor.getString(DISPLAY_NAME_INDEX); // 联系人名字

String phoneNum = cursor.getString(PHONE_NUMBER_INDEX); // 联系人号码

Long contactId = cursor.getLong(CONTACT_ID_INDEX); // 联系人id

Long photoId = cursor.getLong(PHOTO_ID_INDEX); // 联系人头像id(photoId大于0时表示联系人有头像)

}

cursor.close();

}

好了，讲到这里，相信大家通过注释可以对这三个类有一定的了解了。可能有同学注意到了，那个WebImage中的 WebImageCache 是什么东西，里面是如何实现的呢？好，我们下面来说说关于这个类的源码实现，相信大家看了会对“缓存”这个高大上的词有一定认识。在WebImageCache中其实是实现了二级缓存，接着我们就来说说这个类。

SmartImageView中的二级缓存

相信大家都知道，在开发中，为了加快图片的访问速度，避免系统资源的浪费，用户体验上的流畅，都会引入缓存的机制，由于App内存有限，若超过了这个限制，系统便会报错OutOfMemory，这是个很头疼的问题。引入缓存的机制目的就是为了让App在使用中更加流畅，体验更好，减少不必要的资源开销。SmartImageView库中也引入了简单的二级缓存，数据获取速度取决于物理介质，一般是内存>磁盘>网络，故在加载图片时，会优先判断是否命中内存缓存，没有则查找磁盘缓存，最终才会考虑从网络上加载，同时更新内存缓存和磁盘缓存记录。

考虑到缓存查找的速度问题，在实现内存缓存时一般都会使用类似哈希表这样查找时间复杂度低的数据结构。由于存在多个线程同时在哈希表中查找的情况，需要考虑多线程并发访问的问题。故使用 ConcurrentHashMap。内存缓存中我们不会直接持有Bitmap实例的引用，而是通过SoftReference来持有Bitmap对象的软引用，如果一个对象具有软引用，内存空间足够时，垃圾回收器不会回收它，只有在内存空间不足时，才会回收这些对象占用的内存。因此，软引用通常用来实现内存敏感的高速缓存。关于引用问题，可具体参见博文java中对象的引用（强引用、软引用、弱引用、虚引用）

Android系统上磁盘缓存可以放在内部存储空间，也可以放在外部存储空间（即SD卡）。对于小图片的缓存可以放在内部存储空间中，但当图片比较大，数量比较多时，那么就应该将图片缓存放到SD卡上，毕竟内部存储空间一般比SD卡空间要小很多。SmartImageView库的磁盘缓存是放在内部存储空间中的，也就是app的缓存目录，该目录使用 Context.getCacheDir() 函数来获取，格式类似于：/data/data/app的包名/cache。cache目录主要用于存放缓存文件，当系统的内部存储空间不足时，该目录下面的文件会被删除；当然，不能依赖系统来清理这些缓存文件，而是应该对这些缓存文件设置最大存储空间，当实际占用空间超过这个最大值时，就需要对使用一定的算法对缓存文件进行清理。这一点在SmartImage库中并没有做考虑。

我们来看看WebImageCache类中对内存缓存和磁盘缓存的实现，先看其构造方法：

//构造方法，构建两级缓存空间

public WebImageCache(Context context) {

// Set up in-memory cache store

memoryCache = new ConcurrentHashMap<String, SoftReference>();

// Set up disk cache store

Context appContext = context.getApplicationContext();

diskCachePath = appContext.getCacheDir().getAbsolutePath() + DISK_CACHE_PATH;

//先根据URL在cache目录中生成对应的文件

File outFile = new File(diskCachePath);

outFile.mkdirs();

diskCacheEnabled = outFile.exists();

// Set up threadpool for image fetching tasks

writeThread = Executors.newSingleThreadExecutor();

}

具体从缓存获取Bitmap实例的实现方法：

/**

从Memory获取bitmap实例
@param url
@return

private Bitmap getBitmapFromMemory(String url) {

Bitmap bitmap = null;

//通过memoryCache取出软引用

SoftReference softRef = memoryCache.get(getCacheKey(url));

//判断系统有无回收该引用

if(softRef != null){

//get

bitmap = softRef.get();

}

return bitmap;

}

/**

从Disk获取Bitmap实例
@param url
@return

private Bitmap getBitmapFromDisk(String url) {

Bitmap bitmap = null;

if(diskCacheEnabled){

//根据URL在磁盘上查找对应的文件

String filePath = getFilePath(url);

File file = new File(filePath);

//若存在则decode为Bitmap实例

if(file.exists()) {

bitmap = BitmapFactory.decodeFile(filePath);

}

return bitmap;

}

/**

获取磁盘缓存路径
@param url
@return

private String getFilePath(String url) {

return diskCachePath + getCacheKey(url);

}

/**

获取缓存Key
@param url
@return

private String getCacheKey(String url) {

if(url == null){

throw new RuntimeException(“Null url passed in”);

} else {

//URL中可能包含一些特殊字符，在将URL转换成文件名时需要做预处理，过滤掉这些字符。

return url.replaceAll(“[.😕,%?&=]”, “+”).replaceAll(“[+]+”, “+”);

}

那是如何缓存的呢？我们再来看两个方法：

/**

将Bitmap存到内存缓存
@param url
@param bitmap

private void cacheBitmapToMemory(final String url, final Bitmap bitmap) {

//将数据put到HashMap中，存入的是Bitmap的软引用

memoryCache.put(getCacheKey(url), new SoftReference(bitmap));

}

/**

将Bitmap存入到磁盘
@param url
@param bitmap

private void cacheBitmapToDisk(final String url, final Bitmap bitmap) {

/*******************************************************

将Bitmap存入磁盘缓存是通过线程池ExecutorService实现
1.限制同时存在的线程个数
2.是解决同步问题。smart-image库使用的是只有一个线程的线程池，

*******************************************************/

结语

由于篇幅限制，文档的详解资料太全面，细节内容太多，所以只把部分知识点截图出来粗略的介绍，每个小节点里面都有更细化的内容！以下是目录截图：

由于整个文档比较全面，内容比较多，篇幅不允许，下面以截图方式展示。

再附一部分Android架构面试视频讲解：

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

void cacheBitmapToMemory(final String url, final Bitmap bitmap) {

//将数据put到HashMap中，存入的是Bitmap的软引用

memoryCache.put(getCacheKey(url), new SoftReference(bitmap));

}

/**

将Bitmap存入到磁盘
@param url
@param bitmap

private void cacheBitmapToDisk(final String url, final Bitmap bitmap) {

/*******************************************************

将Bitmap存入磁盘缓存是通过线程池ExecutorService实现
1.限制同时存在的线程个数
2.是解决同步问题。smart-image库使用的是只有一个线程的线程池，

*******************************************************/

结语

[外链图片转存中…(img-qPuxhCt3-1714343263033)]

由于整个文档比较全面，内容比较多，篇幅不允许，下面以截图方式展示。

再附一部分Android架构面试视频讲解：

[外链图片转存中…(img-SfTx1RLj-1714343263034)]

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

2401_84537603

关注

29
点赞
踩
26

收藏

觉得还不错? 一键收藏
0
评论
android-smart-image-view源码分析

由于篇幅限制，文档的详解资料太全面，细节内容太多，所以只把部分知识点截图出来粗略的介绍，每个小节点里面都有更细化的内容！由于整个文档比较全面，内容比较多，篇幅不允许，下面以截图方式展示。网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。需要这份系统化学习资料的朋友，可以戳这里获取一个人可以走的很快，但一群人才能走的更远！
复制链接

扫一扫