JakeWharton /DiskLruCache
Java implementation of a Disk-based LRU cache which specifically targets Android compatibility.
★ 5,763⑂ 1,161👁 1⑃ 50● 56▤ 0
+0
Daily
5,763
stars
1,161
forks
1
watchers
50
prs
56
issues
0
releases
README
Disk LRU Cache
==============
A cache that uses a bounded amount of space on a filesystem. Each cache entry
has a string key and a fixed number of values. Each key must match the regex
[a-z0-9_-]{1,120}. Values are byte sequences, accessible as streams or files.
Each value must be between 0 and Integer.MAX_VALUE bytes in length.
The cache stores its data in a directory on the filesystem. This directory must
be exclusive to the cache; the cache may delete or overwrite files from its
directory. It is an error for multiple processes to use the same cache
directory at the same time.
This cache limits the number of bytes that it will store on the filesystem.
When the number of stored bytes exceeds the limit, the cache will remove
entries in the background until the limit is satisfied. The limit is not
strict: the cache may temporarily exceed it while waiting for files to be
deleted. The limit does not include filesystem overhead or the cache journal so
space-sensitive applications should set a conservative limit.
Clients call edit to create or update the values of an entry. An entry may
have only one editor at one time; if a value is not available to be edited then
edit will return null.
When an entry is being created it is necessary to supply a full set of
values; the empty value should be used as a placeholder if necessary.
When an entry is being edited, it is not necessary to supply data for
every value; values default to their previous value.
Every edit call must be matched by a call to Editor.commit or
Editor.abort. Committing is atomic: a read observes the full set of values as
they were before or after the commit, but never a mix of values.
Clients call get to read a snapshot of an entry. The read will observe the
value at the time that get was called. Updates and removals after the call do
not impact ongoing reads.
This class is tolerant of some I/O errors. If files are missing from the
filesystem, the corresponding entries will be dropped from the cache. If an
error occurs while writing a cache value, the edit will fail silently. Callers
should handle other problems by catching IOException and responding
appropriately.
Note: This implementation specifically targets Android compatibility.
Download
========
Download [the latest .jar][jar] or grab via Maven:
xml
com.jakewharton
disklrucache
2.0.2
or Gradle:
groovy
compile 'com.jakewharton:disklrucache:2.0.2'
Snapshots of the development version are available in [Sonatype's snapshots repository][snap].
If you would like to compile your own version, the library can be built by
running mvn clean verify. The output JAR will be in the target/ directory.
(Note: this requires Maven be installed)
License
=======
Copyright 2012 Jake Wharton
Copyright 2011 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of thTop issues
#52Journal READ Corruption Issue9 comments · 2014-01-16#70Silent commit failure due to ignore renameTo return value7 comments · 2014-08-24#16Lost cache in some condition7 comments · 2012-09-18#49I get this error: "Caused by: java.io.IOException: failed to delete file: /mnt/sdcard/Android/data/mypackage/cache/media/361bd6dab3696905ef0139a9e9969820a98218 83b4b8d0d014bdf3f7f313eede.0"6 comments · 2013-11-18#81Multi-thread: Infinite loop in trimToSize5 comments · 2015-05-15#7Editor edit(String key, long expectedSequenceNumber) should throw ConcurrentModificationException3 comments · 2012-07-13#85max size doesn't take in consideration minimum 4kb block size.2 comments · 2015-11-26#76Total number of files limit of FAT filesystem2 comments · 2014-11-28