net.jini.core.lease

Interface LeaseMap<K,V>

Type Parameters:

K - key type

V - value type

All Superinterfaces:

Map<K,V>

All Known Implementing Classes:

AbstractIDLeaseMap, AbstractLeaseMap, ConstrainableLandlordLeaseMap, LandlordLeaseMap

public interface LeaseMap<K,V>
extends Map<K,V>

An Map from Lease to Long (the duration to use when renewing the lease). For all methods of LeaseMap except canContainKey, an IllegalArgumentException is thrown if a key is not a Lease or a value is not a Long. Null keys and values are not supported.

Since:

1.0

Author:

Sun Microsystems, Inc.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Method Summary

Modifier and Type	Method and Description
void	cancelAll() Cancels all leases in the LeaseMap.
boolean	canContainKey(Object key) Returns true if the given object is a Lease which can be renewed and cancelled in a batch with other leases in the map.
void	renewAll() Renews all leases in the LeaseMap, using their current values as the renewal durations.

Methods inherited from interface java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Method Detail

canContainKey

boolean canContainKey(Object key)

Returns true if the given object is a Lease which can be renewed and cancelled in a batch with other leases in the map. Whether or not two Lease objects can be batched is an implementation detail determined by the objects.

Parameters:

key - an object that should be a lease

Returns:

true if the lease can be renewed and cancelled in a a batch with other leases

See Also:

Lease.canBatch(net.jini.core.lease.Lease)

renewAll

void renewAll()
       throws LeaseMapException,
              RemoteException

Renews all leases in the LeaseMap, using their current values as the renewal durations. If all renewals are successful, returns normally. Otherwise, removes all leases that failed to renew from the LeaseMap, and throws LeaseMapException.

Throws:

LeaseMapException - if one or more lease renewals fail.

RemoteException - if a connection problem occurs.

cancelAll

void cancelAll()
        throws LeaseMapException,
               RemoteException

Cancels all leases in the LeaseMap. If all cancels are successful, returns normally (leaving all leases in the map). Otherwise, removes all leases that failed to cancel from the LeaseMap, and throws LeaseMapException.

Throws:

LeaseMapException - if one or more lease cancellations fail.

RemoteException - if a connection problem occurs.