From 13759e254c6b78fbd36957c95707e2cd9214fd15 Mon Sep 17 00:00:00 2001
From: Teryk Bellahsene <teryk.bellahsene@sonarsource.com>
Date: Fri, 15 Jan 2016 16:10:57 +0100
Subject: [PATCH] SONAR-7135 WS api/measures/component_tree describe best value
 algorithm

---
 .../server/measure/ws/ComponentTreeAction.java   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/server/sonar-server/src/main/java/org/sonar/server/measure/ws/ComponentTreeAction.java b/server/sonar-server/src/main/java/org/sonar/server/measure/ws/ComponentTreeAction.java
index 8ff8bc13e08..8d4d970807f 100644
--- a/server/sonar-server/src/main/java/org/sonar/server/measure/ws/ComponentTreeAction.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/measure/ws/ComponentTreeAction.java
@@ -53,6 +53,22 @@ import static org.sonarqube.ws.client.measure.MeasuresWsParameters.PARAM_METRIC_
 import static org.sonarqube.ws.client.measure.MeasuresWsParameters.PARAM_QUALIFIERS;
 import static org.sonarqube.ws.client.measure.MeasuresWsParameters.PARAM_STRATEGY;
 
+/**
+ * <p>Navigate through components based on different strategy with specified measures.
+ * To limit the number of rows in database, a best value algorithm exists in database.</p>
+ * A measure is not stored in database if:
+ * <ul>
+ *   <li>the component is a file (production or test)</li>
+ *   <li>optimization algorithm is enabled on the metric</li>
+ *   <li>the measure computed equals the metric best value</li>
+ *   <li>the period values are all equal to 0</li>
+ * </ul>
+ * To recreate a best value 2 different cases:
+ * <ul>
+ *   <li>Metric starts with 'new_' (ex: new_violations): the best value measure doesn't have a value and period values are all equal to 0</li>
+ *   <li>Other metrics: the best value measure has a value of 0 and no period value</li>
+ * </ul>
+ */
 public class ComponentTreeAction implements MeasuresWsAction {
   private static final int MAX_SIZE = 500;
   static final String ALL_STRATEGY = "all";
-- 
2.39.5