The analysis that will be executed.
The analysis that will be executed.
The analyze
method implemented by the analysis will be called after loading
all class files and creating a Project
. Additionally,
all specified (additional) parameters are passed to the analyze method.
Describes the analysis specific parameters.
Describes the analysis specific parameters. An analysis specific parameter has to start with a dash ("-") and has to contain an equals sign ("=").
The parameter -library=
is already predefined (see general documentation).
The parameter -cp=
is already predefined (see general documentation).
Analyzes the given project and reports the result(s).
Analyzes the given project and reports the result(s).
A function to get a
org.opalj.br.analyses.ProgressManagement object.
The function is called by the analysis for each major analysis with the
number of steps (Int) that will be performed . The analysis will subsequently
use that object to report status information (related to that part of the analysis)
and to check the interrupted status.
The number of steps is at least 1.
The analysis may call this function multiple times. However, the last End
event always has be signaled using the first ProgressManagement
object.
In other words, logically nested calls are supported, but chaining is not.
A legal call sequence could be:
val pouter = initProgressManagement(2) pouter.progress(1,Start,Some("call graph analysis")) // ... construct call graph pouter.progress(1,End,None) pouter.progress(2,Start,Some("analyzing class files")) val p2 = initProgressManagement(500) // SEVERAL CLASS FILES ARE ANALYZED IN PARALLEL: p2.progress(1,Start,Some("java.lang.Object")) p2.progress(2,Start,Some("java.util.ArrayList")) p2.progress(3,Start,Some("java.lang.String")) p2.progress(2,End,Some("java.util.ArrayList")) p2.progress(4,Start,Some("java.util.Date")) ... p2.progress(500,End,None) pouter.progress(2,End,None)
The analysis' result. If the analysis was aborted/killed the analysis
should return an appropriate result (which might be null
) and this
has to be specified/documented by the analysis.
Checks if the (additional) parameters are understood by the analysis.
Checks if the (additional) parameters are understood by the analysis. If an error is found a list of issues is returned and the analysis will not be executed.
This method must be overridden if the analysis defines additional
parameters. A method that overrides this method should return
the list of
issues if it can't validate all arguments.
The default behavior is to check that there are no additional parameters.
The copyright statement which contains less than 124 character and no line-breaks.
The copyright statement which contains less than 124 character and no line-breaks.
A textual description of this analysis.
A textual description of this analysis.
The description should discuss:
A URL at which documentation about this analysis can be found.
A URL at which documentation about this analysis can be found. This allows user interfaces to show a link for the user to click on, as a way to access further documentation about this analysis.
For example, for a command line interface, outputting the entire description
to
the console may not be desirable, and it could show this URL instead.
This is just a String
, not a java.net.URL
, because we do not intend to use it
as an URL internally. It is just a text string that can be shown to the user.
Prints out general information how to use this analysis.
Prints out general information how to use this analysis. Printed whenever the set of specified parameters is not valid.
A short descriptive title which should contain less than 64 characters and no line-breaks.
A short descriptive title which should contain less than 64 characters and no line-breaks.
The default is the simple name of the class implementing the analysis.
Default implementation of one step analysis.