cn.trinea.android.common.service.impl

类 ImageSDCardCache

java.lang.Object

cn.trinea.android.common.service.impl.SimpleCache<K,V>

cn.trinea.android.common.service.impl.PreloadDataCache<String,String>

cn.trinea.android.common.service.impl.ImageSDCardCache

所有已实现的接口:

Cache<String,String>, Serializable

public class ImageSDCardCache
extends PreloadDataCache<String,String>

Image SDCard Cache

It applies to images those uesd frequently and their size is big that we cannot store too much in memory, like pictures of twitter or sina weibo. Cache of small images you can consider of ImageMemoryCache.

Setting and Usage
• Use one of constructors in sections II to init cache
• setOnImageSDCallbackListener(OnImageSDCallbackListener) set callback interface when getting image
• get(String, List, View) get image asynchronous and preload other images asynchronous according to urlList
• get(String, View) get image asynchronous
• initData(Context, String) or loadDataFromDb(Context, String) to init data when app start, saveDataToDb(Context, String) to save data when app exit
• setFileNameRule(FileNameRule) set file name rule which be used when saving images, default is FileNameRuleImageUrl
• setCacheFolder(String) set cache folder path which be used when saving images, default is DEFAULT_CACHE_FOLDER
• setHttpReadTimeOut(int) set http read image time out, if less than 0, not set. default is not set
• setOpenWaitingQueue(boolean) set whether open waiting queue, default is true. If true, save all view waiting for image loaded, else only save the newest one
• PreloadDataCache.setOnGetDataListener(OnGetDataListener) set how to get image, this cache will get image and preload images by it
• SimpleCache.setCacheFullRemoveType(CacheFullRemoveType) set remove type when cache is full
• other see PreloadDataCache and SimpleCache

Constructor
• ImageSDCardCache()
• ImageSDCardCache(int)
• ImageSDCardCache(int, int)

Attentions
• You should add android.permission.WRITE_EXTERNAL_STORAGE in manifest, to store image to sdcard.
• You should add android.permission.ACCESS_NETWORK_STATE in manifest if you get image from network.

作者:

Trinea 2012-4-5

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	ImageSDCardCache.OnImageSDCallbackListener callback interface when getting image

从类继承的嵌套类/接口 cn.trinea.android.common.service.impl.PreloadDataCache

PreloadDataCache.OnGetDataListener<K,V>

字段概要

字段

限定符和类型	字段和说明
static String	DEFAULT_CACHE_FOLDER cache folder path which be used when saving images
static int	DEFAULT_MAX_SIZE recommend default max cache size according to dalvik max memory

从类继承的字段 cn.trinea.android.common.service.impl.PreloadDataCache

DEFAULT_BACKWARD_CACHE_NUMBER, DEFAULT_FORWARD_CACHE_NUMBER, DEFAULT_THREAD_POOL_SIZE, NETWORK_MOBILE, NETWORK_WIFI, onGetDataListener

从类继承的字段 cn.trinea.android.common.service.impl.SimpleCache

cache, hitCount, missCount

构造器概要

构造器

构造器和说明
ImageSDCardCache() Get data listener is getDefaultOnGetImageListener() callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener) Maximum size of the cache is DEFAULT_MAX_SIZE Elements of the cache will not invalid Remove type is RemoveTypeUsedCountSmall when cache is full
ImageSDCardCache(int maxSize) Get data listener is getDefaultOnGetImageListener() callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener) Elements of the cache will not invalid Remove type is RemoveTypeUsedCountSmall when cache is full
ImageSDCardCache(int maxSize, int threadPoolSize) Get data listener is getDefaultOnGetImageListener() callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener) Elements of the cache will not invalid Remove type is RemoveTypeUsedCountSmall when cache is full

方法概要

方法

