ASM

From: mkersten Date: Mon, 11 Aug 2003 08:39:05 +0000 (+0000) Subject: Expanded developer documentation. Moved ASM doc to MSWord format since it will have... X-Git-Tag: V1_1_1~100 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=9befa0a653ef07238f4072163813012013fed748;p=aspectj.git Expanded developer documentation. Moved ASM doc to MSWord format since it will have graphics and revision support will help. --- diff --git a/docs/developer/asm.doc b/docs/developer/asm.doc new file mode 100644 index 000000000..608f8dca5 Binary files /dev/null and b/docs/developer/asm.doc differ diff --git a/docs/developer/asm.html b/docs/developer/asm.html deleted file mode 100644 index ddb97658d..000000000 --- a/docs/developer/asm.html +++ /dev/null @@ -1,418 +0,0 @@ - - - - - - - -ASM - - - - - -

Abstract Structure Model (ASM) & Views

...

Model

AspectJ Members

pointcut
- pointcut Id(Types)
-
advice
- after(Types)
- after(Types) returning [(Formal)]
- after(Types) throwing [(Formal)]
- around(Types) : Type
- [throws Type]
- before
-
inter-type member declarations
- Id(Types) : Type
- Id : Type
-
other inter-type declarations
- declare parents : Type ???
- declare warning : "<first words of String>.."
- declare error : "<first world of String>.."
- declare soft : Type
- declare precedence
-

Advice Relationships

advises / advised by -
- call -
  - method/constructor call site
  -
- execution -
  - method/constructor declaration
  -
- initialization -
  - type declaration otherwise -
  -
- preinitiatialization
  - constructor declaration
  -
- staticinitialization -
  - type declaration otherwise -
  -
- get -
  - field access site
  -
- set -
  - field assignment site
  -
- handler -
  - catch statement
  -
- adviceexecution -
  - advice declaration
  -
-
uses control flow / control flow used by - -
- cflow - -
  - method declaration / call site
  -
- cflowbelow - -
  - method declaration
  -
-

Additional Inheritance Relationships

inherits / inherited by -
- aspect declaration -
  - abstract aspect declaration
  -
-
specifies / specified by - -
- concrete pointcut -
  - abstract pointcut -
  -
-
uses dynamic test / dynamic test used by - -
- if - -
  - conditional expression

Additional Referential Relationships

uses pointcut / pointcut used by -
- advice declaration -
  - pointcut
  -
- pointcut -
  - pointcut
  -
-
is specified per / pointcut used by - -
- aspect declaration - -
  - pointcut declaration
  -
-

Inter-Type Declarations

declares on / introduced declarations -
- inter-type declaration -- do these show up ???
  - type declaration
  -
- soft declaration -
  - method declaration
  -
-
declares static check / matched by static check -
- error/warning declare declaration -
  - <any PCD match>
  -
-
declares precedence on - -
- precedence declaration - -
  - aspect declaration
  -
-

Runtime Stuff

Stack mapper for thread tree and error handler

Edit Semantics (Refactoring)

Refactorings

update PCD when refactoring method affected by some advice using that - PCD

Views

Declaration Hierarchy

...

Used by

Navigator
Outline view
Code assist

Relationships

joinpoint ordering as a relationship, e.g.
- <method>
  - join point execution ordered by -
    - <declare dominates>
    -
  - advised by
    - around start
    - before
    - <method>
    - after
    - around end
    -
  -
-

Used by:

editor & outline assist
gutter annotations
debugger

- -

Pointcut Usage Hierarchy

Like Eclipse's Type Hierarchy, but generated with "uses pointcut" -association. Shows "advises" relationships inline.

Editor

create keyword highlighting guideline

Javadoc Documentation

...

UML Static Structure

...

UI Stuff

default constructors & initializers: promote to relation to type - declaration, or just move source location to type declaration, but show - nodes in tree ??
declare warning/error UI: messages should have annotation
declare error/warning task list items should the declare member's icons
matches deferred (pointcut search, join point probe)

- -

- - - - \ No newline at end of file diff --git a/docs/developer/compiler.html b/docs/developer/compiler.html index 0b082ff92..da99eb57e 100644 --- a/docs/developer/compiler.html +++ b/docs/developer/compiler.html @@ -140,7 +140,7 @@ -

AspectJ Compiler Desgin

AspectJ Compiler Design

Todo: add content. In the meantime, the following email post have relevant content:

is what makes it possible for people to really work with crosscutting diff --git a/docs/developer/weaver.html b/docs/developer/weaver.html new file mode 100644 index 000000000..76a11aab1 --- /dev/null +++ b/docs/developer/weaver.html @@ -0,0 +1,156 @@ + + + + + + + +AJDT Project Proposal + + + + + +

AspectJ Compiler Design

Todo: add content. In the meantime, the following email post have +relevant content:

"What does the weaver take as input? How does it know where to + insert advice?"
+ + http://dev.eclipse.org/mhonarc/lists/aspectj-dev/msg00519.html
+