edu.umd.cs.findbugs

Class Project

java.lang.Object

edu.umd.cs.findbugs.Project

All Implemented Interfaces:

XMLWriteable

public class Project
extends Object
implements XMLWriteable

A project in the GUI. This consists of some number of Jar files to analyze for bugs, and optionally

• some number of source directories, for locating the program's source code
• some number of auxiliary classpath entries, for locating classes referenced by the program which the user doesn't want to analyze
• some number of boolean options

Author:

David Hovemeyer

Field Summary

Fields

Modifier and Type	Field and Description
static String	RELATIVE_PATHS
static String	UNNAMED_PROJECT StaticConstant used to name anonymous projects.

Constructor Summary

Constructors

Constructor and Description
Project() Create an anonymous project.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(Project project2) add information from project2 to this project
boolean	addAuxClasspathEntry(String auxClasspathEntry) Add an auxiliary classpath entry
boolean	addFile(String fileName) Add a file to the project.
boolean	addSourceDir(String dirName) Add a source directory to the project.
void	addTimestamp(long timestamp)
boolean	addWorkingDir(String dirName) Add a working directory to the project.
static <T> List<T>	appendWithoutDuplicates(List<T> lst1, List<T> lst2)
Project	duplicate() Return an exact copy of this Project.
String	getAuxClasspathEntry(int n) Get the n'th auxiliary classpath entry.
List<String>	getAuxClasspathEntryList() Return the list of aux classpath entries.
String	getCloudId()
Properties	getCloudProperties()
UserPreferences	getConfiguration()
String	getFile(int num) Get the given file in the list of project files.
String[]	getFileArray() Get project files as an array of Strings.
int	getFileCount() Get the number of files in the project.
List<String>	getFileList() Get the list of files, directories, and zip files in the project.
IGuiCallback	getGuiCallback()
List<String>	getImplicitClasspathEntryList() Deprecated. FindBugs2 and ClassPathBuilder take care of this automatically
int	getNumAuxClasspathEntries() Get the number of auxiliary classpath entries.
int	getNumSourceDirs() Get the number of source directories in the project.
Boolean	getPluginStatus(Plugin plugin)
String	getProjectName()
Iterable<String>	getResolvedSourcePaths()
String	getSourceDir(int num) Get the given source directory.
String[]	getSourceDirArray() Get source dirs as an array of Strings.
List<String>	getSourceDirList() Get the source dir list.
SourceFinder	getSourceFinder()
Filter	getSuppressionFilter()
long	getTimestamp()
boolean	isGuiAvaliable()
boolean	isModified() Return whether or not this Project has unsaved modifications.
static Project	readProject(String argument) Read Project from named file.
static Project	readXML(File f)
void	removeAuxClasspathEntry(int n) Remove the n'th auxiliary classpath entry.
void	removeFile(int num) Remove file at the given index in the list of project files
void	removeSourceDir(int num) Remove source directory at given index.
void	setCloudId(String cloudId)
void	setCloudProperties(Properties cloudProperties)
void	setConfiguration(UserPreferences configuration)
void	setCurrentWorkingDirectory(File f)
void	setGuiCallback(IGuiCallback guiCallback)
void	setModified(boolean isModified) Set whether or not this Project has unsaved modifications.
void	setPluginStatusTrinary(String pluginId, Boolean enabled)
void	setProjectName(String projectName)
void	setSuppressionFilter(Filter suppressionFilter)
void	setTimestamp(long timestamp) Make the given list of pathnames absolute relative to the absolute path of the project file.
String	toString() Convert to a string in a nice (displayable) format.
static String	transformFilename(String fileName) Transform a user-entered filename into a proper filename, by adding the ".fb" file extension if it isn't already present.
void	write(String outputFile, boolean useRelativePaths, String relativeBase) Deprecated.
void	writeXML(File f, BugCollection bugCollection)
void	writeXML(XMLOutput xmlOutput) Write this object to given XMLOutput.
void	writeXML(XMLOutput xmlOutput, File destination, BugCollection bugCollection)

Methods inherited from class java.lang.Object

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

Field Detail

UNNAMED_PROJECT

public static final String UNNAMED_PROJECT

StaticConstant used to name anonymous projects.

See Also:

Constant Field Values

RELATIVE_PATHS

public static final String RELATIVE_PATHS

See Also:

Constant Field Values

Constructor Detail

Project

public Project()

Create an anonymous project.

Method Detail

getPluginStatus

@CheckForNull
public Boolean getPluginStatus(Plugin plugin)

setPluginStatusTrinary

public void setPluginStatusTrinary(String pluginId,
                          Boolean enabled)

getConfiguration

public UserPreferences getConfiguration()

setConfiguration

public void setConfiguration(@Nonnull
                    UserPreferences configuration)

Parameters:

configuration - The configuration to set, non null

getCloudId

@CheckForNull
public String getCloudId()

setCloudId

public void setCloudId(@Nullable
              String cloudId)

getCloudProperties

public Properties getCloudProperties()

Returns:

Returns the cloudProperties.

setCloudProperties

public void setCloudProperties(Properties cloudProperties)

Parameters:

cloudProperties - The cloudProperties to set.

duplicate

public Project duplicate()

Return an exact copy of this Project.

getSourceFinder

public SourceFinder getSourceFinder()

isGuiAvaliable

public boolean isGuiAvaliable()

add

public void add(Project project2)

add information from project2 to this project

appendWithoutDuplicates

public static <T> List<T> appendWithoutDuplicates(List<T> lst1,
                                  List<T> lst2)

setCurrentWorkingDirectory

public void setCurrentWorkingDirectory(File f)

isModified

public boolean isModified()

Return whether or not this Project has unsaved modifications.

setModified

public void setModified(boolean isModified)

Set whether or not this Project has unsaved modifications.

addFile

public boolean addFile(String fileName)

Add a file to the project.

Parameters:

fileName - the file to add

Returns:

true if the file was added, or false if the file was already present

addSourceDir

public boolean addSourceDir(String dirName)

Add a source directory to the project.

Parameters:

dirName - the directory to add

Returns:

true if the source directory was added, or false if the source directory was already present

addWorkingDir

public boolean addWorkingDir(String dirName)

Add a working directory to the project.

Parameters:

dirName - the directory to add

Returns:

true if the working directory was added, or false if the working directory was already present

getFileCount

public int getFileCount()

Get the number of files in the project.

Returns:

the number of files in the project

getFile

public String getFile(int num)

Get the given file in the list of project files.

Parameters:

num - the number of the file in the list of project files

Returns:

the name of the file

removeFile

public void removeFile(int num)

Remove file at the given index in the list of project files

Parameters:

num - index of the file to remove in the list of project files

getFileList

public List<String> getFileList()

Get the list of files, directories, and zip files in the project.

getNumSourceDirs

public int getNumSourceDirs()

Get the number of source directories in the project.

Returns:

the number of source directories in the project

getSourceDir

public String getSourceDir(int num)

Get the given source directory.

Parameters:

num - the number of the source directory

Returns:

the source directory

removeSourceDir

public void removeSourceDir(int num)

Remove source directory at given index.

Parameters:

num - index of the source directory to remove

getFileArray

public String[] getFileArray()

Get project files as an array of Strings.

getSourceDirArray

public String[] getSourceDirArray()

Get source dirs as an array of Strings.

getSourceDirList

public List<String> getSourceDirList()

Get the source dir list.

addAuxClasspathEntry

public boolean addAuxClasspathEntry(String auxClasspathEntry)

Add an auxiliary classpath entry

Parameters:

auxClasspathEntry - the entry

Returns:

true if the entry was added successfully, or false if the given entry is already in the list

getNumAuxClasspathEntries

public int getNumAuxClasspathEntries()

Get the number of auxiliary classpath entries.

getAuxClasspathEntry

public String getAuxClasspathEntry(int n)

Get the n'th auxiliary classpath entry.

removeAuxClasspathEntry

public void removeAuxClasspathEntry(int n)

Remove the n'th auxiliary classpath entry.

getAuxClasspathEntryList

public List<String> getAuxClasspathEntryList()

Return the list of aux classpath entries.

getImplicitClasspathEntryList

@Deprecated
public List<String> getImplicitClasspathEntryList()

Deprecated. FindBugs2 and ClassPathBuilder take care of this automatically

Return the list of implicit classpath entries. The implicit classpath is computed from the closure of the set of jar files that are referenced by the "Class-Path" attribute of the manifest of the any jar file that is part of this project or by the "Class-Path" attribute of any directly or indirectly referenced jar. The referenced jar files that exist are the list of implicit classpath entries.

write

@Deprecated
public void write(String outputFile,
                    boolean useRelativePaths,
                    String relativeBase)
           throws IOException

Deprecated.

Save the project to an output file.

Parameters:

outputFile - name of output file

useRelativePaths - true if the project should be written using only relative paths

relativeBase - if useRelativePaths is true, this file is taken as the base directory in terms of which all files should be made relative

Throws:

IOException - if an error occurs while writing

readXML

public static Project readXML(File f)
                       throws IOException,
                              SAXException

Throws:

IOException

SAXException

writeXML

public void writeXML(File f,
            @CheckForNull
            BugCollection bugCollection)
              throws IOException

Throws:

IOException

readProject

public static Project readProject(String argument)
                           throws IOException

Read Project from named file.

Parameters:

argument - command line argument containing project file name

Returns:

the Project

Throws:

IOException

toString

public String toString()

Convert to a string in a nice (displayable) format.

Overrides:

toString in class Object

transformFilename

public static String transformFilename(String fileName)

Transform a user-entered filename into a proper filename, by adding the ".fb" file extension if it isn't already present.

writeXML

public void writeXML(XMLOutput xmlOutput)
              throws IOException

Description copied from interface: XMLWriteable

Write this object to given XMLOutput.

Specified by:

writeXML in interface XMLWriteable

Parameters:

xmlOutput - the XMLOutput for the document

Throws:

IOException

writeXML

public void writeXML(XMLOutput xmlOutput,
            @CheckForNull
            File destination,
            @CheckForNull
            BugCollection bugCollection)
              throws IOException

Throws:

IOException

setTimestamp

public void setTimestamp(long timestamp)

Make the given list of pathnames absolute relative to the absolute path of the project file. private void makeListAbsoluteProject(List list) { List replace = new LinkedList(); for (String fileName : list) { fileName = convertToAbsolute(fileName); replace.add(fileName); } list.clear(); list.addAll(replace); }

addTimestamp

public void addTimestamp(long timestamp)

getTimestamp

public long getTimestamp()

setProjectName

public void setProjectName(String projectName)

getProjectName

public String getProjectName()

setSuppressionFilter

public void setSuppressionFilter(@Nonnull
                        Filter suppressionFilter)

getSuppressionFilter

@Nonnull
public Filter getSuppressionFilter()

setGuiCallback

public void setGuiCallback(IGuiCallback guiCallback)

getGuiCallback

public IGuiCallback getGuiCallback()

getResolvedSourcePaths

public Iterable<String> getResolvedSourcePaths()