Skip to content

Latest commit

 

History

History
137 lines (104 loc) · 4.77 KB

README.md

File metadata and controls

137 lines (104 loc) · 4.77 KB
Raw

DaVinci

基于Volley实现的一款多功能网络库, 目前包括了普通图片和Gif图片的加载显示、图片的二级缓存机制、可以开启Cookie的http请求等功能。

我们先来一张Glide与DaVinci加载同一张网络上Gif图的对比效果

Demo Download

从上面我们可以明显看出，Glide加载一张Gif图比DaVinci明显花更久的时间。并且再看加载后的动画效果，DaVinci加载后的Gif图动画非常流畅，而Glide加载过后的Gif的动画有些显示问题。并且用DaVinci加载图片，你可以定制loading过程的图片，而Glide无法做到。

我们再来看下实现上述功能，两者需要的代码对比。

DaVinci

DaVinci
	.with(this)
	.getImageLoader()
	.load("http://7xlkhg.com2.z0.glb.qiniucdn.com/qbi_cry.gif")
	.into(image1);

Glide

Glide
	.with(this)
	.load("http://7xlkhg.com2.z0.glb.qiniucdn.com/qbi_cry.gif")
	.into(image2);

实现方式基本差不多，但你要知道本库可不单单只有图片加载功能哦。

1，特色

1，支持Gif图片，并且做到Gif库可插拔；

2，实现客户端Http请求的Cookie机制，只要调用一个enable方法就搞定；

3，支持内存和本地的二级缓存，让图片加载更加流畅；

4, 支持使用POST方法获得图片；

5, 支持创建多线程池

6, 支持上传、下载功能

2， 使用方法

用Gradle的方式导入DaVinci库，因为DaVinci的日志打印采用VinciLog，所以需要同时引入VinciLog库

repositories{
    maven { url "https://jitpack.io" }
}
dependencies {
	compile 'com.github.CPPAlien:VinciLog:2.0.1'
    compile 'com.github.CPPAlien:DaVinci:1.3.2'
}

3， Get和Post请求

DaVinci.with(Context).getHttpRequest()
doGet(String requestUrl, Map<String, Object> params, OnDaVinciRequestListener requestListener)
doPost(String requestUrl, JSONObject postJsonData, OnDaVinciRequestListener requestListener)
doPost(String requestUrl, String postBodyString, OnDaVinciRequestListener requestListener)

public interface OnDaVinciRequestListener {
    void onDaVinciRequestSuccess(String response);
    void onDaVinciRequestFailed(String reason);
}

4， 从网络上加载图片

DaVinci.with(Context).getImageLoader().load("image url put here").into(imageView);

你也可以在into是使用into(ImageView imageView, int loadingImage, int errorImage)来设置loading图片，和加载错误时的图片

本库Gif图片加载采用koral--实现的android-gif-drawable，因为此库底层使用C库进行Gif的编解码，所以效率和显示效果方面都比Glide优秀。

开启本库Gif功能，你需要导入compile 'pl.droidsonroids.gif:android-gif-drawable:1.1.15'，导入后，加载的图片如果为Gif，则会自动以动图的方式在ImageView里面显示。如果你没有导入该android-gif-drawable库，则Gif图会被当做普通图片处理。

5，其他用法

  • 如果你不想每次在使用DaVinci.with(Context)时都传入Context，则你可以在所有调用前先init一下，以后只要使用DaVinci.with()即可。
/**
 * @param isEnableDebug if open log print
 * @param debugTag log tag
 * @param context context
 */
DaVinci.init(boolean isEnableDebug, String debugTag, Context context)
  • 开启Cookie机制，Cookie机制开启后，每次的请求头中都会带有Cookie头信息。
DaVinci.with(Context).enableCookie();
  • 设置默认的Content-Type (默认是 application/json) 和 charset(默认是 utf-8，此项可选)
contentType(String contentType, String charset)
  • 加入请求头
getHttpRequest().headers(Map<String, String> headersMap)
  • 设置请求超时时间
getHttpRequest().timeOut(int timesOutMs)
  • 设置请求的错误尝试次数
getHttpRequest().maxRetries(int maxRetries)
  • 设置加载图片大小，下载后图片长宽按比例缩放为设定的maxpix大小，并且使用url + maxPix的方式作为key, 缓存到本地
getImageLoader().resize(int maxPix).load(...)

注：1, 对Gif无效；2, 如果不想使用maxPix作为key的一部分,可以使用resize(int maxPix, 0);

  • 使用POST方法加载图片，body中为post方法体
getImageLoader().body(XXXX).load(...)

Thanks for DiskLruCache which powered by Jake Wharton.

https://github.com/JakeWharton/DiskLruCache

Thanks for Fran Montiel who wrote the PersistentCookieStore(https://gist.github.com/franmontiel/ed12a2295566b7076161)