Picasso (Picasso 2.5.2 API)

java.lang.Object
- com.squareup.picasso.Picasso

```
public class Picasso
extends Object
```
Image downloading, transformation, and caching manager.
Use with(android.content.Context) for the global singleton instance or construct your own instance with Picasso.Builder.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Picasso.Builder` Fluent API for creating `Picasso` instances.
`static interface`	`Picasso.Listener` Callbacks for Picasso events.
`static class`	`Picasso.LoadedFrom` Describes where the image was loaded from.
`static class`	`Picasso.Priority` The priority of a request.
`static interface`	`Picasso.RequestTransformer` A transformer that is called immediately before every request is submitted.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`areIndicatorsEnabled()` `true` if debug indicators should are displayed on images.
`void`	`cancelRequest(android.widget.ImageView view)` Cancel any existing requests for the specified target `ImageView`.
`void`	`cancelRequest(android.widget.RemoteViews remoteViews, int viewId)` Cancel any existing requests for the specified `RemoteViews` target with the given `viewId`.
`void`	`cancelRequest(Target target)` Cancel any existing requests for the specified `Target` instance.
`void`	`cancelTag(Object tag)` Cancel any existing requests with given tag.
`StatsSnapshot`	`getSnapshot()` Creates a `StatsSnapshot` of the current stats for this instance.
`void`	`invalidate(File file)` Invalidate all memory cached images for the specified `file`.
`void`	`invalidate(String path)` Invalidate all memory cached images for the specified `path`.
`void`	`invalidate(android.net.Uri uri)` Invalidate all memory cached images for the specified `uri`.
`boolean`	`isDebugging()` Deprecated. Use `areIndicatorsEnabled()` and `isLoggingEnabled()` instead.
`boolean`	`isLoggingEnabled()` `true` if debug logging is enabled.
`RequestCreator`	`load(File file)` Start an image request using the specified image file.
`RequestCreator`	`load(int resourceId)` Start an image request using the specified drawable resource ID.
`RequestCreator`	`load(String path)` Start an image request using the specified path.
`RequestCreator`	`load(android.net.Uri uri)` Start an image request using the specified URI.
`void`	`pauseTag(Object tag)` Pause existing requests with the given tag.
`void`	`resumeTag(Object tag)` Resume paused requests with the given tag.
`void`	`setDebugging(boolean debugging)` Deprecated. Use `setIndicatorsEnabled(boolean)` and `setLoggingEnabled(boolean)` instead.
`void`	`setIndicatorsEnabled(boolean enabled)` Toggle whether to display debug indicators on images.
`void`	`setLoggingEnabled(boolean enabled)` Toggle whether debug logging is enabled.
`static void`	`setSingletonInstance(Picasso picasso)` Set the global instance returned from `with(android.content.Context)`.
`void`	`shutdown()` Stops this instance from accepting further requests.
`static Picasso`	`with(android.content.Context context)` The global default `Picasso` instance.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - cancelRequest
```
public void cancelRequest(android.widget.ImageView view)
```
    Cancel any existing requests for the specified target ImageView.
  - cancelRequest
```
public void cancelRequest(Target target)
```
    Cancel any existing requests for the specified Target instance.
  - cancelRequest
```
public void cancelRequest(android.widget.RemoteViews remoteViews,
                 int viewId)
```
    Cancel any existing requests for the specified RemoteViews target with the given viewId.
  - cancelTag
```
public void cancelTag(Object tag)
```
    Cancel any existing requests with given tag. You can set a tag on new requests with RequestCreator.tag(Object).
    
    See Also:
    RequestCreator.tag(Object)
  - pauseTag
```
public void pauseTag(Object tag)
```
    Pause existing requests with the given tag. Use resumeTag(Object) to resume requests with the given tag.
    
    See Also:
    resumeTag(Object), RequestCreator.tag(Object)
  - resumeTag
```
public void resumeTag(Object tag)
```
    Resume paused requests with the given tag. Use pauseTag(Object) to pause requests with the given tag.
    
    See Also:
    pauseTag(Object), RequestCreator.tag(Object)
  - load
```
public RequestCreator load(android.net.Uri uri)
```
    Start an image request using the specified URI.
    Passing null as a uri will not trigger any request but will set a placeholder, if one is specified.
    
    See Also:
    load(File), load(String), load(int)
  - load
```
public RequestCreator load(String path)
```
    Start an image request using the specified path. This is a convenience method for calling load(Uri).
    This path may be a remote URL, file resource (prefixed with file:), content resource (prefixed with content:), or android resource (prefixed with android.resource:.
    Passing null as a path will not trigger any request but will set a placeholder, if one is specified.
    
    Throws:
    
    IllegalArgumentException - if path is empty or blank string.
    See Also:
    load(Uri), load(File), load(int)
  - load
```
public RequestCreator load(File file)
```
    Start an image request using the specified image file. This is a convenience method for calling load(Uri).
    Passing null as a file will not trigger any request but will set a placeholder, if one is specified.
    Equivalent to calling load(Uri.fromFile(file)).
    
    See Also:
    load(Uri), load(String), load(int)
  - load
```
public RequestCreator load(int resourceId)
```
    Start an image request using the specified drawable resource ID.
    
    See Also:
    load(Uri), load(String), load(File)
  - invalidate
```
public void invalidate(android.net.Uri uri)
```
    Invalidate all memory cached images for the specified uri.
    
    See Also:
    invalidate(String), invalidate(File)
  - invalidate
```
public void invalidate(String path)
```
    Invalidate all memory cached images for the specified path. You can also pass a stable key.
    
    See Also:
    invalidate(Uri), invalidate(File)
  - invalidate
```
public void invalidate(File file)
```
    Invalidate all memory cached images for the specified file.
    
    See Also:
    invalidate(Uri), invalidate(String)
  - isDebugging
```
@Deprecated
public boolean isDebugging()
```
    Deprecated. Use areIndicatorsEnabled() and isLoggingEnabled() instead.
    
    true if debug display, logging, and statistics are enabled.
  - setDebugging
```
@Deprecated
public void setDebugging(boolean debugging)
```
    Deprecated. Use setIndicatorsEnabled(boolean) and setLoggingEnabled(boolean) instead.
    
    Toggle whether debug display, logging, and statistics are enabled.
  - setIndicatorsEnabled
```
public void setIndicatorsEnabled(boolean enabled)
```
    Toggle whether to display debug indicators on images.
  - areIndicatorsEnabled
```
public boolean areIndicatorsEnabled()
```
    true if debug indicators should are displayed on images.
  - setLoggingEnabled
```
public void setLoggingEnabled(boolean enabled)
```
    Toggle whether debug logging is enabled.
    WARNING: Enabling this will result in excessive object allocation. This should be only be used for debugging Picasso behavior. Do NOT pass BuildConfig.DEBUG.
  - isLoggingEnabled
```
public boolean isLoggingEnabled()
```
    true if debug logging is enabled.
  - getSnapshot
```
public StatsSnapshot getSnapshot()
```
    Creates a StatsSnapshot of the current stats for this instance.
    NOTE: The snapshot may not always be completely up-to-date if requests are still in progress.
  - shutdown
```
public void shutdown()
```
    Stops this instance from accepting further requests.
  - with
```
public static Picasso with(android.content.Context context)
```
    The global default Picasso instance.
    This instance is automatically initialized with defaults that are suitable to most implementations.
    - LRU memory cache of 15% the available application RAM
    - Disk cache of 2% storage space up to 50MB but no less than 5MB. (Note: this is only available on API 14+ or if you are using a standalone library that provides a disk cache on all API levels like OkHttp)
    - Three download threads for disk and network access.
    If these settings do not meet the requirements of your application you can construct your own with full control over the configuration by using Picasso.Builder to create a Picasso instance. You can either use this directly or by setting it as the global instance with setSingletonInstance(com.squareup.picasso.Picasso).
  - setSingletonInstance
```
public static void setSingletonInstance(Picasso picasso)
```
    Set the global instance returned from with(android.content.Context).
    This method must be called before any calls to with(android.content.Context) and may only be called once.

Class Picasso

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

cancelRequest

cancelRequest

cancelRequest

cancelTag

pauseTag

resumeTag

load

load

load

load

invalidate

invalidate

invalidate

isDebugging

setDebugging

setIndicatorsEnabled

areIndicatorsEnabled

setLoggingEnabled

isLoggingEnabled

getSnapshot

shutdown

with

setSingletonInstance