Package com.hazelcast.core
Interface DistributedObject
- All Known Subinterfaces:
BaseMap<K,V>
,BaseMultiMap<K,V>
,BaseQueue<E>
,CardinalityEstimator
,DurableExecutorService
,FencedLock
,FlakeIdGenerator
,HazelcastXAResource
,IAtomicLong
,IAtomicReference<E>
,ICache<K,V>
,ICollection<E>
,ICountDownLatch
,IExecutorService
,IList<E>
,IMap<K,V>
,IQueue<E>
,IScheduledExecutorService
,ISemaphore
,ISet<E>
,ITopic<E>
,MultiMap<K,V>
,PNCounter
,PrefixedDistributedObject
,ReplicatedMap<K,V>
,Ringbuffer<E>
,TransactionalList<E>
,TransactionalMap<K,V>
,TransactionalMultiMap<K,V>
,TransactionalObject
,TransactionalQueue<E>
,TransactionalSet<E>
public interface DistributedObject
Base interface for all distributed objects.
All distributed objects are not garbage collectable unless
destroy()
is called first.
Note: Failure to destroy after you are done using a distributed object will lead to memory leaks.- See Also:
IMap
,IQueue
,MultiMap
,ITopic
,IExecutorService
,TransactionalMap
,TransactionalQueue
,TransactionalMultiMap
-
Method Summary
Modifier and Type Method Description void
destroy()
Destroys this object cluster-wide.String
getName()
Returns the unique name for this DistributedObject.String
getPartitionKey()
Returns the key of the partition that this DistributedObject is assigned to.String
getServiceName()
Returns the service name for this object.
-
Method Details
-
getPartitionKey
String getPartitionKey()Returns the key of the partition that this DistributedObject is assigned to. The returned value only has meaning for a non-partitioned data structure like anIAtomicLong
. For a partitioned data structure like anIMap
, the returned value will not be null, but otherwise undefined.- Returns:
- the partition key.
-
getName
String getName()Returns the unique name for this DistributedObject. The returned value will never be null. The suggested way for getting name is retrieving it throughDistributedObjectUtil.getName(DistributedObject)
because this might be also aPrefixedDistributedObject
.- Returns:
- the unique name for this object.
-
getServiceName
String getServiceName()Returns the service name for this object.- Returns:
- the service name for this object.
-
destroy
void destroy()Destroys this object cluster-wide. Clears and releases all resources for this object.
-