Package org.aspectj.ajdt.internal.compiler

Klasse AjPipeliningCompilerAdapter

java.lang.Object

org.aspectj.ajdt.internal.compiler.AbstractCompilerAdapter

org.aspectj.ajdt.internal.compiler.AjPipeliningCompilerAdapter

Alle implementierten Schnittstellen:

ICompilerAdapter

public class AjPipeliningCompilerAdapter
extends AbstractCompilerAdapter

Adapts standard JDT Compiler to add in AspectJ specific behaviours. This version implements pipelining - where files are compiled and then woven immediately, unlike AjCompilerAdapter which compiles everything then weaves everything. (One small note: because all aspects have to be known before weaving can take place, the weaving pipeline is 'stalled' until all aspects have been compiled). The basic strategy is this: 1. diet parse all input source files - this is enough for us to implement ITD matching - this enables us to determine which are aspects 2. sort the input files, aspects first - keep a note of how many files contain aspects 3. if there are aspects, mark the pipeline as 'stalled' 3. repeat 3a. compile a file 3b. have we now compiled all aspects? NO - put file in a weave pending queue YES- unstall the 'pipeline' 3c. is the pipeline stalled? NO - weave all pending files and this one YES- do nothing Complexities arise because of: - what does -XterminateAfterCompilation mean? since there is no stage where everything is compiled and nothing is woven Here is the compiler loop difference when pipelining. the old way: Finished diet parsing [C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java] Finished diet parsing [C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java] > AjLookupEnvironment.completeTypeBindings() < AjLookupEnvironment.completeTypeBindings() compiling C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java >Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) <Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) compiling C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java >Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) <Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) >AjCompilerAdapter.weave() >BcelWeaver.prepareForWeave <BcelWeaver.prepareForWeave woven class ClassOne (from C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) woven class ClassTwo (from C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) <AjCompilerAdapter.weave() the new way (see the compiling/weaving mixed up): Finished diet parsing [C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java] Finished diet parsing [C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java] >AjLookupEnvironment.completeTypeBindings() <AjLookupEnvironment.completeTypeBindings() compiling C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java >Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) <Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) >AjCompilerAdapter.weave() >BcelWeaver.prepareForWeave <BcelWeaver.prepareForWeave woven class ClassOne (from C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassOne.java) <AjCompilerAdapter.weave() compiling C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java >Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) <Compiler.process(C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) >AjCompilerAdapter.weave() woven class ClassTwo (from C:\temp\ajcSandbox\aspectjhead\ajcTest23160.tmp\ClassTwo.java) Ungültige Eingabe: "<"AjCompilerAdapter.weave()

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
static Hashtable<String,String>	pipelineOutput
static boolean	pipelineTesting	SECRET: FOR TESTING - this can be used to collect information that tests can verify.

Konstruktorübersicht

Konstruktoren

Konstruktor

Beschreibung

AjPipeliningCompilerAdapter(Compiler compiler, boolean isBatchCompile, BcelWorld world, BcelWeaver weaver, EclipseFactory eFactory, IIntermediateResultsRequestor intRequestor, IProgressListener progressListener, IOutputClassFileNameProvider outputFileNameProvider, IBinarySourceProvider binarySourceProvider, Map fullBinarySourceEntries, boolean isXterminateAfterCompilation, boolean proceedOnError, boolean noAtAspectJProcessing, boolean makeReflectable, AjState incrementalCompilationState)

Create an adapter, and tell it everything it needs to now to drive the AspectJ parts of a compile cycle.

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	acceptResult(CompilationResult result)
void	afterAnalysing(CompilationUnitDeclaration unit)
void	afterCompiling(CompilationUnitDeclaration[] units)
void	afterDietParsing(CompilationUnitDeclaration[] units)	In a pipelining compilation system, we need to ensure aspects are through the pipeline first.
void	afterGenerating(CompilationUnitDeclaration unit)
void	afterProcessing(CompilationUnitDeclaration unit, int unitIndex)
void	afterResolving(CompilationUnitDeclaration unit)
void	beforeAnalysing(CompilationUnitDeclaration unit)
void	beforeCompiling(ICompilationUnit[] sourceUnits)
void	beforeGenerating(CompilationUnitDeclaration unit)
void	beforeProcessing(CompilationUnitDeclaration unit)
void	beforeResolving(CompilationUnitDeclaration unit)
static String	getPipelineDebugOutput(String key)
List<InterimCompilationResult>	getResultsPendingWeave()

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Felddetails

pipelineTesting

public static boolean pipelineTesting

SECRET: FOR TESTING - this can be used to collect information that tests can verify.

pipelineOutput

public static Hashtable<String,String> pipelineOutput

Konstruktordetails

AjPipeliningCompilerAdapter

