org.sonar.api.resources

Class File

java.lang.Object

org.sonar.api.resources.Resource

org.sonar.api.resources.File

All Implemented Interfaces:

Serializable

public class File
extends Resource

This class is an implementation of a resource of type FILE

Since:

1.10

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	SCOPE

Fields inherited from class org.sonar.api.resources.Resource

QUALIFIER_CLASS, QUALIFIER_DIRECTORY, QUALIFIER_FIELD, QUALIFIER_FILE, QUALIFIER_LIB, QUALIFIER_METHOD, QUALIFIER_MODULE, QUALIFIER_PACKAGE, QUALIFIER_PROJECT, QUALIFIER_SUBVIEW, QUALIFIER_UNIT_TEST_CLASS, QUALIFIER_VIEW, SCOPE_ENTITY, SCOPE_SET, SCOPE_SPACE

Constructor Summary

Constructors

Constructor and Description
File(Language language, String relativePathFromSourceDir) Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)
File(Language language, String relativeDirectoryPathFromSourceDir, String filename) Deprecated. since 4.2 use fromIOFile(java.io.File, Project)
File(String relativePathFromSourceDir) Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)
File(String relativeDirectoryPathFromSourceDir, String filename) Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

Method Summary

Methods

Modifier and Type	Method and Description
static File	create(String relativePathFromBasedir) Deprecated. since 5.1 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)
static File	create(String relativePathFromBasedir, Language language, boolean unitTest) Deprecated. since 5.1 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)
static File	fromIOFile(File file, List<File> sourceDirs) Deprecated. since 4.2 use fromIOFile(java.io.File, Project)
static File	fromIOFile(File file, Project module) Deprecated. since 4.5 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)
String	getDescription()
Language	getLanguage()
String	getLongName()
String	getName()
Directory	getParent() The parent is used to build the resources tree, for example for relations between files, directories and projects.
String	getQualifier() Returns the qualifier associated to this File.
String	getScope()
boolean	matchFilePattern(String antPattern) Check resource against an Ant pattern, like mypackag?/*Foo.java.
String	relativePathFromSourceDir() Internal.
void	setLanguage(Language language) Sets the language of the file
void	setQualifier(String qualifier)
String	toString()

Methods inherited from class org.sonar.api.resources.Resource

equals, getEffectiveKey, getId, getKey, getPath, getUuid, hashCode, isExcluded, language, normalize, setEffectiveKey, setExcluded, setId, setKey, setPath, setUuid

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SCOPE

public static final String SCOPE

See Also:

Constant Field Values

Constructor Detail

File

@Deprecated
public File(String relativePathFromSourceDir)

Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

File

@Deprecated
public File(String relativeDirectoryPathFromSourceDir,
               String filename)

Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

File

@Deprecated
public File(Language language,
               String relativePathFromSourceDir)

Deprecated. since 4.2 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

File

@Deprecated
public File(Language language,
               String relativeDirectoryPathFromSourceDir,
               String filename)

Deprecated. since 4.2 use fromIOFile(java.io.File, Project)

Creates a File from language, directory and filename

Method Detail

relativePathFromSourceDir

public String relativePathFromSourceDir()

Internal.

getParent

public Directory getParent()

The parent is used to build the resources tree, for example for relations between files, directories and projects.

Return null if the parent is the current project (or module in case of multi-module).

Specified by:

getParent in class Resource

See Also:

Resource.getParent()

matchFilePattern

public boolean matchFilePattern(String antPattern)

Check resource against an Ant pattern, like mypackag?/*Foo.java. It's used for example to match resource exclusions.

Specified by:

matchFilePattern in class Resource

Parameters:

antPattern - Ant-like pattern (with **, * and ?). It includes file suffixes.

Returns:

true if the resource matches the Ant pattern

See Also:

Resource.matchFilePattern(String)

fromIOFile

@Deprecated
@CheckForNull
public static File fromIOFile(File file,
                                      List<File> sourceDirs)

Deprecated. since 4.2 use fromIOFile(java.io.File, Project)

Creates a File from an io.file and a list of sources directories

fromIOFile

@Deprecated
@CheckForNull
public static File fromIOFile(File file,
                                      Project module)

Deprecated. since 4.5 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

Creates a File from an absolute File and a module. The returned File can be then passed for example to SensorContext.saveMeasure(Resource, org.sonar.api.measures.Measure).

Parameters:

file - absolute path to a file

module -

Returns:

null if the file is not under module basedir.

getName

public String getName()

Specified by:

getName in class Resource

Returns:

the resource name

See Also:

Resource.getName()

getLongName

public String getLongName()

Specified by:

getLongName in class Resource

Returns:

the resource long name

See Also:

Resource.getLongName()

getDescription

public String getDescription()

Specified by:

getDescription in class Resource

Returns:

the resource description

See Also:

Resource.getDescription()

getLanguage

public Language getLanguage()

Specified by:

getLanguage in class Resource

Returns:

the language of the resource. Only Files may have a non null value.

See Also:

Resource.getLanguage()

setLanguage

public void setLanguage(Language language)

Sets the language of the file

getScope

public final String getScope()

Specified by:

getScope in class Resource

Returns:

SCOPE_ENTITY

getQualifier

public String getQualifier()

Returns the qualifier associated to this File. Should be QUALIFIER_FILE or QUALIFIER_UNIT_TEST_CLASS

Specified by:

getQualifier in class Resource

Returns:

the qualifier

See Also:

for the list of qualifiers, to find out if a resource if a class, a unit test,... from its qualifier

setQualifier

public void setQualifier(String qualifier)

create

@Deprecated
public static File create(String relativePathFromBasedir)

Deprecated. since 5.1 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

Internal use only.

create

@Deprecated
public static File create(String relativePathFromBasedir,
                     Language language,
                     boolean unitTest)

Deprecated. since 5.1 use FileSystem.inputFile(org.sonar.api.batch.fs.FilePredicate)

Internal use only.

toString

public String toString()

Overrides:

toString in class Object