Developer’s help guide to building knowledge together with AJDT and AspectJ

This site is intended to support any individual developing knowledge to give or work with AJDT/AspectJ. Kindly donate to this page with any appropriate information, such as example code utilizing the AJDT and/or AspectJ APIs.

These pages may be out of day. All of our intention is upgrade this site for AJDT 1.6.1, but we’ve got perhaps not have times for this yet. Please recognize that a few of understanding with this webpage may no longer be proper. If you have questions, be sure to deliver them to the mailing list ajdt-dev.

Information

• 1 buying crosscutting connection details from AJDT
• 2 Compilation Products in AJDT
  • 2.1 obtaining items in an AJCompilationUnit
• 3 Using the AspectJ AST parser
• 4 recognized restrictions, bugs, and exceptional dilemmas
• 5 The user interface tools are expected to make use of to-drive the AspectJ compiler

Getting crosscutting union details from AJDT

In case you are creating an eclipse plugin and need the means to access crosscutting suggestions whenever a task is created, you are able to enter a listener with AJDT. Your plug-in will need to be determined by org.eclipse.ajdt.core, org.eclipse.core.resources and org.eclipse.jdt.core, and org.aspectj.weaver. In org.eclipse.ajdt.core plug-in there can be an IAdviceChangedListener software with just one adviceChanged() approach.

Join this using the AJBuilder course like this (inside plug-in’s start() means for sample):

Presently (AJDT 1.6) this is also known as after each create of an AspectJ venture (in other words. every *potential* suggestions change). In a future production this may be optimized as best known as in the event the guidance provides actually changed. AJDT/UI https://datingranking.net/cs/equestriansingles-recenze/ makes use of this process to modify the tangerine arrow picture decorator.

Crosscutting facts are able to feel extracted from the AJProjectModelFacade course. Listed here is an example with pseudo code you can easily adapt:

A number of records about that:

1. The API might have some lesser alterations in the near future. Be sure to send an email on the ajdt-dev mailing list if nothing about this webpage is out of time.
2. The AJProjectModelFacade object try a light access inside AspectJ world. It is only valid before the then create. Thus, don’t shop all of them. Utilize them and dispose as needed.
3. AJProjectModelFacade stuff just have facts following the very first profitable create. It is possible to phone the hasModel() approach to see if an AspectJ product is present your task.
4. As you can tell, you obtain the connection in guidelines. Discover AJRelationshipManager for any full listing of relationships, in order to only ask for the connection kinds you’re interested in.
5. IRelationship.getSourceHandle() and IRelationship.getgoals() return chain that portray AspectJ aspect manages. You need the next AJProjectModelFacade methods to convert to model factors:
   • toProgramElement(String) — profits IProgramElement. From this point it is possible to obtain information on the pointcut, intertype element, or declare aspect.
   • programElementToJavaElement(String) or programElementToJavaElement(IProgramElement) — returns IJavaElement. From this point you’ll be able to hook into JDT tooling.
6. There isn’t any requirement to join up a suggestions changed listener. You can aquire the means to access the crosscutting product at any time (assuming that your panels has received a fruitful acquire) utilising the next signal:

Collection Models in AJDT

JDT brings compilation units (cases of ICompilationdevice) for .java data files. AJDT creates collection devices for .aj data, that are instances of AJCompilationUnit (which implements ICompilationdevice). The class AJCompilationUnitManager (inside the org.eclipse.ajdt.core plug-in) includes some of use methods concerning this, such:

From an AJCompilationUnit you’ll be able to get different structural information such as getAllTypes(). The principal type for «.aj» files is typically an element, in fact it is symbolized by the AspectElement course, containing aspect-specific methods like getPointcuts() and getAdvice(). These return further aspect-specific areas such as PointcutElement and AdviceElement.

Since AJDT 1.6.2 for Eclispe 3.4, we utilize the Eclipse weaving solution to weave into JDT. One collection of join details being recommended are those related to the creation of CompilationUnit items. In the event that file has actually is actually *.aj file, AJCompilationUnit is generated as opposed to a regular coffee Compilationdevice.

Having the belongings in an AJCompilationUnit

Because JDT wants that every origin it functions with is true coffee signal, JDT can not work really with AspectJ. In order to get for this, AJCompilationUnits keep two buffers that have supply information. The first is a java suitable buffer and 2nd is the original contents buffer. The java compatible buffer is the buffer that will be returned by default whenever AJCompilationUnit.getContents() is named. This buffer contains the AspectJ signal along with aspect-specific syntax stripped down. The initial information buffer consists of (while you would anticipate) the first articles of this file.

Eg if the initial contents buffer seems like:

the coffee compatible buffer is

Realize that the origin stores in the identifiers are exactly the same in both buffers. This helps to ensure that research acquiring and hyperlinking work as expected.

In the event that you require using the first contents of an AspectJ CompilationUnit ajproduct, you can do the immediate following:

What this method really does requests the AJCU to briefly turn their buffer with the AJ buffer from the Java buffer. It is advisable to do that in a synchronized block so that you never chance various other threads coming by and accidentally with the completely wrong buffer (AJDT by itself doesn’t incorporate a synchronized block for this, nevertheless should).

Using the AspectJ AST parser

Fundamental example, obtained from bug 88861

Make these and manage it:

Known restrictions, bugs, and outstanding issues

Restriction: there’s presently no AST help for solving type bindings: insect 146528