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 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.

    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. Furthermore, the concrete data-structure is always considered an implementation detail and may change at any time.

    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 av
    Definition Classes
    opalj
  • package checking

    Helper classes and functionality related to specifying architectural concerns.

    Helper classes and functionality related to specifying architectural concerns.

    Definition Classes
    av
  • AccessFlags
  • AllClasses
  • AnnotatedWith
  • AnnotationPredicate
  • AnnotationsPredicate
  • AnyAnnotation
  • AnyAnnotations
  • AnyMethod
  • ArchitectureChecker
  • Attributes
  • BinaryString
  • ClassLevelMatcher
  • ClassMatcher
  • DefaultClassMatcher
  • DependencyChecker
  • DependencyViolation
  • Equals
  • FieldMatcher
  • HasAnnotation
  • HasAtLeastOneAnnotation
  • HasAtLeastTheAnnotations
  • HasTheAnnotations
  • MethodMatcher
  • MethodWithName
  • MethodWithSignature
  • NamePredicate
  • NoAnnotations
  • NoSourceElementsMatcher
  • PackageMatcher
  • PropertyChecker
  • PropertyViolation
  • RegexNamePredicate
  • SourceElementPredicate
  • SourceElementsMatcher
  • Specification
  • SpecificationError
  • SpecificationViolation
  • StartsWith

class Specification extends AnyRef

A specification of a project's architectural constraints.

Usage

First define the ensembles, then the rules and at last specify the class files that should be analyzed. The rules will then automatically be evaluated.

The intended way to create a specification is to create a new anonymous Specification class that contains the specification of the architecture. Afterwards the specification object can be used to get the list of architectural violations.

