- 原文鏈接: Customizing Picasso with Picasso.Builder
- 原文作者: Future Studio
- 譯文出自: 小鄧子的簡書
- 譯者: 小鄧子
- 狀態: 完成
使用Picasso.Builder定制Picasso
可以通過Picasso.Builder 直接修改Picasso實例。我們將使用Picasso.Builder
來創建自定義的Picasso實例。新的Picasso實例可能替換了多個組件。在看有哪些可替換組件之前,讓我們先來了解一下如何創建一個自定義的Picasso實例。
自定義局部實例
在創建自定義Picasso實例之前,讓我們簡單的了解下,到目前為止,我們是如何拿到標準Picasso實例的:
Picasso picasso = Picasso.with(Context);
Picasso.with(Context context)
始終返回標準的Picasso實例。如果需要自定義實例,一種方式是創建Picasso.Builder
對象,添加你需要的配置,然后構建出Picasso實例。
// create Picasso.Builder object
Picasso.Builder picassoBuilder = new Picasso.Builder(context);
// todo make your adjustments here (will do in a minute)
// Picasso.Builder creates the Picasso object to do the actual requests
Picasso picasso = picassoBuilder.build();
新創建出的Picasso對象,與標準Picasso擁有相同的功能。
// instead of Picasso.with(Context context) you directly use this new custom Picasso object
picasso
.load(UsageExampleListViewAdapter.eatFoodyImages[0])
.into(imageView1);
如果你希望Picasso在所有的請求上,都能表現出一個特殊的行為,那么就需要將你的自定義實例,設置為全局實例。
自定義全局實例
創建和修改Picasso實例的方式保持不變:
// create Picasso.Builder object
Picasso.Builder picassoBuilder = new Picasso.Builder(context);
// Picasso.Builder creates the Picasso object to do the actual requests
Picasso picasso = picassoBuilder.build();
調用Picasso.setSingletonInstance(picasso)
將這個自定義Picasso實例,設置為全局實例。需要牢記的是,你只能在Picasso請求前調用這個方法,原則上講,應該在應用啟動時調用。
// set the global instance to use this Picasso object
// all following Picasso (with Picasso.with(Context context) requests will use this Picasso object
// you can only use the setSingletonInstance() method once!
try {
Picasso.setSingletonInstance(picasso);
} catch (IllegalStateException ignored) {
// Picasso instance was already set
// cannot set it after Picasso.with(Context) was already in use
}
一旦在應用啟動時這樣做,所有通過調用Picasso.with(Context context)
返回的對象都是你自定義的那個Picasso實例。
// you can continue to use Picasso.with(Context context), but it'll return your custom instance
Picasso
.with(context)
.load(UsageExampleListViewAdapter.eatFoodyImages[1])
.into(imageView2);
你還需要考慮的是,哪些選項才是真正適合你的項目工程的。為了方便你的決定,我們將向您展示一個可以定制的Picasso行為:替換網絡組件.
影響Picasso行為:替換下載組件
Picasso將默認使用最佳化的緩存和下載組件。如果你有足夠的理由為Picasso制定一個特殊的下載組件,可以在Picasso.Builder
上調用.downloader(Downloader downloader)
來實現。它應該是一個實現了OkHttp的Downloader接口的實例。
// create Picasso.Builder object
Picasso.Builder picassoBuilder = new Picasso.Builder(context);
// let's change the standard behavior before we create the Picasso instance
// for example, let's switch out the standard downloader for the OkHttpClient
picassoBuilder.downloader(new OkHttpDownloader(new OkHttpClient()));
// Picasso.Builder creates the Picasso object to do the actual requests
Picasso picasso = picassoBuilder.build();
picasso
.load(UsageExampleListViewAdapter.eatFoodyImages[2])
.into(imageView3);
由于Picasso會優先選擇OKHttp(如果可用的話),因此這并沒有什么實際意義。我們通過一個實際例子,來描述如下真實存在的場景:服務請求使用HTTPS,但同時還存在一個自簽名的證書驗證。由于SSL證書的問題,標準的OKHttp實現將會拒絕這個連接請求,帶來的后果的就是無法下載圖片,然后ImageView
也是空的。
你可以通過一個OkHttp實現來修復這個問題,這個實現類將忽略HTTPS自身存在的問題。設置這個HTTP實例到你的Picasso下載器中,即便在自簽名HTTPS環境中,也依然能正確的顯示圖片。
picassoBuilder.downloader(
new OkHttpDownloader(
UnsafeOkHttpClient.getUnsafeOkHttpClient()
)
);
必須要提醒的是:這會忽略所有的安全檢查,所以在使用網絡組件之前,請一定明確知道自己在做什么。
進一步自定義
除了下載器之外,Picasso.Builder
還提供了許多可自定義的屬性。在我們看來這以下兩個是最有趣的:
Memory Cache: 如果你不認可標準設置(應用可用RAM的15%作為內存緩存),你可以實現自己的緩存策略,然后添加到
Picasso.Builder
上。Request Handlers: 如果你所請求的圖像,是一個自定義Uri格式的地址,那么
Request Handler
則是你強有力的工具。下一篇博客將會介紹有關Request Handler
的相關知識。