source.dussan.org Git - sonarqube.git/blob

   1 /*
   2  * SonarQube
   3  * Copyright (C) 2009-2017 SonarSource SA
   4  * mailto:info AT sonarsource DOT com
   5  *
   6  * This program is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 3 of the License, or (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public License
  17  * along with this program; if not, write to the Free Software Foundation,
  18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  19  */
  20 package org.sonar.server.computation.task.projectanalysis.analysis;
  21
  22 import java.util.Map;
  23 import java.util.Optional;
  24 import javax.annotation.CheckForNull;
  25 import org.sonar.server.qualityprofile.QualityProfile;
  26
  27 public interface AnalysisMetadataHolder {
  28
  29   /**
  30    * Returns the organization the analysis belongs to.
  31    * @throws IllegalStateException if organization has not been set
  32    */
  33   Organization getOrganization();
  34
  35   /**
  36    * Returns the UUID generated for this analysis.
  37    * @throws IllegalStateException if uuid has not been set
  38    */
  39   String getUuid();
  40
  41   /**
  42    * @throws IllegalStateException if no analysis date has been set
  43    */
  44   long getAnalysisDate();
  45
  46   /**
  47    * Tell whether the analysisDate has been set.
  48    */
  49   boolean hasAnalysisDateBeenSet();
  50
  51   /**
  52    * Convenience method equivalent to calling {@link #getBaseAnalysis() == null}
  53    *
  54    * @throws IllegalStateException if baseProjectSnapshot has not been set
  55    */
  56   boolean isFirstAnalysis();
  57
  58   /**
  59    * Return the last analysis of the project.
  60    * If it's the first analysis, it will return null.
  61    *
  62    * @throws IllegalStateException if baseAnalysis has not been set
  63    */
  64   @CheckForNull
  65   Analysis getBaseAnalysis();
  66
  67   /**
  68    * Convenience method equivalent to do the check using {@link #getBranch()}
  69    *
  70    * @throws IllegalStateException if branch has not been set
  71    */
  72   boolean isShortLivingBranch();
  73
  74   /**
  75    * Convenience method equivalent to do the check using {@link #getBranch()}
  76    *
  77    * @throws IllegalStateException if branch has not been set
  78    */
  79   boolean isLongLivingBranch();
  80
  81   /**
  82    * @throws IllegalStateException if cross project duplication flag has not been set
  83    */
  84   boolean isCrossProjectDuplicationEnabled();
  85
  86   /**
  87    * Branch is present whatever the type of branch (long or short, main or not). However
  88    * it is absent when analyzing a pull request.
  89    *
  90    * @throws IllegalStateException if branch has not been set
  91    */
  92   Optional<Branch> getBranch();
  93
  94   /**
  95    * The project as represented by the main branch. It is used to load settings
  96    * like Quality gates, webhooks and configuration.
  97    *
  98    * In case of analysis of main branch, the returned value is the main branch,
  99    * so its uuid and key are the same in
 100    * {@link org.sonar.server.computation.task.projectanalysis.component.TreeRootHolder#getRoot().
 101    *
 102    * In case of analysis of non-main branch or pull request, the returned value
 103    * is the main branch. Its uuid and key are different than
 104    * {@link org.sonar.server.computation.task.projectanalysis.component.TreeRootHolder#getRoot().
 105    *
 106    * @throws IllegalStateException if project has not been set
 107    */
 108   Project getProject();
 109
 110   /**
 111    * @throws IllegalStateException if root component ref has not been set
 112    */
 113   int getRootComponentRef();
 114
 115   Map<String, QualityProfile> getQProfilesByLanguage();
 116
 117   /**
 118    * Plugins used during the analysis on scanner side
 119    */
 120   Map<String, ScannerPlugin> getScannerPluginsByKey();
 121
 122 }