限定符和类型	方法和说明
void	clear() delete file when clear cache
void	deleteUnusedFiles() delete unused file in getCacheFolder(), you can use it after loadDataFromDb(Context, String) at first time
protected CacheObject<String>	fullRemoveOne() delete file when full remove one
boolean	get(String imageUrl, List<String> urlList, android.view.View view) get image asynchronous and preload other images asynchronous according to urlList
boolean	get(String imageUrl, android.view.View view) get image asynchronous. when get image success, it will pass to ImageSDCardCache.OnImageSDCallbackListener.onGetSuccess(String, String, View, boolean)
String	getCacheFolder() get cache folder path which be used when saving images, default is DEFAULT_CACHE_FOLDER
PreloadDataCache.OnGetDataListener<String,String>	getDefaultOnGetImageListener() default get image listener
FileNameRule	getFileNameRule() get file name rule which be used when saving images, default is FileNameRuleImageUrl
int	getHttpReadTimeOut() get http read image time out, if less than 0, not set. default is not set
String	getImagePath(String imageUrl) get image file path
ImageSDCardCache.OnImageSDCallbackListener	getOnImageSDCallbackListener() get callback interface when getting image
Map<String,String>	getRequestProperties() get http request properties
void	initData(android.content.Context context, String tag) load all data from db and delete unused file in getCacheFolder() It's a combination of loadDataFromDb(Context, String) and deleteUnusedFiles() You should use saveDataToDb(Context, String) to save data when app exit
boolean	isOpenWaitingQueue() get whether open waiting queue, default is true.
static boolean	loadDataFromDb(android.content.Context context, ImageSDCardCache imageSDCardCache, String tag) load all data in db whose tag is same to tag to imageSDCardCache. just put, do not affect the original data Attentions: If imageSDCardCache is null, throws exception If tag is null or empty, throws exception You should use saveDataToDb(Context, ImageSDCardCache, String) to save data when app exit
boolean	loadDataFromDb(android.content.Context context, String tag) load all data in db whose tag is same to tag to imageSDCardCache. just put, do not affect the original data Attentions: If tag is null or empty, throws exception You should use saveDataToDb(Context, String) to save data when app exit
CacheObject<String>	remove(String key) delete file when remove
static boolean	saveDataToDb(android.content.Context context, ImageSDCardCache imageSDCardCache, String tag) delete all rows in db whose tag is same to tag at first, and insert all data in imageSDCardCache to db Attentions: If imageSDCardCache is null, throws exception If tag is null or empty, throws exception Will delete all rows in db whose tag is same to tag at first You can use initData(Context, String) or loadDataFromDb(Context, ImageSDCardCache, String) to init data when app start
boolean	saveDataToDb(android.content.Context context, String tag) delete all rows in db whose tag is same to tag at first, and insert all data in imageSDCardCache to db Attentions: If tag is null or empty, throws exception Will delete all rows in db whose tag is same to tag at first You can use initData(Context, String) or loadDataFromDb(Context, String) to init data when app start
void	setCacheFolder(String cacheFolder) set cache folder path which be used when saving images, default is DEFAULT_CACHE_FOLDER
void	setFileNameRule(FileNameRule fileNameRule) set file name rule which be used when saving images, default is FileNameRuleImageUrl
void	setHttpReadTimeOut(int readTimeOutMillis) set http read image time out, if less than 0, not set. default is not set, in mills
void	setOnImageSDCallbackListener(ImageSDCardCache.OnImageSDCallbackListener onImageSDCallbackListener) set callback interface when getting image
void	setOpenWaitingQueue(boolean isOpenWaitingQueue) set whether open waiting queue, default is true.
void	setRequestProperties(Map<String,String> requestProperties) set http request properties If image is from the different server, setRequestProperty("Connection", "false") is recommended.
void	setRequestProperty(String field, String newValue) Sets the value of the http request header field
protected void	shutdown()
List<Runnable>	shutdownNow()

从类继承的方法 cn.trinea.android.common.service.impl.PreloadDataCache

checkIsNetworkTypeAllowed, get, get, getAllowedNetworkTypes, getBackwardCacheNumber, getContext, getForwardCacheNumber, getOnGetDataListener, isCheckNetwork, isExistGettingDataThread, loadCache, preloadDataBackward, preloadDataForward, setAllowedNetworkTypes, setBackwardCacheNumber, setCheckNetwork, setContext, setForwardCacheNumber, setOnGetDataListener

从类继承的方法 cn.trinea.android.common.service.impl.SimpleCache

containsKey, entrySet, getCacheFullRemoveType, getHitCount, getHitRate, getMaxSize, getMissCount, getSize, getValidTime, isExpired, isExpired, keySet, put, put, putAll, removeExpired, saveCache, setCacheFullRemoveType, setUsedInfo, setValidTime, values

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

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

字段详细资料

DEFAULT_MAX_SIZE

public static final int DEFAULT_MAX_SIZE

recommend default max cache size according to dalvik max memory

