add support for custom sorting

Author: Todd Bodnar

src/com/brein/api/BreinRecommendation.java

@@ -10,8 +10,8 @@
 import java.util.List;
 import java.util.Map;
 
-public class BreinRecommendation extends BreinBase<BreinRecommendation> implements
-        IExecutable<BreinRecommendationResult> {
+public class BreinRecommendation extends BreinBase<BreinRecommendation>
+        implements IExecutable<BreinRecommendationResult> {
 
     /**
      * Recommends a user items that are similar to what they previously interacted with
@@ -33,6 +33,10 @@ public class BreinRecommendation extends BreinBase<BreinRecommendation> implemen
      * Recommends items that have historically trended during similar times
      */
     public static final String SUB_RECOMMENDER_TEMPORAL = "temporal";
+    /**
+     * Recommends items that have are ordered through some config-defined manner
+     */
+    public static final String SUB_RECOMMENDER_CUSTOM_SORT = "customSort";
 
     /**
      * contains the number of recommendations - default is 3
@@ -94,6 +98,11 @@ public class BreinRecommendation extends BreinBase<BreinRecommendation> implemen
      */
     private Double minQuantity = null;
 
+    /**
+     * Additional parameters to be passed into the sub recommenders
+     */
+    private Map<String, Object> recommendationAdditionalParameters;
+
     /**
      * get the number of recommendations
      *
@@ -171,12 +180,12 @@ public List<String> getSubRecommenders() {
         return subRecommenders;
     }
 
-    public BreinRecommendation setMinQuantity(final Double minQuantity){
+    public BreinRecommendation setMinQuantity(final Double minQuantity) {
         this.minQuantity = minQuantity;
         return this;
     }
 
-    public Double getMinQuantity(){
+    public Double getMinQuantity() {
         return minQuantity;
     }
 
@@ -276,6 +285,16 @@ public BreinRecommendation setBlockers(final List<String> blockers) {
         return this;
     }
 
+    public Map<String, Object> getRecommendationAdditionalParameters() {
+        return recommendationAdditionalParameters;
+    }
+
+    public BreinRecommendation setRecommendationAdditionalParameters(final Map<String, Object>
+                                                                             recommendationAdditionalParameters) {
+        this.recommendationAdditionalParameters = recommendationAdditionalParameters;
+        return this;
+    }
+
     @Override
     public String getEndPoint(final BreinConfig config) {
         return config.getRecommendationEndpoint();
@@ -308,6 +327,10 @@ public void prepareRequestData(final BreinConfig config, final Map<String, Objec
             recommendationData.put("recommendationSubBlockers", getBlockers());
         }
 
+        if (BreinUtil.containsValue(getRecommendationAdditionalParameters())) {
+            recommendationData.put("recommendationAdditionalParameters", getRecommendationAdditionalParameters());
+        }
+
         if (getRecStartTime() >= 0) {
             recommendationData.put("recommendationAtTime", getRecStartTime());
         }