import java.util.List;
/**
- * @deprecated a formula has been implemented on the metric, so no need to have decorator anymore
- * @since 2.1
+ * @deprecated since 2.1, a formula has been implemented on the metric, so no need to have decorator anymore
+ * @since 1.10
*/
+@Deprecated
public abstract class AbstractFileComplexityDecorator implements Decorator {
private Language language;
import java.util.List;\r
\r
/**\r
- * @deprecated a formula has been implemented on the metric, so no need to have decorator anymore\r
- * @since 2.1\r
+ * @deprecated since 2.1, a formula has been implemented on the metric, so no need to have decorator anymore\r
+ * @since 1.13\r
*/\r
+@Deprecated\r
public abstract class AbstractFunctionComplexityDecorator implements Decorator {\r
\r
private Language language;\r
\r
package org.sonar.api.batch;\r
\r
-import org.sonar.api.measures.CountDistributionBuilder;\r
import org.sonar.api.measures.CoreMetrics;\r
-import org.sonar.api.measures.Metric;\r
+import org.sonar.api.measures.CountDistributionBuilder;\r
import org.sonar.api.measures.Measure;\r
+import org.sonar.api.measures.Metric;\r
+import org.sonar.api.resources.Language;\r
import org.sonar.api.resources.Project;\r
import org.sonar.api.resources.Resource;\r
-import org.sonar.api.resources.Language;\r
-\r
\r
/**\r
- * @deprecated a formula has been implemented on the metric, so no need to have decorator anymore\r
- * @since 2.1\r
+ * @deprecated since 2.1, a formula has been implemented on the metric, so no need to have decorator anymore\r
+ * @since 2.0\r
*/\r
+@Deprecated\r
public abstract class AbstractFunctionComplexityDistributionDecorator implements Decorator {\r
\r
private CountDistributionBuilder builder = new CountDistributionBuilder(CoreMetrics.FUNCTION_COMPLEXITY_DISTRIBUTION);\r
/**
* Child contexts are read only
*/
-
List<DecoratorContext> getChildren();
-
// MEASURES
/**
*/
Collection<Measure> getChildrenMeasures(Metric metric);
-
/**
* Add a measure on the current resource. It can not be executed from children contexts.
- *
+ *
* @return the same context
*/
DecoratorContext saveMeasure(Measure measure);
/**
* Add a measure on the current resource. It can not be executed from children contexts.
- *
+ *
* @return the current object
*/
DecoratorContext saveMeasure(Metric metric, Double value);
+ // DEPENDENCIES
Dependency saveDependency(Dependency dependency);
Collection<Dependency> getOutgoingDependencies();
-
// RULES
/**
* Save a coding rule violation. The decorator which calls this method must be depended upon BatchBarriers.END_OF_VIOLATIONS_GENERATION.
*
* @since 2.5
- * @param force allows to force creation of violation even if it was supressed by {@link org.sonar.api.rules.ViolationFilter}
+ * @param force allows to force creation of violation even if it was suppressed by {@link org.sonar.api.rules.ViolationFilter}
*/
DecoratorContext saveViolation(Violation violation, boolean force);
*/
DecoratorContext saveViolation(Violation violation);
+ // EVENTS
+
/**
* @return the list of events associated to the current resource
*/
/**
* Creates an event for a given date
- *
- * @param name the event name
+ *
+ * @param name the event name
* @param description the event description
- * @param category the event category
- * @param date the event date
+ * @param category the event category
+ * @param date the event date
* @return the created event
*/
Event createEvent(String name, String description, String category, Date date);
/**
* Deletes an event
- *
+ *
* @param event the event to delete
*/
void deleteEvent(Event event);
-
-
}
*/
Measure saveMeasure(Metric metric, Double value);
-
// ----------- MEASURES ON RESOURCES --------------
/**
/**
* Key is updated when saving the resource.
- *
+ *
* @return the key as saved in database. Null if the resource is set as excluded.
*/
String saveResource(Resource resource);
/**
* Add or update a measure.
- * <p/>
- * <p>The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as excluded.</p>
+ * <p>
+ * The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as
+ * excluded.
+ * </p>
*/
Measure saveMeasure(Resource resource, Metric metric, Double value);
/**
* Add or update a measure.
- * <p/>
- * <p>The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as excluded.</p>
+ * <p>
+ * The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as
+ * excluded.
+ * </p>
*/
Measure saveMeasure(Resource resource, Measure measure);
-
// ----------- RULE VIOLATIONS --------------
/**
* @param force allows to force creation of violation even if it was supressed by {@link org.sonar.api.rules.ViolationFilter}
*/
void saveViolation(Violation violation, boolean force);
-
+
/**
* Save a coding rule violation.
*/
*/
void saveViolations(Collection<Violation> violations);
-
- // ----------- DEPENDENCIES BETWEEN RESOURCES --------------
+ // ----------- DEPENDENCIES BETWEEN RESOURCES --------------
/**
* Build a new dependency : from depends upon to. The dependency is NOT saved. The method saveDependency() must still be executed.
Collection<Dependency> getOutgoingDependencies(Resource from);
- // ----------- FILE SOURCES --------------
+ // ----------- FILE SOURCES --------------
/**
* Does nothing if the resource is set as excluded.
*/
void saveSource(Resource resource, String source);
-
// ----------- LINKS --------------
/**
- * add a link to an external page like project homepage, sources (subversion, ...), continuous integration server...
- * Example : context.addLink(new ProjectLink("maven_site, "Maven site", "http://my.maven.com)
+ * add a link to an external page like project homepage, sources (subversion, ...), continuous integration server... Example :
+ * context.addLink(new ProjectLink("maven_site, "Maven site", "http://my.maven.com)
*/
void saveLink(ProjectLink link);
*/
void deleteLink(String key);
-
// ----------- EVENTS --------------
/**
/**
* Creates an event for a given date
- *
- * @param name the event name
+ *
+ * @param name the event name
* @param description the event description
- * @param category the event category
- * @param date the event date
+ * @param category the event category
+ * @param date the event date
* @return the created event
*/
Event createEvent(Resource resource, String name, String description, String category, Date date);
/**
* Deletes an event
- *
+ *
* @param event the event to delete
*/
void deleteEvent(Event event);
@Override
public String getScope() {
- return Resource.SCOPE_PROJECT;
+ return Resource.SCOPE_SET;
}
@Override
*/
public interface ProjectFileSystem {
/**
- * Source encoding. It's the default plateform charset if it is not defined in the project
- * (Maven property 'project.build.sourceEncoding').
+ * Source encoding. It's the default platform charset if it is not defined in the project (Maven property 'project.build.sourceEncoding').
*/
Charset getSourceCharset();
File getSonarWorkingDirectory();
/**
- * Get file from path. It can be absolute or relative to project basedir. For example resolvePath("pom.xml") or resolvePath("src/main/java")
+ * Get file from path. It can be absolute or relative to project basedir. For example resolvePath("pom.xml") or
+ * resolvePath("src/main/java")
*/
File resolvePath(String path);
/**
* Source files, excluding unit tests and files matching project exclusion patterns.
- *
+ *
* @param langs language filter. Check all files, whatever their language, if null or empty.
*/
List<File> getSourceFiles(Language... langs);
/**
- * Java source files, excluding unit tests and files matching project exclusion patterns.
- * Shortcut for getSourceFiles(Java.INSTANCE)
+ * Java source files, excluding unit tests and files matching project exclusion patterns. Shortcut for getSourceFiles(Java.INSTANCE)
*/
List<File> getJavaSourceFiles();
/**
* Save data into a new file of Sonar working directory.
- *
+ *
* @return the created file
*/
File writeToWorkingDirectory(String content, String fileName) throws IOException;
/**
* The interface to implement to create a resource in Sonar
- *
+ *
* @since 1.10
*/
public abstract class Resource<PARENT extends Resource> {
public static final String SCOPE_SET = "PRJ";
public static final String SCOPE_SPACE = "DIR";
public static final String SCOPE_ENTITY = "FIL";
-
+
/**
- * Use SCOPE_SET instead
+ * @deprecated since 1.11, use {@link #SCOPE_SET} instead.
*/
@Deprecated
public static final String SCOPE_PROJECT = SCOPE_SET;
/**
- * Use SCOPE_SPACE instead
+ * @deprecated since 1.11, use {@link #SCOPE_SPACE} instead.
*/
@Deprecated
public static final String SCOPE_DIRECTORY = SCOPE_SPACE;
/**
- * Use SCOPE_ENTITY instead
+ * @deprecated since 1.11, use {@link #SCOPE_ENTITY} instead.
*/
@Deprecated
public static final String SCOPE_FILE = SCOPE_ENTITY;
-
public static final String QUALIFIER_VIEW = "VW";
public static final String QUALIFIER_SUBVIEW = "SVW";
public static final String QUALIFIER_LIB = "LIB";
public static final String QUALIFIER_UNIT_TEST_CLASS = "UTS";
/**
- * Use QUALIFIER_PROJECT instead
+ * @deprecated since 1.11, use {@link #QUALIFIER_PROJECT} instead.
*/
@Deprecated
public static final String QUALIFIER_PROJECT_TRUNK = QUALIFIER_PROJECT;
/**
- * Use QUALIFIER_MODULE instead
+ * @deprecated since 1.11, use {@link #QUALIFIER_MODULE} instead.
*/
@Deprecated
public static final String QUALIFIER_PROJECT_BRANCH = QUALIFIER_MODULE;
private boolean isExcluded = false;
-
/**
* @return the resource key
*/
/**
* The parent is used to build the resources tree, for example for relations between classes, packages and projects.
- * <p>Return null if the parent is the project.</p>
+ * <p>
+ * Return null if the parent is the project.
+ * </p>
*/
public abstract PARENT getParent();
/**
- * Check resource against an Ant pattern, like mypackag?/*Foo.java. It's used for example
- * to match resource exclusions.
- *
+ * Check resource against an Ant pattern, like mypackag?/*Foo.java. It's used for example to match resource exclusions.
+ *
* @param antPattern Ant-like pattern (with **, * and ?). It includes file suffixes.
* @return true if the resource matches the Ant pattern
*/
public abstract boolean matchFilePattern(String antPattern);
-
public final Integer getId() {
return id;
}
}
/**
- * @return whther a resource is a maven module of project
+ * @return whether a resource is a maven module of project
*/
public static boolean isModuleProject(Resource resource) {
return Resource.QUALIFIER_MODULE.equals(resource.getQualifier());
return resource != null && Resource.QUALIFIER_PACKAGE.equals(resource.getQualifier());
}
-
/**
* @return whether a resource is a set
*/
}
/**
- * Alias for isDirectory(resource)
+ * Alias for {@link #isSpace(Resource)}
*/
public static boolean isDirectory(Resource resource) {
return isSpace(resource);
}
/**
- * Alias for isEntity(resource)
+ * Alias for {@link #isEntity(Resource)}
*/
public static boolean isFile(Resource resource) {
return isEntity(resource);
}
-
/* QUALIFIERS */
/**
return Resource.QUALIFIER_CLASS.equals(resource.getQualifier());
}
-
/**
* @return whether a resource is a unit test class
*/
return Resource.QUALIFIER_UNIT_TEST_CLASS.equals(resource.getQualifier());
}
-
+ /**
+ * @return whether a resource is a library
+ */
public static boolean isLibrary(Resource resource) {
return Resource.QUALIFIER_LIB.equals(resource.getQualifier());
}
projects / sonarqube.git / commitdiff