org.eclipse.sisu.inject.MildKeys Maven / Gradle / Ivy
/*
* Copyright (c) 2010-2024 Sonatype, Inc.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* Stuart McCulloch (Sonatype, Inc.) - initial API and implementation
*/
package org.eclipse.sisu.inject;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;
import java.util.AbstractSet;
import java.util.Collection;
import java.util.Iterator;
import java.util.Map;
import java.util.NoSuchElementException;
import java.util.Set;
/**
* NON-thread-safe {@link Map} whose keys are kept alive by soft/weak {@link Reference}s.
*/
class MildKeys
implements Map
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
final ReferenceQueue queue = new ReferenceQueue();
final Map, V> map;
private final boolean soft;
// ----------------------------------------------------------------------
// Constructors
// ----------------------------------------------------------------------
MildKeys( final Map, V> map, final boolean soft )
{
this.map = map;
this.soft = soft;
}
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
public final boolean containsKey( final Object key )
{
// skip compact for performance reasons
return map.containsKey( tempKey( key ) );
}
public final boolean containsValue( final Object value )
{
// skip compact for performance reasons
return map.containsValue( value );
}
public final V get( final Object key )
{
// skip compact for performance reasons
return map.get( tempKey( key ) );
}
public final V put( final K key, final V value )
{
compact();
return map.put( mildKey( key ), value );
}
public final void putAll( final Map m )
{
compact();
for ( final Entry e : m.entrySet() )
{
map.put( mildKey( e.getKey() ), e.getValue() );
}
}
public final V remove( final Object key )
{
compact();
return map.remove( tempKey( key ) );
}
public final void clear()
{
map.clear();
compact();
}
public final boolean isEmpty()
{
compact();
return map.isEmpty();
}
public final int size()
{
compact();
return map.size();
}
public final Set keySet()
{
compact();
return new AbstractSet()
{
@Override
public Iterator iterator()
{
return new KeyItr();
}
@Override
public int size()
{
return map.size();
}
};
}
public final Collection values()
{
compact();
return map.values();
}
public final Set> entrySet()
{
compact();
return new AbstractSet>()
{
@Override
public Iterator> iterator()
{
return new EntryItr();
}
@Override
public int size()
{
return map.size();
}
};
}
// ----------------------------------------------------------------------
// Implementation methods
// ----------------------------------------------------------------------
/**
* @return Soft or weak {@link Reference} for the given key.
*/
final Reference mildKey( final K key )
{
return soft ? new Soft( key, queue ) : new Weak( key, queue );
}
/**
* @return Temporary {@link Reference} for the given key; used in queries.
*/
static final Reference tempKey( final K key )
{
return new Weak( key, null );
}
/**
* Compacts the map by removing cleared keys.
*/
final void compact()
{
for ( Reference ref; ( ref = queue.poll() ) != null; )
{
map.remove( ref );
}
}
// ----------------------------------------------------------------------
// Implementation types
// ----------------------------------------------------------------------
/**
* Soft key that maintains a constant hash and uses referential equality.
*/
static class Soft
extends SoftReference
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
private final int hash;
// ----------------------------------------------------------------------
// Constructors
// ----------------------------------------------------------------------
Soft( final T o, final ReferenceQueue queue )
{
super( o, queue );
hash = o.hashCode();
}
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
@Override
public final int hashCode()
{
return hash;
}
@Override
public final boolean equals( final Object rhs )
{
if ( this == rhs )
{
return true; // exact same reference
}
final T o = get();
if ( null != o && rhs instanceof Reference )
{
// different reference, but same referent
return o == ( (Reference) rhs ).get();
}
return false;
}
}
/**
* Weak key that maintains a constant hash and uses referential equality.
*/
static class Weak
extends WeakReference
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
private final int hash;
// ----------------------------------------------------------------------
// Constructors
// ----------------------------------------------------------------------
Weak( final T o, final ReferenceQueue queue )
{
super( o, queue );
hash = o.hashCode();
}
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
@Override
public final int hashCode()
{
return hash;
}
@Override
public final boolean equals( final Object rhs )
{
if ( this == rhs )
{
return true; // exact same reference
}
final T o = get();
if ( null != o && rhs instanceof Reference )
{
// different reference, but same referent
return o == ( (Reference) rhs ).get();
}
return false;
}
}
/**
* {@link Iterator} that iterates over reachable keys in the map.
*/
final class KeyItr
implements Iterator
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
private final Iterator> itr = map.keySet().iterator();
private K nextKey;
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
public boolean hasNext()
{
// find next key that is still reachable
while ( null == nextKey && itr.hasNext() )
{
nextKey = itr.next().get();
}
return null != nextKey;
}
public K next()
{
if ( hasNext() )
{
// populated by hasNext()
final K key = nextKey;
nextKey = null;
return key;
}
throw new NoSuchElementException();
}
public void remove()
{
itr.remove();
}
}
/**
* {@link Iterator} that iterates over reachable entries in the map.
*/
final class EntryItr
implements Iterator>
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
private final Iterator, V>> itr = map.entrySet().iterator();
private Entry, V> nextEntry;
private K nextKey;
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
public boolean hasNext()
{
// find next entry that is still reachable
while ( null == nextKey && itr.hasNext() )
{
nextEntry = itr.next();
nextKey = nextEntry.getKey().get();
}
return null != nextKey;
}
public Entry next()
{
if ( hasNext() )
{
// populated by hasNext()
final Entry entry = new StrongEntry( nextEntry, nextKey );
nextEntry = null;
nextKey = null;
return entry;
}
throw new NoSuchElementException();
}
public void remove()
{
itr.remove();
}
}
/**
* {@link Entry} that delegates to the original entry, but maintains a strong reference to the key.
*/
final class StrongEntry
implements Entry
{
// ----------------------------------------------------------------------
// Implementation fields
// ----------------------------------------------------------------------
private final Entry, V> entry;
private final K key;
// ----------------------------------------------------------------------
// Constructors
// ----------------------------------------------------------------------
StrongEntry( final Entry, V> entry, final K key )
{
this.entry = entry;
this.key = key;
}
// ----------------------------------------------------------------------
// Public methods
// ----------------------------------------------------------------------
public K getKey()
{
return key;
}
public V getValue()
{
return entry.getValue();
}
public V setValue( final V value )
{
return entry.setValue( value );
}
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy