picasso--不得不看的异步图片加载与缓存开源库
picasso是Square公司开源的一个Android图形缓存库,地址http://square.github.io/picasso/,可以实现图片下载和缓存功能。仅仅只需要一行代码就能完全实现图片的异步加载:
1
|
|
Api看起来非常独特,是吧。
Picasso不仅实现了图片异步加载的功能,还解决了android中加载图片时需要解决的一些常见问题:
1.在adapter中需要取消已经不在视野范围的ImageView图片资源的加载,否则会导致图片错位,Picasso已经解决了这个问题。
2.使用复杂的图片压缩转换来尽可能的减少内存消耗
3.自带内存和硬盘二级缓存功能
特性以及示例代码:
ADAPTER 中的下载:Adapter的重用会被自动检测到,Picasso会取消上次的加载
1
2
3
4
5
6
7
8
|
@Override
public void getView(int position, View convertView, ViewGroup parent) {
SquaredImageView
view = (SquaredImageView) convertView;
if (view
== null )
{
view
= new SquaredImageView(context);
}
String
url = getItem(position);
Picasso. with (context).load(url).into(view);
}
|
图片转换:转换图片以适应布局大小并减少内存占用
1
2
3
4
5
|
Picasso. with (context)
.load(url)
.resize(50,
50)
.centerCrop()
.into(imageView);
|
你还可以自定义转换:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
public
class CropSquareTransformation implements Transformation {
@Override
public Bitmap transform(Bitmap source) {
int
size = Math.min(source.getWidth(), source.getHeight());
int
x = (source.getWidth() - size) / 2;
int
y = (source.getHeight() - size) / 2;
Bitmap
result = Bitmap.createBitmap(source, x, y, size, size);
if (result
!= source) {
source.recycle();
}
return result;
}
@Override
public String key() { return "square()" ;
}
}
|
将CropSquareTransformation 的对象传递给transform 方法即可。
Place holders-空白或者错误占位图片:picasso提供了两种占位图片,未加载完成或者加载发生错误的时需要一张图片作为提示。
1
2
3
4
5
|
Picasso. with (context)
.load(url)
.placeholder(R.drawable.user_placeholder)
.error(R.drawable.user_placeholder_error)
.into(imageView);
|
如果加载发生错误会重复三次请求,三次都失败才会显示erro Place holder
资源文件的加载:除了加载网络图片picasso还支持加载Resources, assets, files, content providers中的资源文件。
1
2
|
Picasso. with (context).load(R.drawable.landing_screen).into(imageView1);
Picasso. with (context).load( new File(...)).into(imageView2);
|
下面是picasso源码的解析(不看不影响使用)
Cache,缓存类
1
|
this .map
= new LinkedHashMap<String,
Bitmap>(0, 0.75f, true );
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
private
void trimToSize(int maxSize) {
while ( true )
{
String
key;
Bitmap
value;
synchronized
( this )
{
if (size
< 0 || (map.isEmpty() && size != 0)) {
throw new
IllegalStateException(getClass().getName()
+ ".sizeOf()
is reporting inconsistent results!" );
}
if (size
<= maxSize || map.isEmpty()) {
break ;
}
Map.Entry<String,
Bitmap> toEvict = map.entrySet().iterator()
.next();
key
= toEvict.getKey();
value
= toEvict.getValue();
map.remove(key);
size
-= Utils.getBitmapBytes(value);
evictionCount++;
}
}
}
|
Request,操作封装类
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
public
interface Transformation {
/**
*
Transform the source bitmap into a new bitmap. If you create a new bitmap instance, you must
*
call {@link android.graphics.Bitmap#recycle()} on {@code source}. You may return the original
*
if no transformation is required.
*/
Bitmap
transform(Bitmap source);
/**
*
Returns a unique key for the transformation, used for caching purposes. If the transformation
*
has parameters (e.g. size, scale factor, etc) then these should be part of the key.
*/
String
key();
}
|
当操作封装好以后,会将Request传到另一个结构中Action。
Action
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
@Override
public
void complete(Bitmap result, Picasso.LoadedFrom from) {
if (result
== null )
{
throw new
AssertionError(String.format(
"Attempted
to complete action with no result!\n%s" , this ));
}
ImageView
target = this .target.get();
if (target
== null )
{
return ;
}
Context
context = picasso.context;
boolean
debugging = picasso.debugging;
PicassoDrawable.setBitmap(target,
context, result, from, noFade,
debugging);
if (callback
!= null )
{
callback.onSuccess();
}
}
|
有了加载任务,具体的图片下载与解析是在哪里呢?这些都是耗时的操作,应该放在异步线程中进行,就是下面的BitmapHunter。
BitmapHunter
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
@Override
public
void run() {
try {
Thread.currentThread()
.setName(Utils.THREAD_PREFIX
+ data.getName());
result
= hunt();
if (result
== null )
{
dispatcher.dispatchFailed( this );
} else {
dispatcher.dispatchComplete( this );
}
} catch (IOException
e) {
exception
= e;
dispatcher.dispatchRetry( this );
} catch (Exception
e) {
exception
= e;
dispatcher.dispatchFailed( this );
}
finally {
Thread.currentThread().setName(Utils.THREAD_IDLE_NAME);
}
}
abstract
Bitmap decode(Request data) throws IOException;
Bitmap
hunt() throws IOException {
Bitmap
bitmap;
if (!skipMemoryCache)
{
bitmap
= cache.get(key);
if (bitmap
!= null )
{
stats.dispatchCacheHit();
loadedFrom
= MEMORY;
return bitmap;
}
}
bitmap
= decode(data);
if (bitmap
!= null )
{
stats.dispatchBitmapDecoded(bitmap);
if (data.needsTransformation()
|| exifRotation != 0) {
synchronized
(DECODE_LOCK) {
if (data.needsMatrixTransform()
|| exifRotation != 0) {
bitmap
= transformResult(data, bitmap, exifRotation);
}
if (data.hasCustomTransformations())
{
bitmap
= applyCustomTransformations(
data.transformations,
bitmap);
}
}
stats.dispatchBitmapTransformed(bitmap);
}
}
return bitmap;
}
|
Dispatcher任务调度器
外部调用的是dispatchXXX方法,然后通过handler将请求转换到对应的performXXX方法。
例如生成Action以后就会调用dispather的dispatchSubmit()来请求执行,
1
2
3
|
void
dispatchSubmit(Action action) {
handler.sendMessage(handler.obtainMessage(REQUEST_SUBMIT,
action));
}
|
handler接到消息后转换到performSubmit方法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
void
performSubmit(Action action) {
BitmapHunter
hunter = hunterMap.get(action.getKey());
if (hunter
!= null )
{
hunter.attach(action);
return ;
}
if (service.isShutdown())
{
return ;
}
hunter
= forRequest(context, action.getPicasso(), this ,
cache, stats,
action,
downloader);
hunter.future
= service.submit(hunter);
hunterMap.put(action.getKey(),
hunter);
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
public
static Picasso with (Context
context) {
if (singleton
== null )
{
singleton
= new Builder(context).build();
}
return singleton;
}
public
Picasso build() {
Context
context = this .context;
if (downloader
== null )
{
downloader
= Utils.createDefaultDownloader(context);
}
if (cache
== null )
{
cache
= new LruCache(context);
}
if (service
== null )
{
service
= new PicassoExecutorService();
}
if (transformer
== null )
{
transformer
= RequestTransformer.IDENTITY;
}
Stats
stats = new Stats(cache);
Dispatcher
dispatcher = new Dispatcher(context,
service, HANDLER,
downloader,
cache, stats);
return new
Picasso(context, dispatcher, cache, listener,
transformer,
stats, debugging);
}
|
在Picasso.with()的时候会将执行所需的所有必备元素创建出来,如缓存cache、执行executorService、调度dispatch等,在load()时创建Request,在into()中创建action、bitmapHunter,并最终交给dispatcher执行。