DEFAULT_CACHE_FOLDER

public static final String DEFAULT_CACHE_FOLDER

cache folder path which be used when saving images

构造器详细资料

ImageSDCardCache

public ImageSDCardCache()

• Get data listener is getDefaultOnGetImageListener()
• callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener)
• Maximum size of the cache is DEFAULT_MAX_SIZE
• Elements of the cache will not invalid
• Remove type is RemoveTypeUsedCountSmall when cache is full

另请参阅:

PreloadDataCache.PreloadDataCache()

ImageSDCardCache

public ImageSDCardCache(int maxSize)

• Get data listener is getDefaultOnGetImageListener()
• callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener)
• Elements of the cache will not invalid
• Remove type is RemoveTypeUsedCountSmall when cache is full

参数:

maxSize - maximum size of the cache

另请参阅:

PreloadDataCache.PreloadDataCache(int)

ImageSDCardCache

public ImageSDCardCache(int maxSize,
                int threadPoolSize)

• Get data listener is getDefaultOnGetImageListener()
• callback interface when getting image is null, can set by setOnImageSDCallbackListener(OnImageSDCallbackListener)
• Elements of the cache will not invalid
• Remove type is RemoveTypeUsedCountSmall when cache is full

参数:

maxSize - maximum size of the cache

threadPoolSize - getting data thread pool size

另请参阅:

PreloadDataCache.PreloadDataCache(int, int)

方法详细资料

get

public boolean get(String imageUrl,
          android.view.View view)

get image asynchronous. when get image success, it will pass to ImageSDCardCache.OnImageSDCallbackListener.onGetSuccess(String, String, View, boolean)

参数:

imageUrl -

view -

返回:

whether image already in cache or not

get

public boolean get(String imageUrl,
          List<String> urlList,
          android.view.View view)

get image asynchronous and preload other images asynchronous according to urlList

参数:

imageUrl -

urlList - url list, if is null, not preload, else preload forward by PreloadDataCache.preloadDataForward(Object, List, int), preload backward by PreloadDataCache.preloadDataBackward(Object, List, int)

view -

返回:

whether image already in cache or not

getCacheFolder

public String getCacheFolder()

get cache folder path which be used when saving images, default is DEFAULT_CACHE_FOLDER

返回:

the cacheFolder

setCacheFolder

public void setCacheFolder(String cacheFolder)

set cache folder path which be used when saving images, default is DEFAULT_CACHE_FOLDER

参数:

cacheFolder -

getFileNameRule

public FileNameRule getFileNameRule()

get file name rule which be used when saving images, default is FileNameRuleImageUrl

返回:

the fileNameRule

setFileNameRule

public void setFileNameRule(FileNameRule fileNameRule)

set file name rule which be used when saving images, default is FileNameRuleImageUrl

参数:

fileNameRule -

getOnImageSDCallbackListener

public ImageSDCardCache.OnImageSDCallbackListener getOnImageSDCallbackListener()

get callback interface when getting image

返回:

the onImageSDCallbackListener

setOnImageSDCallbackListener

public void setOnImageSDCallbackListener(ImageSDCardCache.OnImageSDCallbackListener onImageSDCallbackListener)

set callback interface when getting image

参数:

onImageSDCallbackListener - the onImageSDCallbackListener to set

getHttpReadTimeOut

public int getHttpReadTimeOut()

get http read image time out, if less than 0, not set. default is not set

返回:

the httpReadTimeOut

setHttpReadTimeOut

public void setHttpReadTimeOut(int readTimeOutMillis)

set http read image time out, if less than 0, not set. default is not set, in mills

参数:

readTimeOutMillis -

isOpenWaitingQueue

public boolean isOpenWaitingQueue()

get whether open waiting queue, default is true. If true, save all view waiting for image loaded, else only save the newest one

返回:

setOpenWaitingQueue

public void setOpenWaitingQueue(boolean isOpenWaitingQueue)

set whether open waiting queue, default is true. If true, save all view waiting for image loaded, else only save the newest one

参数:

isOpenWaitingQueue -

setRequestProperties

public void setRequestProperties(Map<String,String> requestProperties)

set http request properties

• If image is from the different server, setRequestProperty("Connection", "false") is recommended. If image is from the same server, true is recommended, and this is the default value

参数:

requestProperties -

getRequestProperties

public Map<String,String> getRequestProperties()

