- 原文鏈接: Customizing Picasso with Picasso.Builder
- 原文作者: Future Studio
- 譯文出自: 小鄧子的簡書
- 譯者: 小鄧子
- 狀態(tài): 完成
使用Picasso.Builder定制Picasso
可以通過Picasso.Builder 直接修改Picasso實(shí)例。我們將使用Picasso.Builder
來創(chuàng)建自定義的Picasso實(shí)例。新的Picasso實(shí)例可能替換了多個(gè)組件。在看有哪些可替換組件之前,讓我們先來了解一下如何創(chuàng)建一個(gè)自定義的Picasso實(shí)例。
自定義局部實(shí)例
在創(chuàng)建自定義Picasso實(shí)例之前,讓我們簡單的了解下,到目前為止,我們是如何拿到標(biāo)準(zhǔn)Picasso實(shí)例的:
Picasso picasso = Picasso.with(Context);
Picasso.with(Context context)
始終返回標(biāo)準(zhǔn)的Picasso實(shí)例。如果需要自定義實(shí)例,一種方式是創(chuàng)建Picasso.Builder
對象,添加你需要的配置,然后構(gòu)建出Picasso實(shí)例。
// 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();
新創(chuàng)建出的Picasso對象,與標(biāo)準(zhǔn)Picasso擁有相同的功能。
// instead of Picasso.with(Context context) you directly use this new custom Picasso object
picasso
.load(UsageExampleListViewAdapter.eatFoodyImages[0])
.into(imageView1);
如果你希望Picasso在所有的請求上,都能表現(xiàn)出一個(gè)特殊的行為,那么就需要將你的自定義實(shí)例,設(shè)置為全局實(shí)例。
自定義全局實(shí)例
創(chuàng)建和修改Picasso實(shí)例的方式保持不變:
// 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();
調(diào)用Picasso.setSingletonInstance(picasso)
將這個(gè)自定義Picasso實(shí)例,設(shè)置為全局實(shí)例。需要牢記的是,你只能在Picasso請求前調(diào)用這個(gè)方法,原則上講,應(yīng)該在應(yīng)用啟動(dòng)時(shí)調(diào)用。
// 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
}
一旦在應(yīng)用啟動(dòng)時(shí)這樣做,所有通過調(diào)用Picasso.with(Context context)
返回的對象都是你自定義的那個(gè)Picasso實(shí)例。
// 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);
你還需要考慮的是,哪些選項(xiàng)才是真正適合你的項(xiàng)目工程的。為了方便你的決定,我們將向您展示一個(gè)可以定制的Picasso行為:替換網(wǎng)絡(luò)組件.
影響Picasso行為:替換下載組件
Picasso將默認(rèn)使用最佳化的緩存和下載組件。如果你有足夠的理由為Picasso制定一個(gè)特殊的下載組件,可以在Picasso.Builder
上調(diào)用.downloader(Downloader downloader)
來實(shí)現(xiàn)。它應(yīng)該是一個(gè)實(shí)現(xiàn)了OkHttp的Downloader接口的實(shí)例。
// 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會優(yōu)先選擇OKHttp(如果可用的話),因此這并沒有什么實(shí)際意義。我們通過一個(gè)實(shí)際例子,來描述如下真實(shí)存在的場景:服務(wù)請求使用HTTPS,但同時(shí)還存在一個(gè)自簽名的證書驗(yàn)證。由于SSL證書的問題,標(biāo)準(zhǔn)的OKHttp實(shí)現(xiàn)將會拒絕這個(gè)連接請求,帶來的后果的就是無法下載圖片,然后ImageView
也是空的。
你可以通過一個(gè)OkHttp實(shí)現(xiàn)來修復(fù)這個(gè)問題,這個(gè)實(shí)現(xiàn)類將忽略HTTPS自身存在的問題。設(shè)置這個(gè)HTTP實(shí)例到你的Picasso下載器中,即便在自簽名HTTPS環(huán)境中,也依然能正確的顯示圖片。
picassoBuilder.downloader(
new OkHttpDownloader(
UnsafeOkHttpClient.getUnsafeOkHttpClient()
)
);
必須要提醒的是:這會忽略所有的安全檢查,所以在使用網(wǎng)絡(luò)組件之前,請一定明確知道自己在做什么。
進(jìn)一步自定義
除了下載器之外,Picasso.Builder
還提供了許多可自定義的屬性。在我們看來這以下兩個(gè)是最有趣的:
Memory Cache: 如果你不認(rèn)可標(biāo)準(zhǔn)設(shè)置(應(yīng)用可用RAM的15%作為內(nèi)存緩存),你可以實(shí)現(xiàn)自己的緩存策略,然后添加到
Picasso.Builder
上。Request Handlers: 如果你所請求的圖像,是一個(gè)自定義Uri格式的地址,那么
Request Handler
則是你強(qiáng)有力的工具。下一篇博客將會介紹有關(guān)Request Handler
的相關(guān)知識。