org.sonar.api.batch
Interface SensorContext


public interface SensorContext

Since:
1.10

Method Summary
 Event createEvent(Resource resource, String name, String description, String category, Date date)
          Creates an event for a given date
 void deleteEvent(Event event)
          Deletes an event
 void deleteLink(String key)
          remove a link.
 Collection<Resource> getChildren(Resource reference)
           
 Set<Dependency> getDependencies()
           
 List<Event> getEvents(Resource resource)
           
 Collection<Dependency> getIncomingDependencies(Resource to)
           
<G extends Serializable>
Measure<G>
getMeasure(Metric<G> metric)
          Find a project measure
<G extends Serializable>
Measure<G>
getMeasure(Resource resource, Metric<G> metric)
          Find a measure for this project
<M> M
getMeasures(MeasuresFilter<M> filter)
          All measures of the project.
<M> M
getMeasures(Resource resource, MeasuresFilter<M> filter)
          Find all measures for this project.
 Collection<Dependency> getOutgoingDependencies(Resource from)
           
 Resource getParent(Resource reference)
           
 Resource getResource(InputPath inputPath)
          Allow to get Resource corresponding to provided InputPath.
<R extends Resource>
R
getResource(R reference)
          Search for an indexed resource.
 boolean index(Resource resource)
          Deprecated. since 4.2 Resource indexing is done by the platform for all physical resources.
 boolean index(Resource resource, Resource parentReference)
          Deprecated. since 4.2 Resource indexing is done by the platform for all physical resources.
 boolean isExcluded(Resource reference)
          Deprecated. since 4.2 Excluded resources are not indexed.
 boolean isIndexed(Resource reference, boolean acceptExcluded)
          Deprecated. since 4.2 Excluded resources are not indexed.
 Dependency saveDependency(Dependency dependency)
          Build a new dependency : from depends upon to.
 void saveLink(ProjectLink link)
          add a link to an external page like project homepage, sources (subversion, ...), continuous integration server...
 Measure saveMeasure(InputFile inputFile, Measure measure)
          Save measure on InputFile
 Measure saveMeasure(InputFile inputFile, Metric metric, Double value)
          Save measure on InputFile
 Measure saveMeasure(Measure measure)
          Add a measure on project
 Measure saveMeasure(Metric metric, Double value)
          Add a measure on project
 Measure saveMeasure(Resource resource, Measure measure)
          Add or update a measure.
 Measure saveMeasure(Resource resource, Metric metric, Double value)
          Add or update a measure.
 String saveResource(Resource resource)
          Deprecated. use the methods index()
 void saveSource(Resource reference, String source)
          Deprecated. since 4.2 Source import is done by the platform
 void saveViolation(Violation violation)
          Deprecated. in 3.6, replaced by Issuable
 void saveViolation(Violation violation, boolean force)
          Deprecated. in 3.6, replaced by Issuable
 void saveViolations(Collection<Violation> violations)
          Deprecated. in 3.6, replaced by Issuable
 

Method Detail

index

@Deprecated
boolean index(Resource resource)
Deprecated. since 4.2 Resource indexing is done by the platform for all physical resources.

Indexes a resource as a direct child of project. This method does nothing and returns true if the resource already indexed.

Returns:
false if the resource is excluded

index

@Deprecated
boolean index(Resource resource,
                         Resource parentReference)
Deprecated. since 4.2 Resource indexing is done by the platform for all physical resources.

Indexes a resource. This method does nothing if the resource is already indexed.

Parameters:
resource - the resource to index. Not nullable
parentReference - a reference to the parent. If null, the the resource is indexed as a direct child of project.
Returns:
false if the parent is not indexed or if the resource is excluded

isExcluded

@Deprecated
boolean isExcluded(Resource reference)
Deprecated. since 4.2 Excluded resources are not indexed.

Returns true if the referenced resource is indexed and excluded.

Since:
2.6

isIndexed

@Deprecated
boolean isIndexed(Resource reference,
                             boolean acceptExcluded)
Deprecated. since 4.2 Excluded resources are not indexed.