public AjPipeliningCompilerAdapter(Compiler compiler,
 boolean isBatchCompile,
 BcelWorld world,
 BcelWeaver weaver,
 EclipseFactory eFactory,
 IIntermediateResultsRequestor intRequestor,
 IProgressListener progressListener,
 IOutputClassFileNameProvider outputFileNameProvider,
 IBinarySourceProvider binarySourceProvider,
 Map fullBinarySourceEntries,
 boolean isXterminateAfterCompilation,
 boolean proceedOnError,
 boolean noAtAspectJProcessing,
 boolean makeReflectable,
 AjState incrementalCompilationState)

Create an adapter, and tell it everything it needs to now to drive the AspectJ parts of a compile cycle.

Parameter:

compiler - the JDT compiler that produces class files from source

isBatchCompile - true if this is a full build (non-incremental)

world - the bcelWorld used for type resolution during weaving

weaver - the weaver

intRequestor - recipient of interim compilation results from compiler (pre-weave)

outputFileNameProvider - implementor of a strategy providing output file names for results

binarySourceProvider - binary source that we didn't compile, but that we need to weave

incrementalCompilationState - if we are doing an incremental build, and the weaver determines that we need to weave the world, this is the set of intermediate results that will be passed to the weaver.

Methodendetails

afterDietParsing

public void afterDietParsing(CompilationUnitDeclaration[] units)

In a pipelining compilation system, we need to ensure aspects are through the pipeline first. Only when they are all through (and therefore we know about all static/dynamic crosscutting) can be proceed to weave anything. Effectively the weaving part of the pipeline stalls until all the aspects have been fully compiled. This method sorts the compilation units such that any containing aspects are fully compiled first and it keeps a note on how long it should stall the pipeline before commencing weaving.

Angegeben von:

afterDietParsing in Schnittstelle ICompilerAdapter

Angegeben von:

afterDietParsing in Klasse AbstractCompilerAdapter

beforeCompiling

public void beforeCompiling(ICompilationUnit[] sourceUnits)

Angegeben von:

beforeCompiling in Schnittstelle ICompilerAdapter

Angegeben von:

beforeCompiling in Klasse AbstractCompilerAdapter

beforeProcessing

public void beforeProcessing(CompilationUnitDeclaration unit)

Angegeben von:

beforeProcessing in Schnittstelle ICompilerAdapter

Angegeben von:

beforeProcessing in Klasse AbstractCompilerAdapter

beforeResolving

public void beforeResolving(CompilationUnitDeclaration unit)

Angegeben von:

beforeResolving in Schnittstelle ICompilerAdapter

Angegeben von:

beforeResolving in Klasse AbstractCompilerAdapter

afterResolving

public void afterResolving(CompilationUnitDeclaration unit)

Angegeben von:

afterResolving in Schnittstelle ICompilerAdapter

Angegeben von:

afterResolving in Klasse AbstractCompilerAdapter

beforeAnalysing

public void beforeAnalysing(CompilationUnitDeclaration unit)

Angegeben von:

beforeAnalysing in Schnittstelle ICompilerAdapter

Angegeben von:

beforeAnalysing in Klasse AbstractCompilerAdapter

afterAnalysing

public void afterAnalysing(CompilationUnitDeclaration unit)

Angegeben von:

afterAnalysing in Schnittstelle ICompilerAdapter

Angegeben von:

afterAnalysing in Klasse AbstractCompilerAdapter

beforeGenerating

public void beforeGenerating(CompilationUnitDeclaration unit)

Angegeben von:

beforeGenerating in Schnittstelle ICompilerAdapter

Angegeben von:

beforeGenerating in Klasse AbstractCompilerAdapter

afterGenerating

public void afterGenerating(CompilationUnitDeclaration unit)

Angegeben von:

afterGenerating in Schnittstelle ICompilerAdapter

Angegeben von:

afterGenerating in Klasse AbstractCompilerAdapter

afterCompiling

public void afterCompiling(CompilationUnitDeclaration[] units)

Angegeben von:

afterCompiling in Schnittstelle ICompilerAdapter

Angegeben von:

afterCompiling in Klasse AbstractCompilerAdapter

afterProcessing

public void afterProcessing(CompilationUnitDeclaration unit,
 int unitIndex)

Angegeben von:

afterProcessing in Schnittstelle ICompilerAdapter

Angegeben von:

afterProcessing in Klasse AbstractCompilerAdapter

acceptResult

public void acceptResult(CompilationResult result)

Angegeben von:

acceptResult in Klasse AbstractCompilerAdapter

getPipelineDebugOutput

public static String getPipelineDebugOutput(String key)

getResultsPendingWeave

public List<InterimCompilationResult> getResultsPendingWeave()

Angegeben von:

getResultsPendingWeave in Klasse AbstractCompilerAdapter