Lucene.Net  3.0.3
Lucene.Net is a port of the Lucene search engine library, written in C# and targeted at .NET runtime users.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Properties Pages
Public Member Functions | List of all members
Lucene.Net.Util.CloseableThreadLocal Class Reference

Java's builtin ThreadLocal has a serious flaw: it can take an arbitrarily long amount of time to dereference the things you had stored in it, even once the ThreadLocal instance itself is no longer referenced. This is because there is single, master map stored for each thread, which all ThreadLocals share, and that master map only periodically purges "stale" entries. More...

Public Member Functions

virtual System.Object InitialValue ()
 
virtual System.Object Get ()
 
virtual void Set (System.Object object_Renamed)
 
virtual void Close ()
 

Detailed Description

Java's builtin ThreadLocal has a serious flaw: it can take an arbitrarily long amount of time to dereference the things you had stored in it, even once the ThreadLocal instance itself is no longer referenced. This is because there is single, master map stored for each thread, which all ThreadLocals share, and that master map only periodically purges "stale" entries.

While not technically a memory leak, because eventually the memory will be reclaimed, it can take a long time and you can easily hit OutOfMemoryError because from the GC's standpoint the stale entries are not reclaimaible.

This class works around that, by only enrolling WeakReference values into the ThreadLocal, and separately holding a hard reference to each stored value. When you call close, these hard references are cleared and then GC is freely able to reclaim space by objects stored in it.

Definition at line 44 of file CloseableThreadLocal-old.cs.

Member Function Documentation

virtual void Lucene.Net.Util.CloseableThreadLocal.Close ( )
virtual

Definition at line 98 of file CloseableThreadLocal-old.cs.

virtual System.Object Lucene.Net.Util.CloseableThreadLocal.Get ( )
virtual

Definition at line 55 of file CloseableThreadLocal-old.cs.

virtual System.Object Lucene.Net.Util.CloseableThreadLocal.InitialValue ( )
virtual

Definition at line 50 of file CloseableThreadLocal-old.cs.

virtual void Lucene.Net.Util.CloseableThreadLocal.Set ( System.Object  object_Renamed)
virtual

Definition at line 80 of file CloseableThreadLocal-old.cs.


The documentation for this class was generated from the following file: