Package edu.umd.cs.findbugs.ba

Class SourceFinder

java.lang.Object

edu.umd.cs.findbugs.ba.SourceFinder

All Implemented Interfaces:

AutoCloseable

public class SourceFinder
extends Object
implements AutoCloseable

Class to open input streams on source files. It maintains a "source path", which is like a classpath, but for finding source files instead of class files.

Constructor Summary

Constructors

Constructor	Description
SourceFinder(Project project)

Method Summary

Modifier and Type	Method	Description
void	close()
SourceFile	findSourceFile(SourceLineAnnotation source)
SourceFile	findSourceFile(String packageName, String fileName)	Open a source file in given package.
Optional<URI>	getBase(SourceLineAnnotation sourceLineAnnotation)
Optional<URI>	getBase(String fileName)
static String	getCanonicalName(SourceLineAnnotation source)
static String	getCanonicalName(String packageName, String fileName)
static String	getOrGuessSourceFile(SourceLineAnnotation source)
static String	getPlatformName(SourceLineAnnotation source)
static String	getPlatformName(String packageName, String fileName)
Project	getProject()
boolean	hasSourceFile(SourceLineAnnotation source)
boolean	hasSourceFile(String packageName, String fileName)
InputStream	openSource(SourceLineAnnotation source)
InputStream	openSource(String packageName, String fileName)	Open an input stream on a source file in given package.
void	setSourceBaseList(Iterable<String> sourceBaseList)	Set the list of source directories.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SourceFinder

public SourceFinder(Project project)

Method Details

getProject

public Project getProject()

Returns:

Returns the project.

setSourceBaseList

public void setSourceBaseList(Iterable<String> sourceBaseList)

Set the list of source directories.

openSource

public InputStream openSource(String packageName,
 String fileName)
                       throws IOException

Open an input stream on a source file in given package.

Parameters:

packageName - the name of the package containing the class whose source file is given

fileName - the unqualified name of the source file

Returns:

an InputStream on the source file

Throws:

IOException - if a matching source file cannot be found

openSource

public InputStream openSource(SourceLineAnnotation source)
                       throws IOException

Throws:

IOException

findSourceFile

public SourceFile findSourceFile(SourceLineAnnotation source)
                          throws IOException

Throws:

IOException

findSourceFile

public SourceFile findSourceFile(String packageName,
 String fileName)
                          throws IOException

Open a source file in given package.

Parameters:

packageName - the name of the package containing the class whose source file is given

fileName - the unqualified name of the source file

Returns:

the source file

Throws:

IOException - if a matching source file cannot be found

getPlatformName

public static String getPlatformName(String packageName,
 String fileName)

getPlatformName

public static String getPlatformName(SourceLineAnnotation source)

getCanonicalName

public static String getCanonicalName(SourceLineAnnotation source)

getCanonicalName

public static String getCanonicalName(String packageName,
 String fileName)

getOrGuessSourceFile

public static String getOrGuessSourceFile(SourceLineAnnotation source)

hasSourceFile

public boolean hasSourceFile(SourceLineAnnotation source)

hasSourceFile

public boolean hasSourceFile(String packageName,
 String fileName)

close

public void close()

Specified by:

close in interface AutoCloseable

getBase

public Optional<URI> getBase(SourceLineAnnotation sourceLineAnnotation)

getBase

public Optional<URI> getBase(String fileName)