Packages

  • package root
    Definition Classes
    root
  • package org
    Definition Classes
    root
  • package opalj

    OPAL is a Scala-based framework for the static analysis, manipulation and creation of Java bytecode.

    OPAL is a Scala-based framework for the static analysis, manipulation and creation of Java bytecode. OPAL is designed with performance, scalability and adaptability in mind.

    Its main components are:

    • a library (Common) which provides generally useful data-structures and algorithms for static analyses.
    • a framework for implementing lattice based static analyses (Static Analysis Infrastructure)
    • a framework for parsing Java bytecode (Bytecode Infrastructure) that can be used to create arbitrary representations.
    • a library to create a one-to-one in-memory representation of Java bytecode (Bytecode Disassembler).
    • a library to create a representation of Java bytecode that facilitates writing simple static analyses (Bytecode Representation - org.opalj.br).
    • a scalable, easily customizable framework for the abstract interpretation of Java bytecode (Abstract Interpretation Framework - org.opalj.ai).
    • a library to extract dependencies between code elements and to facilitate checking architecture definitions.
    • a library for the lightweight manipulation and creation of Java bytecode (Bytecode Assembler).

    General Design Decisions

    Thread Safety

    Unless explicitly noted, OPAL is thread safe. I.e., the classes defined by OPAL can be considered to be thread safe unless otherwise stated. (For example, it is possible to read and process class files concurrently without explicit synchronization on the client side.)

    No null Values

    Unless explicitly noted, OPAL does not null values I.e., fields that are accessible will never contain null values and methods will never return null. If a method accepts null as a value for a parameter or returns a null value it is always explicitly documented. In general, the behavior of methods that are passed null values is undefined unless explicitly documented.

    No Typecasts for Collections

    For efficiency reasons, OPAL sometimes uses mutable data-structures internally. After construction time, these data-structures are generally represented using their generic interfaces (e.g., scala.collection.{Set,Map}). However, a downcast (e.g., to add/remove elements) is always forbidden as it would effectively prevent thread-safety.

    Assertions

    OPAL makes heavy use of Scala's Assertion Facility to facilitate writing correct code. Hence, for production builds (after thorough testing(!)) it is highly recommend to build OPAL again using -Xdisable-assertions.

    Definition Classes
    org
  • package br

    In this representation of Java bytecode references to a Java class file's constant pool and to attributes are replaced by direct references to the corresponding constant pool entries.

    In this representation of Java bytecode references to a Java class file's constant pool and to attributes are replaced by direct references to the corresponding constant pool entries. This facilitates developing analyses and fosters comprehension.

    Based on the fact that indirect references to constant pool entries are resolved and replaced by direct references this representation is called the resolved representation.

    This representation of Java bytecode is considered as OPAL's standard representation for writing Scala based analyses. This representation is engineered such that it facilitates writing analyses that use pattern matching.

    Definition Classes
    opalj
  • package cfg
    Definition Classes
    br
  • BasicBlock
  • CFG
  • CFGFactory
  • CFGNode
  • CatchNode
  • ExitNode
c

org.opalj.br.cfg

BasicBlock

final class BasicBlock extends CFGNode

Represents a basic block of a method's control flow graph (CFG). The basic block is identified by referring to the first and last instruction belonging to the basic block.

