View Javadoc
1   /**
2    *    Copyright 2009-2015 the original author or authors.
3    *
4    *    Licensed under the Apache License, Version 2.0 (the "License");
5    *    you may not use this file except in compliance with the License.
6    *    You may obtain a copy of the License at
7    *
8    *       http://www.apache.org/licenses/LICENSE-2.0
9    *
10   *    Unless required by applicable law or agreed to in writing, software
11   *    distributed under the License is distributed on an "AS IS" BASIS,
12   *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   *    See the License for the specific language governing permissions and
14   *    limitations under the License.
15   */
16  package org.apache.ibatis.cache.decorators;
17  
18  import java.lang.ref.ReferenceQueue;
19  import java.lang.ref.WeakReference;
20  import java.util.Deque;
21  import java.util.LinkedList;
22  import java.util.concurrent.locks.ReadWriteLock;
23  
24  import org.apache.ibatis.cache.Cache;
25  
26  /**
27   * Weak Reference cache decorator.
28   * Thanks to Dr. Heinz Kabutz for his guidance here.
29   * 
30   * @author Clinton Begin
31   */
32  public class WeakCache implements Cache {
33    private final Deque<Object> hardLinksToAvoidGarbageCollection;
34    private final ReferenceQueue<Object> queueOfGarbageCollectedEntries;
35    private final Cache delegate;
36    private int numberOfHardLinks;
37  
38    public WeakCache(Cache delegate) {
39      this.delegate = delegate;
40      this.numberOfHardLinks = 256;
41      this.hardLinksToAvoidGarbageCollection = new LinkedList<Object>();
42      this.queueOfGarbageCollectedEntries = new ReferenceQueue<Object>();
43    }
44  
45    @Override
46    public String getId() {
47      return delegate.getId();
48    }
49  
50    @Override
51    public int getSize() {
52      removeGarbageCollectedItems();
53      return delegate.getSize();
54    }
55  
56    public void setSize(int size) {
57      this.numberOfHardLinks = size;
58    }
59  
60    @Override
61    public void putObject(Object key, Object value) {
62      removeGarbageCollectedItems();
63      delegate.putObject(key, new WeakEntry(key, value, queueOfGarbageCollectedEntries));
64    }
65  
66    @Override
67    public Object getObject(Object key) {
68      Object result = null;
69      @SuppressWarnings("unchecked") // assumed delegate cache is totally managed by this cache
70      WeakReference<Object> weakReference = (WeakReference<Object>) delegate.getObject(key);
71      if (weakReference != null) {
72        result = weakReference.get();
73        if (result == null) {
74          delegate.removeObject(key);
75        } else {
76          hardLinksToAvoidGarbageCollection.addFirst(result);
77          if (hardLinksToAvoidGarbageCollection.size() > numberOfHardLinks) {
78            hardLinksToAvoidGarbageCollection.removeLast();
79          }
80        }
81      }
82      return result;
83    }
84  
85    @Override
86    public Object removeObject(Object key) {
87      removeGarbageCollectedItems();
88      return delegate.removeObject(key);
89    }
90  
91    @Override
92    public void clear() {
93      hardLinksToAvoidGarbageCollection.clear();
94      removeGarbageCollectedItems();
95      delegate.clear();
96    }
97  
98    @Override
99    public ReadWriteLock getReadWriteLock() {
100     return null;
101   }
102 
103   private void removeGarbageCollectedItems() {
104     WeakEntry sv;
105     while ((sv = (WeakEntry) queueOfGarbageCollectedEntries.poll()) != null) {
106       delegate.removeObject(sv.key);
107     }
108   }
109 
110   private static class WeakEntry extends WeakReference<Object> {
111     private final Object key;
112 
113     private WeakEntry(Object key, Object value, ReferenceQueue<Object> garbageCollectionQueue) {
114       super(value, garbageCollectionQueue);
115       this.key = key;
116     }
117   }
118 
119 }