00001 /* 00002 * Copyright (c) 2000, 2020, Oracle and/or its affiliates. 00003 * 00004 * Licensed under the Universal Permissive License v 1.0 as shown at 00005 * http://oss.oracle.com/licenses/upl. 00006 */ 00007 #ifndef COH_COMPARABLE_MAX_HPP 00008 #define COH_COMPARABLE_MAX_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/util/aggregator/AbstractComparableAggregator.hpp" 00013 #include "coherence/util/ValueExtractor.hpp" 00014 00015 COH_OPEN_NAMESPACE3(coherence,util,aggregator) 00016 00017 00018 /** 00019 * Calculates a maximum among values extracted from a set of entries in a Map. 00020 * This aggregator is most commonly used with objects that implement 00021 * <tt>Comparable</tt> such as <tt>String<tt/>; a <tt>Comparator</tt> can also 00022 * be supplied to perform the comparisons. 00023 * 00024 * @author djl/pp 2008.05.12 00025 */ 00026 class COH_EXPORT ComparableMax 00027 : public class_spec<ComparableMax, 00028 extends<AbstractComparableAggregator> > 00029 { 00030 friend class factory<ComparableMax>; 00031 00032 // ----- constructors --------------------------------------------------- 00033 00034 protected: 00035 /** 00036 * Default constructor (necessary for the PortableObject interface). 00037 */ 00038 ComparableMax(); 00039 00040 /** 00041 * Construct a ComparableMax aggregator. 00042 * 00043 * @param vExtractor the extractor that provides an object to be 00044 * compared 00045 * @param vComparator the comparator used to compare the extracted 00046 * object, if NULL then the extracted object must 00047 * implement Comparable 00048 */ 00049 ComparableMax(ValueExtractor::View vExtractor, 00050 Comparator::View vComparator = NULL); 00051 00052 /** 00053 * Construct a ComparableMax that will aggregate values extracted 00054 * from a set of InvocableMap::Entry objects. 00055 * 00056 * @param vsMethod the name of the method that could be invoked via 00057 * reflection and that returns values to aggregate; 00058 * this parameter can also be a dot-delimited 00059 * sequence of method names which would result in 00060 * an aggregator based 00061 * on the ChainedExtractor that is based on an 00062 * array of corresponding ReflectionExtractor 00063 * objects 00064 * @param vComparator the comparator used to compare the extracted 00065 * object, if NULL then the extracted object must 00066 * implement Comparable 00067 * 00068 * @since Coherence 12.1.2 00069 */ 00070 ComparableMax(String::View vsMethod, 00071 Comparator::View vComparator = NULL); 00072 00073 private: 00074 /** 00075 * Blocked copy constructor. 00076 */ 00077 ComparableMax(const ComparableMax&); 00078 00079 00080 // ----- AbstractAggregator Interface ---------------------------------- 00081 00082 protected: 00083 /** 00084 * {@inheritDoc} 00085 */ 00086 virtual void process(Object::View v, bool fFinal); 00087 }; 00088 00089 COH_CLOSE_NAMESPACE3 00090 00091 #endif // COH_COMPARABLE_MAX_HPP