Source
BasicBlock.scala
Linear Supertypes
CFGNode, Node, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. BasicBlock
  2. CFGNode
  3. Node
  4. AnyRef
  5. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new BasicBlock(startPC: Int, successors: Set[CFGNode])
  2. new BasicBlock(startPC: Int, _endPC: Int = Int.MinValue)

    startPC

    The pc of the first instruction belonging to the BasicBlock.

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def addPredecessor(predecessor: CFGNode): Unit
    Definition Classes
    CFGNode
  5. def addPredecessors(predecessor: IterableOnce[CFGNode]): Unit
    Definition Classes
    CFGNode
  6. def addSuccessor(successor: CFGNode): Unit
    Definition Classes
    CFGNode
  7. final def asBasicBlock: BasicBlock.this.type
    Definition Classes
    BasicBlockCFGNode
  8. def asCatchNode: CatchNode
    Definition Classes
    CFGNode
  9. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  10. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native() @IntrinsicCandidate()
  11. def copy(startPC: Int = this.startPC, endPC: Int = this.endPC, predecessors: Set[CFGNode] = this.predecessors, successors: Set[CFGNode] = this.successors): BasicBlock
  12. def countInstructions(implicit code: Code): Int

    Counts the instructions of this basic block.

  13. def endPC: Int

    The pc of the last instruction belonging to this basic block.

  14. def endPC_=(pc: Int): Unit
  15. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  16. def equals(other: Any): Boolean
    Definition Classes
    Node → AnyRef → Any
  17. def foreach[U](f: (Int) => U)(implicit code: Code): Unit

    Calls the function f for all instructions - identified by their respective pcs - of a basic block.

    Calls the function f for all instructions - identified by their respective pcs - of a basic block.

    f

    The function that will be called.

    code

    The org.opalj.br.Code object to which this BasicBlock implicitly belongs.

  18. final def foreachSuccessor(f: (Node) => Unit): Unit

    Applies the given function for each successor node.

    Applies the given function for each successor node.

    Definition Classes
    CFGNodeNode
  19. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @IntrinsicCandidate()
  20. final def hasSuccessors: Boolean

    Returns true if this node has successor nodes.

    Returns true if this node has successor nodes.

    Definition Classes
    CFGNodeNode
  21. def hashCode(): Int

    The hash code of this node.

    The hash code of this node. By default the hash code is the unique id.

    Definition Classes
    Node → AnyRef → Any
  22. def index(pc: Int)(implicit code: Code): Int

    Returns the index of an instruction – identified by its program counter (pc) – in a basic block.

    Returns the index of an instruction – identified by its program counter (pc) – in a basic block.

    Example

    Given a basic block which has five instructions which have the following program counters: {0,1,3,5,6}. In this case the index of the instruction with program counter 3 will be 2 and in case of the instruction with pc 6 the index will be 4.

    pc

    The program counter of the instruction for which the index is needed. pc has to satisfy: startPC <= pc <= endPC.

    code

    The code to which this basic block belongs.

  23. final def isAbnormalReturnExitNode: Boolean
    Definition Classes
    BasicBlockCFGNode
  24. final def isBasicBlock: Boolean
    Definition Classes
    BasicBlockCFGNode
  25. final def isCatchNode: Boolean
    Definition Classes
    BasicBlockCFGNode
  26. final def isExitNode: Boolean
    Definition Classes
    BasicBlockCFGNode
  27. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  28. final def isNormalReturnExitNode: Boolean
    Definition Classes
    BasicBlockCFGNode
  29. def isStartOfSubroutine: Boolean
    Definition Classes
    BasicBlockCFGNode
  30. def mayThrowException: Boolean

    Returns true if the last instruction of this basic block throws/may throw an exception; whether the exception is handled or not is not relevant!

    Returns true if the last instruction of this basic block throws/may throw an exception; whether the exception is handled or not is not relevant!

    Definition Classes
    CFGNode
  31. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  32. final def nodeId: Int

    An identifier that uniquely identifies this node in the graph to which this node belongs.

    An identifier that uniquely identifies this node in the graph to which this node belongs. By default two nodes are considered equal if they have the same unique id.

    Definition Classes
    BasicBlockNode
  33. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @IntrinsicCandidate()
  34. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @IntrinsicCandidate()
  35. def predecessors: Set[CFGNode]
    Definition Classes
    CFGNode
  36. def reachable(reflexive: Boolean = false): Set[CFGNode]

    Computes the set of all CFGNodes that are reachable from this one.

    Computes the set of all CFGNodes that are reachable from this one.

    Definition Classes
    CFGNode
    Note

    The result is not cached.

  37. def removePredecessor(predecessor: CFGNode): Unit
    Definition Classes
    CFGNode
  38. def setIsStartOfSubroutine(): Unit
  39. val startPC: Int
  40. def successors: Set[CFGNode]
    Definition Classes
    CFGNode
  41. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  42. def toHRR: Option[String]

    Returns a human readable representation (HRR) of this node.

    Returns a human readable representation (HRR) of this node.

    Definition Classes
    BasicBlockNode
  43. def toString(): String
    Definition Classes
    BasicBlock → AnyRef → Any
  44. def visualProperties: Map[String, String]
    Definition Classes
    BasicBlockNode
  45. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  46. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  47. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

Inherited from CFGNode

Inherited from Node

Inherited from AnyRef

Inherited from Any

Ungrouped