SimpleCommand(三) ImageLoader API详细介绍

框架github地址: SimpleCommand框架

ImageLoader API 详细介绍

在ImageLoader中有以下几个不同的构造器：

/**
* 注意: 次构造器不支持下载进度提示功能
* @param context
* @param withCache 是否支持缓存
*                  false--不带缓存
*                  true--支持缓存功能，默认缓存路径在外置存储缓冲目录中的picasso-big-cache文件夹中
*/
public ImageLoader(Context context, boolean withCache) {
this(context, null, withCache);
}

/**
* 支持下载进度提示，以及设置缓存路径
* @param context
* @param listener  下载进度监听器
* @param cachePath  缓存路径字符串
*/
public ImageLoader(Context context, ProgressListener listener, String cachePath) {
// TODO extend to support multiple libraries as Glide
// TODO must be initialized and kept as an member instance to avoid losing cache
Picasso.Builder builder = setupLoaderClientWithCachePath(context, listener, cachePath);
setupListener(builder);

picasso = builder.build();
picasso.setIndicatorsEnabled(BuildConfig.DEBUG);
picasso.setLoggingEnabled(BuildConfig.DEBUG);
}

/**
* 支持下载进度提示，以及设置缓存路径为默认路径picasso-big-cache
* @param context
* @param listener  下载进度监听器
* @param withCache  是否支持缓存
*/
public ImageLoader(Context context, ProgressListener listener, boolean withCache) {
// TODO extend to support multiple libraries as Glide
// TODO must be initialized and kept as an member instance to avoid losing cache
Picasso.Builder builder = setupLoaderClient(context, listener, withCache);
setupListener(builder);

picasso = builder.build();
picasso.setIndicatorsEnabled(BuildConfig.DEBUG);
picasso.setLoggingEnabled(BuildConfig.DEBUG);
}

public void shutdown() {
if (picasso == null) return;

Logger.d(Logger.TAG, "Image loader has been shutdown");
picasso.shutdown();
callback = null;
}

将ImageLoader停止，一般在Activity停止，或者任务结束时调用此方法将其关闭

public ImageLoader cancelRequest(ImageView imageView) {
picasso.cancelRequest(imageView);
return this;
}

取消之前显示到ImageView上的请求

public ImageLoader load(final int resourceId) {
cleanResources();
this.imageResourceId = resourceId;
return this;
}

public ImageLoader load(final String imageUri) {
cleanResources();
this.imageUri = imageUri;
return this;
}

分别加载本地drawable文件夹下的图片，以及网络图片

public ImageLoader withPlaceholder(final int placeholder) {
this.placeholder = placeholder;
return this;
}

设置ImageLoader下载图片时的预览图

public ImageLoader withErrorImage(final int errorImage) {
this.errorImage = errorImage;
return this;
}

下载图片失败时显示的图片

public ImageLoader withTag(final String tag) {
this.tag = tag;
return this;
}

public void pause(final String tag) {
if (picasso == null) return;

picasso.pauseTag(tag);
}

public void resume(final String tag) {
if (picasso == null) return;

picasso.resumeTag(tag);
}

以上三个方法依次是

1 下载图片时添加标签tag

2 暂停tag标签的下载任务

3 resume tag标签的下载任务

public ImageLoader withCallback(final Callback callback) {
this.callback = callback;
return this;
}

给ImageLoader设置下载完成的回调，包含onSuccess和onFailed方法

public ImageLoader fit() {
this.fit = true;
return this;
}

public ImageLoader centerCrop() {
this.centerCrop = true;
return this;
}

public ImageLoader centerInside() {
this.centerInside = true;
return this;
}

public ImageLoader resize(final int widthResId, final int heightResId) {
this.widthResId = widthResId;
this.heigthResId = heightResId;
return this;
}

分别设置Picasso下载图片时的相应属性， 可以参考ImageView的scaleType属性

public void into(final ImageView imageView) {
run(imageView);
}

into方法调用内部run方法，并启动下载任务。 此方法需要在以上所有的API之后调用