Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 105 lines (64 sloc) 3.8 kB
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
1 clojure.core.cache
2 ========================================
2715844 @fogus Importing Clache without LIRS and Soft caches. The former is awaitin…
fogus authored
3
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
4 core.cache is a new Clojure contrib library providing the following features:
2715844 @fogus Importing Clache without LIRS and Soft caches. The former is awaitin…
fogus authored
5
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
6 * An underlying `CacheProtocol` used as the base abstraction for implementing new synchronous caches
878fd3e @fogus more information into the readme
fogus authored
7
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
8 * A `defcache` macro for hooking your `CacheProtocol` implementations into the Clojure associative data capabilities.
878fd3e @fogus more information into the readme
fogus authored
9
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
10 * Implementations of some basic caching strategies
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
11 - First-in-first-out (FIFOCache)
12 - Least-recently-used (LRUCache)
13 - Least-used (LUCache)
14 - Time-to-live (TTLCache)
15 - Naive cache (BasicCache)
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
16 - Naive cache backed with soft references (SoftCache)
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
17
18 * Implementation of an efficient buffer replacement policy based on the *low inter-reference recency set* algorithm (LIRSCache) described in the [LIRS](http://citeseer.ist.psu.edu/viewdoc/summary?doi=10.1.1.116.2184) paper
19
20 * Factory functions for each existing cache type
21
22 core.cache is based on a library named Clache, found at http://github.com/fogus/clache that is planned for deprecation.
23
24
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
25 Releases and Dependency Information
26 ========================================
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
27
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
28 Latest stable release: 0.6.2
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
29
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
30 * [All Released Versions](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.clojure%22%20AND%20a%3A%22core.cache%22)
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
31
a810263 @fogus Tiny tweaks to README
fogus authored
32 * [Development Snapshot Versions](https://oss.sonatype.org/index.html#nexus-search;gav~org.clojure~core.cache~~~)
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
33
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
34 [Leiningen](https://github.com/technomancy/leiningen) dependency information:
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
35
e2c7f42 @fogus readme tyweaks
fogus authored
36 [org.clojure/core.cache "0.6.2"]
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
37
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
38 [Maven](http://maven.apache.org/) dependency information:
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
39
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
40 <dependency>
41 <groupId>org.clojure</groupId>
42 <artifactId>core.cache</artifactId>
43 <version>0.6.2</version>
44 </dependency>
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
45
46
47
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
48 Example Usage
49 ========================================
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
50
9efe278 @fogus readme tyweaks
fogus authored
51 ```clojure
a810263 @fogus Tiny tweaks to README
fogus authored
52 (require '[clojure.core.cache :as cache])
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
53
54 (def C (cache/fifo-cache-factory {:a 1, :b 2})
55
56 (if (cache/has? C :c)
57 (cache/hit C :c)
58 (cache/miss C :c 42))
59
60 ;=> {:a 1, :b 2, :c 42}
61
62 (cache/evict C :b)
63
64 ;=> {:a 1}
9efe278 @fogus readme tyweaks
fogus authored
65 ```
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
66
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
67 Refer to docstrings in the `clojure.core.cache` namespace, or the [autogenerated API documentation](http://clojure.github.com/core.cache/) for additional documentation
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
68
69
70
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
71 Developer Information
72 ========================================
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
73
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
74 * [GitHub project](https://github.com/clojure/core.cache)
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
75
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
76 * [Bug Tracker](http://dev.clojure.org/jira/browse/CCACHE)
878fd3e @fogus more information into the readme
fogus authored
77
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
78 * [Continuous Integration](http://build.clojure.org/job/core.cache/)
878fd3e @fogus more information into the readme
fogus authored
79
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
80 * [Compatibility Test Matrix](http://build.clojure.org/job/core.cache-test-matrix/)
878fd3e @fogus more information into the readme
fogus authored
81
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
82
878fd3e @fogus more information into the readme
fogus authored
83
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
84 Change Log
85 ====================
2715844 @fogus Importing Clache without LIRS and Soft caches. The former is awaitin…
fogus authored
86
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
87 * Release 0.6.2 on 2012.08.07 [more information](http://blog.fogus.me/?p=4527)
88 * Removed reflection warnings
89 * Fixed eviction of items from LU, TTL and LRU caches with thresholds less than two
90 * Fixed eviction of items from FIFO cache prior to threshold
91 * Release 0.6.1 on 2012.07.13 [more information](http://blog.fogus.me/2012/07/13/announcing-core-cache-version-0-6-1/)
92 * Added SoftCache
93 * Fixed eviction of items from LU and LRU caches prior to threshold
94 * Adjusted default thresholds in factory functions
95 * Release 0.5.0 on 2011.12.13 [more information](http://blog.fogus.me/2011/12/13/announcing-core-cache-v0-5-0/)
96 * Added `evict`
97 * Added cache factory functions
98 * Added associatve operation support
d4cfdc5 @fogus CCACHE-6: Added relevant info to README and release-notes
fogus authored
99
2715844 @fogus Importing Clache without LIRS and Soft caches. The former is awaitin…
fogus authored
100
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
101 Copyright and License
102 ========================================
2715844 @fogus Importing Clache without LIRS and Soft caches. The former is awaitin…
fogus authored
103
8c22ef1 @fogus Modified FifoCache to respect threshold. Modified README to conform …
fogus authored
104 Copyright (c) Rich Hickey, Michael Fogus and contributors, 2012. All rights reserved. The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php) which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound bythe terms of this license. You must not remove this notice, or any other, from this software.
Something went wrong with that request. Please try again.