new Specification(project) {
           ensemble('Number) { "mathematics.Number*" }
           ensemble('Rational) { "mathematics.Rational*" }
           ensemble('Mathematics) { "mathematics.Mathematics*" }
           ensemble('Example) { "mathematics.Example*" }

           'Example is_only_allowed_to (USE, 'Mathematics)
      }
Note

One ensemble is predefined: Specification.empty it represents an ensemble that contains no source elements and which can, e.g., be used to specify that no "real" ensemble is allowed to depend on a specific ensemble.

Self Type
Specification
Source
Specification.scala
Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Specification
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Specification(classFiles: Traversable[(ClassFile, URL)], useAnsiColors: Boolean = false)
  2. new Specification(project: Project[URL])

    Creates a new Specification for the given Project.

    Creates a new Specification for the given Project. Error messages will not use ANSI colors.

  3. new Specification(project: Project[URL], useAnsiColors: Boolean)

Type Members

  1. case class GlobalIncomingConstraint(targetEnsemble: Symbol, sourceEnsembles: Seq[Symbol]) extends DependencyChecker with Product with Serializable
  2. case class LocalOutgoingAnnotatedWithConstraint(sourceEnsemble: Symbol, annotationPredicates: Seq[AnnotationPredicate], property: String, matchAny: Boolean) extends PropertyChecker with Product with Serializable

    Checks whether all elements in the source ensemble are annotated with the given annotation.

    Checks whether all elements in the source ensemble are annotated with the given annotation.

    Example Scenario

    If every element in the ensemble ex should be annotated with ey and the source element x which belongs to ensemble ex has no annotation that matches ey then a SpecificationViolation is generated.

    sourceEnsemble

    An ensemble containing elements, that should be annotated.

    annotationPredicates

    The annotations that should match.

    property

    A description of the property that is checked.

    matchAny

    true if only one match is needed, false if all annotations should match

  3. case class LocalOutgoingNotAllowedConstraint(dependencyTypes: Set[DependencyType], sourceEnsemble: Symbol, targetEnsembles: Seq[Symbol]) extends DependencyChecker with Product with Serializable

    Forbids the given local dependencies between a specific source ensemble and several target ensembles.

    Forbids the given local dependencies between a specific source ensemble and several target ensembles.

    Example Scenario

    If the ensemble ex is not allowed to use ey and the source element x which belongs to ensemble ex has one if the given dependencies on a source element belonging to ey then a SpecificationViolation is generated.

  4. case class LocalOutgoingOnlyAllowedConstraint(dependencyTypes: Set[DependencyType], sourceEnsemble: Symbol, targetEnsembles: Seq[Symbol]) extends DependencyChecker with Product with Serializable

    Allows only the given local dependencies between a specific source ensemble and several target ensembles.

    Allows only the given local dependencies between a specific source ensemble and several target ensembles.

    Example Scenario

    If the ensemble ex is only allowed to throw exceptions ey and the source element x which belongs to ensemble ex throws an exception not belonging to ey then a SpecificationViolation is generated.

  5. case class LocalOutgoingShouldExtendConstraint(sourceEnsemble: Symbol, targetEnsembles: Seq[Symbol]) extends PropertyChecker with Product with Serializable

    Checks whether all elements in the source ensemble extends any of the given elements.

    Checks whether all elements in the source ensemble extends any of the given elements. The source ensemble should contain only class elements otherwise a SpecificationError will be thrown.

    sourceEnsemble

    An ensemble containing classes, that should implement the given method.

    targetEnsembles

    Ensembles containing elements, that should be extended by the given classes.

  6. case class LocalOutgoingShouldImplementMethodConstraint(sourceEnsemble: Symbol, methodPredicate: SourceElementPredicate[Method]) extends PropertyChecker with Product with Serializable

    Checks whether all elements in the source ensemble implement the given method.

    Checks whether all elements in the source ensemble implement the given method. The source ensemble should contain only class elements otherwise a SpecificationError will be thrown.

    sourceEnsemble

    An ensemble containing classes, that should implement the given method.

    methodPredicate

    The method to match.

  7. case class SpecificationFactory(contextEnsembleSymbol: Symbol) extends Product with Serializable

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 EnsembleID(ensembleName: String): Symbol

    Creates a Symbol with the given name.

    Creates a Symbol with the given name.

    This method is primarily useful if ensemble names are created programmatically and the code should communicate that the created name identifies an ensemble. E.g., instead of

    for (moduleID <- 1 to 10) Symbol("module"+moduleID)

    it is now possible to write

    for (moduleID <- 1 to 10) EnsembleID("module"+moduleID)

    which better communicates the intention.

  5. implicit def EnsembleSymbolToSpecificationElementFactory(ensembleSymbol: Symbol): SpecificationFactory
    Attributes
    protected
  6. implicit def EnsembleToSourceElementMatcher(ensembleSymbol: Symbol): SourceElementsMatcher
    Attributes
    protected
  7. implicit def FileToClassFileProvider(file: File): Seq[(ClassFile, URL)]

    Returns the class files stored at the given location.

  8. implicit def StringToSourceElementMatcher(matcher: String): SourceElementsMatcher

    Facilitates the definition of common source element matchers by means of common String patterns.

    Facilitates the definition of common source element matchers by means of common String patterns.

    Annotations
    @throws( classOf[SpecificationError] )
  9. final val USE: Set[DependencyType]

    The set of all org.opalj.de.DependencyTypes.

  10. def analyze(): Set[SpecificationViolation]
  11. var architectureCheckers: List[ArchitectureChecker]
  12. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  13. def classes(matcher: Regex): SourceElementsMatcher
  14. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @native() @throws( ... )
  15. val empty: Symbol

    Represents an ensemble that contains no source elements.

    Represents an ensemble that contains no source elements. This can be used, e.g., to specify that a (set of) specific source element(s) is not allowed to depend on any other source elements (belonging to the project).

  16. def ensemble(ensembleSymbol: Symbol)(sourceElementsMatcher: SourceElementsMatcher): Unit

    Adds a new ensemble definition to this architecture specification.

    Adds a new ensemble definition to this architecture specification.

    Annotations
    @throws( classOf[SpecificationError] )
    Exceptions thrown

    SpecificationError If the ensemble is already defined.

  17. def ensembleExtentsToString: String

    Can be called after the evaluation of the extents of the ensembles to print out the current configuration.

  18. def ensembleToString(ensembleSymbol: Symbol): String

    Returns a textual representation of an ensemble.

  19. def ensembles: Map[Symbol, (SourceElementsMatcher, Set[VirtualSourceElement])]

    The set of defined ensembles.

    The set of defined ensembles. An ensemble is identified by a symbol, a query which matches source elements and the project's source elements that are matched. The latter is available only after analyze was called.

  20. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  21. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  22. def finalize(): Unit
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  23. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  24. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  25. def incomingDependencies: Map[VirtualSourceElement, Set[(VirtualSourceElement, DependencyType)]]

    Mapping between a source element and those source elements that depend on it.

    Mapping between a source element and those source elements that depend on it.

    This mapping is automatically created when analyze is called.

  26. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  27. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  28. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  29. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  30. def outgoingDependencies: Map[VirtualSourceElement, Map[VirtualSourceElement, DependencyTypesSet]]

    Mapping between a source element and those source elements it depends on/uses.

    Mapping between a source element and those source elements it depends on/uses.

    This mapping is automatically created when analyze is called.

  31. val project: Project[URL]
  32. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  33. def toString(): String
    Definition Classes
    AnyRef → Any
  34. val useAnsiColors: Boolean
  35. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  36. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  37. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped