|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.nostra13.universalimageloader.core.ImageLoader
public class ImageLoader
Singletone for image loading and displaying at ImageViews
NOTE: init(ImageLoaderConfiguration)
method must be called before any other method.
Field Summary | |
---|---|
static java.lang.String |
TAG
|
Constructor Summary | |
---|---|
protected |
ImageLoader()
|
Method Summary | |||
---|---|---|---|
void |
cancelDisplayTask(ImageAware imageAware)
Cancel the task of loading and displaying image for passed ImageAware . |
||
void |
cancelDisplayTask(android.widget.ImageView imageView)
Cancel the task of loading and displaying image for passed ImageView . |
||
void |
clearDiscCache()
Clears disc cache. |
||
void |
clearMemoryCache()
Clears memory cache |
||
void |
denyNetworkDownloads(boolean denyNetworkDownloads)
Denies or allows ImageLoader to download images from the network. |
||
void |
destroy()
Stops ImageLoader and clears current configuration. |
||
void |
displayImage(java.lang.String uri,
ImageAware imageAware)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
ImageAware imageAware,
DisplayImageOptions options)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
ImageAware imageAware,
DisplayImageOptions options,
ImageLoadingListener listener)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
ImageAware imageAware,
ImageLoadingListener listener)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
android.widget.ImageView imageView)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
android.widget.ImageView imageView,
DisplayImageOptions options)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
android.widget.ImageView imageView,
DisplayImageOptions options,
ImageLoadingListener listener)
Adds display image task to execution pool. |
||
void |
displayImage(java.lang.String uri,
android.widget.ImageView imageView,
ImageLoadingListener listener)
Adds display image task to execution pool. |
||
DiscCacheAware |
getDiscCache()
Returns disc cache |
||
static ImageLoader |
getInstance()
Returns singleton class instance |
||
java.lang.String |
getLoadingUriForView(ImageAware imageAware)
Returns URI of image which is loading at this moment into passed ImageAware |
||
java.lang.String |
getLoadingUriForView(android.widget.ImageView imageView)
Returns URI of image which is loading at this moment into passed ImageView |
||
MemoryCacheAware<java.lang.String,android.graphics.Bitmap> |
getMemoryCache()
Returns memory cache |
||
void |
handleSlowNetwork(boolean handleSlowNetwork)
Sets option whether ImageLoader will use FlushedInputStream for network downloads to handle
|
void |
init(ImageLoaderConfiguration configuration)
Initializes ImageLoader instance with configuration. |
boolean |
isInited()
Returns true - if ImageLoader is initialized with configuration; false - otherwise |
||
void |
loadImage(java.lang.String uri,
DisplayImageOptions options,
ImageLoadingListener listener)
Adds load image task to execution pool. |
||
void |
loadImage(java.lang.String uri,
ImageLoadingListener listener)
Adds load image task to execution pool. |
||
void |
loadImage(java.lang.String uri,
ImageSize targetImageSize,
DisplayImageOptions options,
ImageLoadingListener listener)
Adds load image task to execution pool. |
||
void |
loadImage(java.lang.String uri,
ImageSize targetImageSize,
ImageLoadingListener listener)
Adds load image task to execution pool. |
||
android.graphics.Bitmap |
loadImageSync(java.lang.String uri)
Loads and decodes image synchronously. |
||
android.graphics.Bitmap |
loadImageSync(java.lang.String uri,
DisplayImageOptions options)
Loads and decodes image synchronously. |
||
android.graphics.Bitmap |
loadImageSync(java.lang.String uri,
ImageSize targetImageSize)
Loads and decodes image synchronously. |
||
android.graphics.Bitmap |
loadImageSync(java.lang.String uri,
ImageSize targetImageSize,
DisplayImageOptions options)
Loads and decodes image synchronously. |
||
void |
pause()
Pause ImageLoader. |
||
void |
resume()
Resumes waiting "load&display" tasks |
||
void |
stop()
Cancels all running and scheduled display image tasks. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String TAG
Constructor Detail |
---|
protected ImageLoader()
Method Detail |
---|
public static ImageLoader getInstance()
public void init(ImageLoaderConfiguration configuration)
isInited()
== true) then this method does nothing.
configuration
- ImageLoader configuration
java.lang.IllegalArgumentException
- if configuration parameter is nullpublic boolean isInited()
public void displayImage(java.lang.String uri, ImageAware imageAware)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageAware
- Image aware view
which should display image
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageAware is nullpublic void displayImage(java.lang.String uri, ImageAware imageAware, ImageLoadingListener listener)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageAware
- Image aware view
which should display imagelistener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageAware is nullpublic void displayImage(java.lang.String uri, ImageAware imageAware, DisplayImageOptions options)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageAware
- Image aware view
which should display imageoptions
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageAware is nullpublic void displayImage(java.lang.String uri, ImageAware imageAware, DisplayImageOptions options, ImageLoadingListener listener)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageAware
- Image aware view
which should display imageoptions
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.listener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageAware is nullpublic void displayImage(java.lang.String uri, android.widget.ImageView imageView)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageView
- ImageView
which should display image
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageView is nullpublic void displayImage(java.lang.String uri, android.widget.ImageView imageView, DisplayImageOptions options)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageView
- ImageView
which should display imageoptions
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageView is nullpublic void displayImage(java.lang.String uri, android.widget.ImageView imageView, ImageLoadingListener listener)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageView
- ImageView
which should display imagelistener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageView is nullpublic void displayImage(java.lang.String uri, android.widget.ImageView imageView, DisplayImageOptions options, ImageLoadingListener listener)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")imageView
- ImageView
which should display imageoptions
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.listener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called before
java.lang.IllegalArgumentException
- if passed imageView is nullpublic void loadImage(java.lang.String uri, ImageLoadingListener listener)
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap)
callback}.init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")listener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic void loadImage(java.lang.String uri, ImageSize targetImageSize, ImageLoadingListener listener)
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap)
callback}.init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")targetImageSize
- Minimal size for Bitmap
which will be returned in
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap) callback}. Downloaded image will be decoded
and scaled to Bitmap
of the size which is equal or larger (usually a bit larger) than
incoming targetImageSize.listener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic void loadImage(java.lang.String uri, DisplayImageOptions options, ImageLoadingListener listener)
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap)
callback}.init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")options
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.listener
- Listener for image loading process. Listener fires events on UI
thread.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic void loadImage(java.lang.String uri, ImageSize targetImageSize, DisplayImageOptions options, ImageLoadingListener listener)
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap)
callback}.init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")targetImageSize
- Minimal size for Bitmap
which will be returned in
ImageLoadingListener.onLoadingComplete(String, android.view.View, android.graphics.Bitmap) callback}. Downloaded image will be decoded
and scaled to Bitmap
of the size which is equal or larger (usually a bit larger) than
incoming targetImageSize.options
- Options for image
decoding and displaying. If null - default display image options
from
configuration will be used.listener
- Listener for image loading process. Listener fires events on UI
THREAD.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic android.graphics.Bitmap loadImageSync(java.lang.String uri)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic android.graphics.Bitmap loadImageSync(java.lang.String uri, DisplayImageOptions options)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")options
- Options for image
decoding and scaling. If null - default display image options
from
configuration will be used.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic android.graphics.Bitmap loadImageSync(java.lang.String uri, ImageSize targetImageSize)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")targetImageSize
- Minimal size for Bitmap
which will be returned. Downloaded image will be decoded
and scaled to Bitmap
of the size which is equal or larger (usually a bit
larger) than incoming targetImageSize.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic android.graphics.Bitmap loadImageSync(java.lang.String uri, ImageSize targetImageSize, DisplayImageOptions options)
init(ImageLoaderConfiguration)
method must be called before this method call
uri
- Image URI (i.e. "http://site.com/image.png", "file:///mnt/sdcard/image.png")targetImageSize
- Minimal size for Bitmap
which will be returned. Downloaded image will be decoded
and scaled to Bitmap
of the size which is equal or larger (usually a bit
larger) than incoming targetImageSize.options
- Options for image
decoding and scaling. If null - default display image options
from
configuration will be used.
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic MemoryCacheAware<java.lang.String,android.graphics.Bitmap> getMemoryCache()
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic void clearMemoryCache()
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic DiscCacheAware getDiscCache()
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic void clearDiscCache()
java.lang.IllegalStateException
- if init(ImageLoaderConfiguration)
method wasn't called beforepublic java.lang.String getLoadingUriForView(ImageAware imageAware)
ImageAware
public java.lang.String getLoadingUriForView(android.widget.ImageView imageView)
ImageView
public void cancelDisplayTask(ImageAware imageAware)
ImageAware
.
imageAware
- ImageAware
for
which display task will be cancelledpublic void cancelDisplayTask(android.widget.ImageView imageView)
ImageView
.
imageView
- ImageView
for which display task will be cancelledpublic void denyNetworkDownloads(boolean denyNetworkDownloads)
ImageLoadingListener.onLoadingFailed(String, View, FailReason)
callback will be fired with
FailReason.FailType#NETWORK_DENIED
denyNetworkDownloads
- pass true - to deny engine to download images from the network; false -
to allow engine to download images from network.public void handleSlowNetwork(boolean handleSlowNetwork)
FlushedInputStream
for network downloads to handle this known problem or not.
handleSlowNetwork
- pass true - to use FlushedInputStream
for network downloads; false
- otherwise.public void pause()
resumed
.
public void resume()
public void stop()
public void destroy()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |