GemFire 6.0.1

com.gemstone.gemfire.cache
Interface PartitionResolver<K,V>

All Superinterfaces:
CacheCallback

public interface PartitionResolver<K,V>
extends CacheCallback

Implementers of interface PartitionResolver enable custom partitioning on the PartitionedRegion.

1. The Key class or callback arg can implement PartitionResolver interface to enable custom partitioning OR
2. Configure your own PartitionResolver class in partition attributes (For instance when the Key is a primitive type or String) Implement the appropriate equals

GemFire uses the routing object's hashCode to determine where the data is being managed. Say, for example, you want to colocate all Trades by month and year.The key is implemented by TradeKey class which also implements the PartitionResolver interface.

public class TradeKey implements PartitionResolver {
    private String tradeID;
    private Month month ;
    private Year year ;
    public TradingKey(){ }
    public TradingKey(Month month, Year year){
        this.month = month;
        this.year = year;
    }
    public Serializable getRoutingObject(EntryOperation opDetails){
        return this.month + this.year;
    }
}
In the example above, all trade entries with the same month and year are guaranteed to be colocated.

Since:
6.0

Method Summary
 String getName()
          Returns the name of the PartitionResolver
 Serializable getRoutingObject(EntryOperation<K,V> opDetails)
           
 
Methods inherited from interface com.gemstone.gemfire.cache.CacheCallback
close
 

Method Detail

getRoutingObject

Serializable getRoutingObject(EntryOperation<K,V> opDetails)
Parameters:
opDetails - the detail of the entry operation e.g. Region.get(Object)
Returns:
object associated with entry operation which allows the Partitioned Region to store associated data together
Throws:
RuntimeException - any exception thrown will terminate the operation and the exception will be passed to the calling thread.

getName

String getName()
Returns the name of the PartitionResolver

Returns:
String name

GemFire 6.0.1

Copyright © 2002-2009 GemStone Systems, Inc. All Rights Reserved.