package analyses
- Alphabetic
- By Inheritance
- analyses
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Type Members
- case class AnalysisException(message: String, cause: Throwable = null) extends RuntimeException with Product with Serializable
Exception raised while the analysis is executed.
- case class BasicReport(toConsoleString: String) extends ReportableAnalysisResult with Product with Serializable
Result of some analysis that just consists of some text.
Result of some analysis that just consists of some text.
- toConsoleString
A string printed to the console.
- class DeclaredFields extends AnyRef
- class DeclaredMethods extends AnyRef
The set of all org.opalj.br.DeclaredMethods (potentially used by the property store).
- case class FieldAccessInformation(project: SomeProject) extends Product with Serializable
Acts as a proxy for the propertyStore, accessing FieldReadAccessInformation and FieldWriteAccessInformation.
Acts as a proxy for the propertyStore, accessing FieldReadAccessInformation and FieldWriteAccessInformation. Should be computed outside of any FPCF phases as it cannot handle intermediate values.
- case class InconsistentProjectException(message: String, severity: Level = Warn) extends Exception with Product with Serializable
Thrown when the framework determines that the project is not consistent.
- abstract class MethodAnalysisApplication extends ProjectsAnalysisApplication
A small framework to implement analyses which should be executed for a given set of methods.
- final class MethodDeclarationContext extends Ordered[MethodDeclarationContext]
Encapsulates the information about a non-abstract, non-static method which is not an initializer (
<(cl)init>) and which is required when determining potential call targets.Encapsulates the information about a non-abstract, non-static method which is not an initializer (
<(cl)init>) and which is required when determining potential call targets.- Note
A class may have -- w.r.t. a given package name -- at most one package visible method which has a specific name and descriptor combination. For methods with protected or public visibility a class always has at most one method with a given name and descriptor.
,Equality is defined based on the name, descriptor and declaring package of a method (the concrete declaring class is not considered!).
- case class MethodInfo[Source](source: Source, method: Method) extends Product with Serializable
Encapsulates the source of a method.
- case class ModuleDefinition[Source](module: ClassFile, source: Option[Source]) extends Product with Serializable
- class Project[Source] extends si.Project with ProjectLike
Primary abstraction of a Java project; i.e., a set of classes that constitute a library, framework or application as well as the libraries or frameworks used by the former.
Primary abstraction of a Java project; i.e., a set of classes that constitute a library, framework or application as well as the libraries or frameworks used by the former.
This class has several purposes:
- It is a container for
ClassFiles. - It directly gives access to the project's class hierarchy.
- It serves as a container for project-wide information (e.g., a call graph,
information about the mutability of classes, constant values,...) that can
be queried using org.opalj.br.analyses.ProjectInformationKeys.
The list of project wide information that can be made available is equivalent
to the list of (concrete/singleton) objects implementing the trait
org.opalj.br.analyses.ProjectInformationKey.
One of the most important project information keys is the
PropertyStoreKeywhich gives access to the property store.
Thread Safety
This class is thread-safe.
Prototyping Analyses/Querying Projects
Projects can easily be created and queried using the Scala
REPL. For example, to create a project, you can use:val project = org.opalj.br.analyses.Project(org.opalj.bytecode.JRELibraryFolder)Now, to determine the number of methods that have at least one parameter of type
int, you can use:project.methods.filter(_.parameterTypes.exists(_.isIntegerType)).size
- Source
The type of the source of the class file. E.g., a
URL, aFile, aStringor a Pair(JarFile,JarEntry). This information is needed for, e.g., presenting users meaningful messages w.r.t. the location of issues. We abstract over the type of the resource to facilitate the embedding in existing tools such as IDEs. E.g., in EclipseIResource's are used to identify the location of a resource (e.g., a source or class file.)
- It is a container for
- trait ProjectBasedAnalysis extends si.ProjectBasedAnalysis
Common super trait of all analyses that use the fixpoint computations framework.
Common super trait of all analyses that use the fixpoint computations framework. In general, an analysis computes a org.opalj.fpcf.Property by processing some entities, e.g.: ´classes´, ´methods´ or ´fields´.
- class ProjectIndex extends AnyRef
An index that enables the efficient lookup of source elements (methods and fields) given the method's/field's name and the descriptor/field type.
An index that enables the efficient lookup of source elements (methods and fields) given the method's/field's name and the descriptor/field type. The index contains fields with public, protected,
<default>and private visibility.Basically an index of the source elements (methods and fields) of a project.
This index can be used, e.g., to resolve method calls based on the method's names and/or descriptors.
To get an instance of a project index call Project.get and pass in the ProjectIndexKey object.
- See also
FieldAccessInformation to get the information where a field is accessed.
- trait ProjectInformationKey[T <: AnyRef, I <: AnyRef] extends si.ProjectInformationKey[SomeProject, T, I]
- type ProjectInformationKeys = Seq[si.ProjectInformationKey[_ <: si.Project, _ <: AnyRef, _ <: AnyRef]]
- trait ProjectLike extends ClassFileRepository
Enables project wide lookups of methods and fields as required to determine the target(s) of an invoke or field access instruction.
Enables project wide lookups of methods and fields as required to determine the target(s) of an invoke or field access instruction.
- Note
The current implementation is based on the correct project assumption; i.e., if the bytecode of the project as a whole is not valid, the result is generally undefined. Just one example of a violation of the assumption would be, if we have two interfaces which define a non-abstract method with the same signature and both interfaces are implemented by a third interface which does not override these methods. In this case the result of a
resolveMethodReferenceis not defined, because the code base as a whole is not valid.
- abstract class ProjectsAnalysisApplication extends AnyRef
Default command-line runner implementation for analyses to be applied to one or more projects.
Default command-line runner implementation for analyses to be applied to one or more projects.
Subclasses can either implement analyze, creating a ReportableAnalysisResult, or override evaluate.
- trait ReportableAnalysisResult extends AnyRef
Result of analyses that can be meaningfully represented using text.
- type SomeProject = Project[_]
Type alias for Projects with arbitrary sources.
- type StringConstantsInformation = Map[String, ArraySeq[PCInMethod]]
- final class VirtualFormalParameter extends AnyRef
Explicitly models a formal parameter of a DeclaredMethod to make it possible to store it in the property store and to compute properties for it.
Explicitly models a formal parameter of a DeclaredMethod to make it possible to store it in the property store and to compute properties for it.
The first parameter explicitly defined by the method will have the origin
-2, the second one will have the origin-3and so on. That is, the origin of an explicitly declared parameter is always-(parameter_index + 2). The origin of thethisparameter is-1.- Note
The computational type category of the parameters is ignored to ease the mapping.
,This encoding is also used by the default three address code representation generated using a local data-flow analysis (see org.opalj.tac.TACAI). In case of the bytecode based data-flow analysis the origin used by the analysis reflects the position of the parameter value on the tac; see org.opalj.ai.parameterIndexToValueOrigin.
- class VirtualFormalParameters extends AnyRef
The set of all explicit and implicit virtual formal method parameters in a project.
The set of all explicit and implicit virtual formal method parameters in a project. The set also contains virtual formal parameters of library methods.
Value Members
- object BasicMethodInfo
Defines a simplified extractor for a MethodInfo object.
- object BasicReport extends Serializable
Defines factory methods for BasicReports.
- object DeclaredFieldsKey extends ProjectInformationKey[DeclaredFields, Nothing]
- object DeclaredMethodsKey extends ProjectInformationKey[DeclaredMethods, Nothing]
The key object to get information about all declared methods.
The key object to get information about all declared methods.
To get the index use the org.opalj.br.analyses.Project's
getmethod and pass inthisobject.- Note
See org.opalj.br.DeclaredMethod for further details.
Example: - object FieldAccessInformationAnalysis
This analysis determines where each field is accessed.
This analysis determines where each field is accessed.
Usage
Use the FieldAccessInformationKey to query a project about the field access information.
val accessInformation = project.get(FieldAccessInformationKey)- Note
The analysis does not take reflective field accesses into account.
,The analysis is internally parallelized and should not be run with other analyses in parallel.
,Fields which are not accessed at all are not further considered.
- object FieldAccessInformationKey extends ProjectInformationKey[FieldAccessInformation, Seq[FPCFAnalysisScheduler]]
The key object to get global field access information.
The key object to get global field access information. Runs the EagerSimpleFieldAccessInformationAnalysis if no analyses were given in the initialization data.
To get the index use the Project's
getmethod and pass inthisobject.
Example: - object MethodDeclarationContext
Definition of factory and extractor methods for MethodDeclarationContext objects.
- implicit object MethodDeclarationContextOrdering extends Ordering[MethodDeclarationContext]
- object Project
Definition of factory methods to create Projects.
- object ProjectIndex
Factory for ProjectIndex objects.
- object ProjectIndexKey extends ProjectInformationKey[ProjectIndex, Nothing]
The key object to get an index of the source elements of a project.
The key object to get an index of the source elements of a project.
To get the index use the Project's
getmethod and pass inthisobject.
Example: - object ProjectLike
- object ReportableAnalysisResult
- object StringConstantsInformationKey extends ProjectInformationKey[StringConstantsInformation, Nothing]
The key object to get information about all string constants found in the project's code.
The key object to get information about all string constants found in the project's code.
To get the index use the Project's
getmethod and pass inthisobject.
Example: - object VirtualFormalParameter
- object VirtualFormalParametersKey extends ProjectInformationKey[VirtualFormalParameters, Nothing]
The key object to get information about all virtual formal parameters.
The key object to get information about all virtual formal parameters.
To get the index use the org.opalj.br.analyses.Project's
getmethod and pass inthisobject.- Note
See org.opalj.br.analyses.VirtualFormalParameter and VirtualFormalParameters for further details.
Example: