com.nostra13.universalimageloader.core.download

类 BaseImageDownloader

java.lang.Object

com.nostra13.universalimageloader.core.download.BaseImageDownloader

所有已实现的接口:

ImageDownloader

public class BaseImageDownloader
extends Object
implements ImageDownloader

Provides retrieving of InputStream of image by URI from network or file system or app resources.
URLConnection is used to retrieve image stream from network.

从以下版本开始:

1.8.0

嵌套类概要

从接口继承的嵌套类/接口 com.nostra13.universalimageloader.core.download.ImageDownloader

ImageDownloader.Scheme

字段概要

字段

限定符和类型	字段和说明
protected static String	ALLOWED_URI_CHARS "@#&=*+-_.,:!?()/~\'%"
protected static int	BUFFER_SIZE 32768
protected int	connectTimeout
protected static String	CONTENT_CONTACTS_URI_PREFIX
protected android.content.Context	context
static int	DEFAULT_HTTP_CONNECT_TIMEOUT 5000
static int	DEFAULT_HTTP_READ_TIMEOUT 20000
protected static int	MAX_REDIRECT_COUNT
protected int	readTimeout

构造器概要

构造器

构造器和说明
BaseImageDownloader(android.content.Context context)
BaseImageDownloader(android.content.Context context, int connectTimeout, int readTimeout)

方法概要

限定符和类型	方法和说明
protected HttpURLConnection	createConnection(String url, Object extra) Create HTTP connection for incoming URL
protected InputStream	getContactPhotoStream(android.net.Uri uri)
InputStream	getStream(String imageUri, Object extra) Retrieves InputStream of image by URI.
protected InputStream	getStreamFromAssets(String imageUri, Object extra) Retrieves InputStream of image by URI (image is located in assets of application).
protected InputStream	getStreamFromContent(String imageUri, Object extra) Retrieves InputStream of image by URI (image is accessed using ContentResolver).
protected InputStream	getStreamFromDrawable(String imageUri, Object extra) Retrieves InputStream of image by URI (image is located in drawable resources of application).
protected InputStream	getStreamFromFile(String imageUri, Object extra) Retrieves InputStream of image by URI (image is located on the local file system or SD card).
protected InputStream	getStreamFromNetwork(String imageUri, Object extra) Retrieves InputStream of image by URI (image is located in the network).
protected InputStream	getStreamFromOtherSource(String imageUri, Object extra) Retrieves InputStream of image by URI from other source with unsupported scheme.
protected boolean	shouldBeProcessed(HttpURLConnection conn)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

DEFAULT_HTTP_CONNECT_TIMEOUT

public static final int DEFAULT_HTTP_CONNECT_TIMEOUT

5000

另请参阅:

常量字段值

DEFAULT_HTTP_READ_TIMEOUT

public static final int DEFAULT_HTTP_READ_TIMEOUT

20000

另请参阅:

常量字段值

BUFFER_SIZE

protected static final int BUFFER_SIZE

32768

另请参阅:

常量字段值

ALLOWED_URI_CHARS

protected static final String ALLOWED_URI_CHARS

"@#&=*+-_.,:!?()/~\'%"

另请参阅:

常量字段值

MAX_REDIRECT_COUNT

protected static final int MAX_REDIRECT_COUNT

另请参阅:

常量字段值

CONTENT_CONTACTS_URI_PREFIX

protected static final String CONTENT_CONTACTS_URI_PREFIX

另请参阅:

常量字段值

context

protected final android.content.Context context

connectTimeout

protected final int connectTimeout

readTimeout

protected final int readTimeout

构造器详细资料

BaseImageDownloader

public BaseImageDownloader(android.content.Context context)

BaseImageDownloader

public BaseImageDownloader(android.content.Context context,
                           int connectTimeout,
                           int readTimeout)

方法详细资料

getStream

public InputStream getStream(String imageUri,
                             Object extra)
                      throws IOException

从接口复制的说明: ImageDownloader

Retrieves InputStream of image by URI.

指定者:

getStream 在接口中 ImageDownloader

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

IOException - if some I/O error occurs during getting image stream

getStreamFromNetwork

protected InputStream getStreamFromNetwork(String imageUri,
                                           Object extra)
                                    throws IOException

Retrieves InputStream of image by URI (image is located in the network).

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

IOException - if some I/O error occurs during network request or if no InputStream could be created for URL.

shouldBeProcessed

protected boolean shouldBeProcessed(HttpURLConnection conn)
                             throws IOException

参数:

conn - Opened request connection (response code is available)

返回:

true - if data from connection is correct and should be read and processed; false - if response contains irrelevant data and shouldn't be processed

抛出:

IOException

createConnection

protected HttpURLConnection createConnection(String url,
                                             Object extra)
                                      throws IOException

Create HTTP connection for incoming URL

参数:

url - URL to connect to

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

Connection for incoming URL. Connection isn't established so it still configurable.

抛出:

IOException - if some I/O error occurs during network request or if no InputStream could be created for URL.

getStreamFromFile

protected InputStream getStreamFromFile(String imageUri,
                                        Object extra)
                                 throws IOException

Retrieves InputStream of image by URI (image is located on the local file system or SD card).

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

IOException - if some I/O error occurs reading from file system

getStreamFromContent

protected InputStream getStreamFromContent(String imageUri,
                                           Object extra)
                                    throws FileNotFoundException

Retrieves InputStream of image by URI (image is accessed using ContentResolver).

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

FileNotFoundException - if the provided URI could not be opened

getContactPhotoStream

protected InputStream getContactPhotoStream(android.net.Uri uri)

getStreamFromAssets

protected InputStream getStreamFromAssets(String imageUri,
                                          Object extra)
                                   throws IOException

Retrieves InputStream of image by URI (image is located in assets of application).

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

IOException - if some I/O error occurs file reading

getStreamFromDrawable

protected InputStream getStreamFromDrawable(String imageUri,
                                            Object extra)

Retrieves InputStream of image by URI (image is located in drawable resources of application).

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

getStreamFromOtherSource

protected InputStream getStreamFromOtherSource(String imageUri,
                                               Object extra)
                                        throws IOException

Retrieves InputStream of image by URI from other source with unsupported scheme. Should be overriden by successors to implement image downloading from special sources.
This method is called only if image URI has unsupported scheme. Throws UnsupportedOperationException by default.

参数:

imageUri - Image URI

extra - Auxiliary object which was passed to DisplayImageOptions.extraForDownloader(Object); can be null

返回:

InputStream of image

抛出:

IOException - if some I/O error occurs

UnsupportedOperationException - if image URI has unsupported scheme(protocol)