| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more contributor license |
| * agreements. See the NOTICE file distributed with this work for additional information regarding |
| * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance with the License. You may obtain a |
| * copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software distributed under the License |
| * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express |
| * or implied. See the License for the specific language governing permissions and limitations under |
| * the License. |
| */ |
| package org.apache.geode.cache; |
| |
| import java.util.Set; |
| |
| /** |
| * Implementers of interface <code>FixedPartitionResolver</code> helps to achieve explicit mapping |
| * of a "user defined" partition to a data member node. |
| * <p> |
| * GemFire uses the partition name returned by |
| * {@link FixedPartitionResolver#getPartitionName(EntryOperation, Set)} 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 {@link org.apache.geode.cache.EntryOperation}. |
| * </p> |
| * |
| * public class QuarterPartitionResolver implements FixedPartitionResolver{<br> |
| *     public String getPartitionName(EntryOperation opDetails, Set allAvailablePartitions) |
| * {<br> |
| *     Date date = sdf.parse((String)opDetails.getKey());<br> |
| *     Calendar cal = Calendar.getInstance();<br> |
| *     cal.setTime(date);<br> |
| *     int month = cal.get(Calendar.MONTH);<br> |
| *     if (month == 0 || month == 1 || month == 2) {<br> |
| *       return "Quarter1";<br> |
| *     }<br> |
| *     else if (month == 3 || month == 4 || month == 5) {<br> |
| *       return "Quarter2";<br> |
| *     }<br> |
| *     else if (month == 6 || month == 7 || month == 8) {<br> |
| *       return "Quarter3";<br> |
| *     }<br> |
| *     else if (month == 9 || month == 10 || month == 11) {<br> |
| *       return "Quarter4";<br> |
| *     }<br> |
| *     else {<br> |
| *       return "Invalid Quarter";<br> |
| *     }<br> |
| *   }<br> |
| * |
| * @see PartitionResolver |
| * @since GemFire 6.6 |
| * |
| * |
| */ |
| public interface FixedPartitionResolver<K, V> extends PartitionResolver<K, V> { |
| |
| /** |
| * This method is used to get the name of the partition for the given entry operation. |
| * |
| * @param opDetails the details of the entry operation e.g. {@link Region#get(Object)} |
| * @param targetPartitions Avoid using this parameter.This set is deprecated from 8.0 and same |
| * will be removed in future release. 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 |
| */ |
| String getPartitionName(EntryOperation<K, V> opDetails, @Deprecated Set<String> targetPartitions); |
| } |