Returns true if the referenced resource is indexed.

Since:
2.6

getResource

@CheckForNull
<R extends Resource> R getResource(R reference)
Search for an indexed resource.

Parameters:
reference - the resource reference
Returns:
the indexed resource, null if it's not indexed
Since:
1.10. Generic types since 2.6.

getParent

Resource getParent(Resource reference)
Since:
2.6

getChildren

Collection<Resource> getChildren(Resource reference)
Since:
2.6

getMeasure

<G extends Serializable> Measure<G> getMeasure(Metric<G> metric)
Find a project measure


getMeasures

<M> M getMeasures(MeasuresFilter<M> filter)
All measures of the project. Never return null.


saveMeasure

Measure saveMeasure(Measure measure)
Add a measure on project


saveMeasure

Measure saveMeasure(Metric metric,
                    Double value)
Add a measure on project


getMeasure

<G extends Serializable> Measure<G> getMeasure(Resource resource,
                                               Metric<G> metric)
Find a measure for this project


saveResource

@Deprecated
String saveResource(Resource resource)
Deprecated. use the methods index()

Key is updated when saving the resource.

Returns:
the key as saved in database. Null if the resource is set as excluded.

getMeasures

<M> M getMeasures(Resource resource,
                  MeasuresFilter<M> filter)
Find all measures for this project. Never return null.


saveMeasure

Measure saveMeasure(Resource resource,
                    Metric metric,
                    Double value)
Add or update a measure.

The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as excluded.


saveMeasure

Measure saveMeasure(Resource resource,
                    Measure measure)
Add or update a measure.

The resource is automatically saved, so there is no need to execute the method saveResource(). Does nothing if the resource is set as excluded.


saveViolation

@Deprecated
void saveViolation(Violation violation,
                              boolean force)
Deprecated. in 3.6, replaced by Issuable

Save a coding rule violation.

Parameters:
force - allows to force creation of violation even if it was supressed by ViolationFilter
Since:
2.5

saveViolation

@Deprecated
void saveViolation(Violation violation)
Deprecated. in 3.6, replaced by Issuable

Save a coding rule violation.


saveViolations

@Deprecated
void saveViolations(Collection<Violation> violations)
Deprecated. in 3.6, replaced by Issuable

Saves a list of violations.


saveDependency

Dependency saveDependency(Dependency dependency)
Build a new dependency : from depends upon to. The dependency is NOT saved. The method saveDependency() must still be executed.


getDependencies

Set<Dependency> getDependencies()

getIncomingDependencies

Collection<Dependency> getIncomingDependencies(Resource to)

getOutgoingDependencies

Collection<Dependency> getOutgoingDependencies(Resource from)

saveSource

@Deprecated
void saveSource(Resource reference,
                           String source)
Deprecated. since 4.2 Source import is done by the platform

Save the source code of a file. The file must be have been indexed before.

Throws:
DuplicatedSourceException - if the source has already been set on this resource
Since:
1.10. Returns a boolean since 2.6.

saveLink

void saveLink(ProjectLink link)
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)


deleteLink

void deleteLink(String key)
remove a link. It does not fail if key is unknown.


getEvents

List<Event> getEvents(Resource resource)
Parameters:
resource - set null for project events

createEvent

Event createEvent(Resource resource,
                  String name,
                  String description,
                  String category,
                  Date date)
Creates an event for a given date

Parameters:
name - the event name
description - the event description
category - the event category
date - the event date
Returns:
the created event

deleteEvent

void deleteEvent(Event event)
Deletes an event

Parameters:
event - the event to delete

saveMeasure

Measure saveMeasure(InputFile inputFile,
                    Metric metric,
                    Double value)
Save measure on InputFile

Since:
4.2

saveMeasure

Measure saveMeasure(InputFile inputFile,
                    Measure measure)
Save measure on InputFile

Since:
4.2

getResource

Resource getResource(InputPath inputPath)
Allow to get Resource corresponding to provided InputPath.

Since:
4.5.2


Copyright © 2009–2015 SonarSource. All rights reserved.