【譯】使用Picasso.Builder定制Picasso實例

使用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)來實現。它應該是一個實現了OkHttpDownloader接口的實例。

// 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的相關知識。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容