GemStone::GemFire::Cache::IFixedPartitionResolver Interface Reference

Inherits GemStone::GemFire::Cache::IPartitionResolver.


Detailed Description

Implementers of interface FixedPartitionResolver helps to achieve explicit mapping of a "user defined" partition to a data member node.

GemFire uses the partition name returned by FixedPartitionResolver#getPartitionName(EntryEvent, vector) to determine on which member the data is being managed. Say, for example, you want to partition all Trades according to quarters. You can implement FixedPartitionResolver to get the name of the quarter based on the date given as part of EntryEvent.

public class QuarterPartitionResolver implements FixedPartitionResolver{
&nbsp &nbsp public String getPartitionName(EntryOperation opDetails, Set allAvailablePartitions) {
&nbsp &nbsp Date date = sdf.parse((String)opDetails.getKey());
&nbsp &nbsp Calendar cal = Calendar.getInstance();
&nbsp &nbsp cal.setTime(date);
&nbsp &nbsp int month = cal.get(Calendar.MONTH);
&nbsp &nbsp if (month == 0 || month == 1 || month == 2) {
&nbsp &nbsp &nbsp return "Quarter1";
&nbsp &nbsp }
&nbsp &nbsp else if (month == 3 || month == 4 || month == 5) {
&nbsp &nbsp &nbsp return "Quarter2";
&nbsp &nbsp }
&nbsp &nbsp else if (month == 6 || month == 7 || month == 8) {
&nbsp &nbsp &nbsp return "Quarter3";
&nbsp &nbsp }
&nbsp &nbsp else if (month == 9 || month == 10 || month == 11) {
&nbsp &nbsp &nbsp return "Quarter4";
&nbsp &nbsp }
&nbsp &nbsp else {
&nbsp &nbsp &nbsp return "Invalid Quarter";
&nbsp &nbsp }
&nbsp }

See also:
PartitionResolver, AttributesFactory.SetPartitionResolver, RegionAttributes.PartitionResolver

Public Member Functions

String^ GetName ()
String^ GetPartitionName (EntryEvent^ opDetails, CacheableHashSet^ targetPartitions)
GemStone::GemFire::Cache::ICacheableKeyGetRoutingObject (EntryEvent^ key)

Member Function Documentation

String ^ GemStone::GemFire::Cache::IPartitionResolver::GetName (  )  [inherited]

Returns the name of the PartitionResolver.

This function does not throw any exception.

Returns:
the name of the PartitionResolver

String ^ GemStone::GemFire::Cache::IFixedPartitionResolver::GetPartitionName ( EntryEvent^   opDetails,
CacheableHashSet^   targetPartitions 
)

This method is used to get the name of the partition for the given entry operation.

Parameters:
opDetails the details of the entry event e.g. Region#get(Object)
targetPartitions represents all the available primary partitions on the nodes
<return> partition-name associated with node which allows mapping of given data to user defined partition </return>

GemStone::GemFire::Cache::ICacheableKey ^ GemStone::GemFire::Cache::IPartitionResolver::GetRoutingObject ( EntryEvent^   key  )  [inherited]

return object associated with entry event 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.

Parameters:
key key the detail of the entry event.


GemFire C++ Cache .NET API Documentation