- 原文鏈接: Customizing Picasso with Picasso.Builder
- 原文作者: Future Studio
- 譯文出自: 小鄧子的簡(jiǎn)書
- 譯者: 小鄧子
- 狀態(tài): 完成
使用Picasso.Builder定制Picasso
可以通過(guò)Picasso.Builder 直接修改Picasso實(shí)例。我們將使用Picasso.Builder
來(lái)創(chuàng)建自定義的Picasso實(shí)例香浩。新的Picasso實(shí)例可能替換了多個(gè)組件衔瓮。在看有哪些可替換組件之前砸王,讓我們先來(lái)了解一下如何創(chuàng)建一個(gè)自定義的Picasso實(shí)例璧坟。
自定義局部實(shí)例
在創(chuàng)建自定義Picasso實(shí)例之前赘淮,讓我們簡(jiǎn)單的了解下献雅,到目前為止管挟,我們是如何拿到標(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
對(duì)象,添加你需要的配置爵卒,然后構(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對(duì)象,與標(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在所有的請(qǐng)求上实牡,都能表現(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請(qǐng)求前調(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í)這樣做搭盾,所有通過(guò)調(diào)用Picasso.with(Context context)
返回的對(duì)象都是你自定義的那個(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)
來(lái)實(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會(huì)優(yōu)先選擇OKHttp(如果可用的話)跟畅,因此這并沒(méi)有什么實(shí)際意義。我們通過(guò)一個(gè)實(shí)際例子溶推,來(lái)描述如下真實(shí)存在的場(chǎng)景:服務(wù)請(qǐng)求使用HTTPS徊件,但同時(shí)還存在一個(gè)自簽名的證書驗(yàn)證。由于SSL證書的問(wèn)題蒜危,標(biāo)準(zhǔn)的OKHttp實(shí)現(xiàn)將會(huì)拒絕這個(gè)連接請(qǐng)求虱痕,帶來(lái)的后果的就是無(wú)法下載圖片,然后ImageView
也是空的辐赞。
你可以通過(guò)一個(gè)OkHttp實(shí)現(xiàn)來(lái)修復(fù)這個(gè)問(wèn)題部翘,這個(gè)實(shí)現(xiàn)類將忽略HTTPS自身存在的問(wèn)題。設(shè)置這個(gè)HTTP實(shí)例到你的Picasso下載器中响委,即便在自簽名HTTPS環(huán)境中新思,也依然能正確的顯示圖片。
picassoBuilder.downloader(
new OkHttpDownloader(
UnsafeOkHttpClient.getUnsafeOkHttpClient()
)
);
必須要提醒的是:這會(huì)忽略所有的安全檢查晃酒,所以在使用網(wǎng)絡(luò)組件之前表牢,請(qǐng)一定明確知道自己在做什么窄绒。
進(jìn)一步自定義
除了下載器之外贝次,Picasso.Builder
還提供了許多可自定義的屬性。在我們看來(lái)這以下兩個(gè)是最有趣的:
Memory Cache: 如果你不認(rèn)可標(biāo)準(zhǔn)設(shè)置(應(yīng)用可用RAM的15%作為內(nèi)存緩存)彰导,你可以實(shí)現(xiàn)自己的緩存策略蛔翅,然后添加到
Picasso.Builder
上敲茄。Request Handlers: 如果你所請(qǐng)求的圖像,是一個(gè)自定義Uri格式的地址山析,那么
Request Handler
則是你強(qiáng)有力的工具堰燎。下一篇博客將會(huì)介紹有關(guān)Request Handler
的相關(guān)知識(shí)。