get http request properties

返回:

setRequestProperty

public void setRequestProperty(String field,
                      String newValue)

Sets the value of the http request header field

参数:

field - the request header field to be set

newValue - the new value of the specified property

另请参阅:

#setRequestProperties(Map)}

shutdown

protected void shutdown()

覆盖:

shutdown 在类中 PreloadDataCache<String,String>

另请参阅:

ExecutorService.shutdown()

shutdownNow

public List<Runnable> shutdownNow()

覆盖:

shutdownNow 在类中 PreloadDataCache<String,String>

另请参阅:

ExecutorService.shutdownNow()

fullRemoveOne

protected CacheObject<String> fullRemoveOne()

delete file when full remove one

覆盖:

fullRemoveOne 在类中 SimpleCache<String,String>

返回:

the value of the removed or null if no element can be remove.

remove

public CacheObject<String> remove(String key)

delete file when remove

指定者:

remove 在接口中 Cache<String,String>

覆盖:

remove 在类中 SimpleCache<String,String>

返回:

the value of the removed or null if no mapping for the specified key was found.

clear

public void clear()

delete file when clear cache

指定者:

clear 在接口中 Cache<String,String>

覆盖:

clear 在类中 SimpleCache<String,String>

另请参阅:

Map.clear()

deleteUnusedFiles

public void deleteUnusedFiles()

delete unused file in getCacheFolder(), you can use it after loadDataFromDb(Context, String) at first time

initData

public void initData(android.content.Context context,
            String tag)

load all data from db and delete unused file in getCacheFolder()

• It's a combination of loadDataFromDb(Context, String) and deleteUnusedFiles()
• You should use saveDataToDb(Context, String) to save data when app exit

参数:

context -

tag -

另请参阅:

loadDataFromDb(Context, String), deleteUnusedFiles()

loadDataFromDb

public boolean loadDataFromDb(android.content.Context context,
                     String tag)

load all data in db whose tag is same to tag to imageSDCardCache. just put, do not affect the original data

Attentions:
• If tag is null or empty, throws exception
• You should use saveDataToDb(Context, String) to save data when app exit

参数:

context -

tag - tag used to mark this cache when save to and load from db, should be unique and cannot be null or empty

返回:

另请参阅:

loadDataFromDb(Context, ImageSDCardCache, String)

saveDataToDb

public boolean saveDataToDb(android.content.Context context,
                   String tag)

delete all rows in db whose tag is same to tag at first, and insert all data in imageSDCardCache to db

Attentions:
• If tag is null or empty, throws exception
• Will delete all rows in db whose tag is same to tag at first
• You can use initData(Context, String) or loadDataFromDb(Context, String) to init data when app start

参数:

context -

tag - tag used to mark this cache when save to and load from db, should be unique and cannot be null or empty

返回:

另请参阅:

saveDataToDb(Context, ImageSDCardCache, String)

loadDataFromDb

public static boolean loadDataFromDb(android.content.Context context,
                     ImageSDCardCache imageSDCardCache,
                     String tag)

load all data in db whose tag is same to tag to imageSDCardCache. just put, do not affect the original data

Attentions:
• If imageSDCardCache is null, throws exception
• If tag is null or empty, throws exception
• You should use saveDataToDb(Context, ImageSDCardCache, String) to save data when app exit

参数:

context -

imageSDCardCache -

tag - tag used to mark this cache when save to and load from db, should be unique and cannot be null or empty

返回:

saveDataToDb

public static boolean saveDataToDb(android.content.Context context,
                   ImageSDCardCache imageSDCardCache,
                   String tag)

delete all rows in db whose tag is same to tag at first, and insert all data in imageSDCardCache to db

Attentions:
• If imageSDCardCache is null, throws exception
• If tag is null or empty, throws exception
• Will delete all rows in db whose tag is same to tag at first
• You can use initData(Context, String) or loadDataFromDb(Context, ImageSDCardCache, String) to init data when app start

参数:

context -

imageSDCardCache -

tag - tag used to mark this cache when save to and load from db, should be unique and cannot be null or empty

返回:

getImagePath

public String getImagePath(String imageUrl)

get image file path

参数:

imageUrl -

返回:

if not in cache return null, else return full path.

getDefaultOnGetImageListener

public PreloadDataCache.OnGetDataListener<String,String> getDefaultOnGetImageListener()

default get image listener

返回: