| <html><head> |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <title>Chapter 3. AspectJ Core Files</title><link rel="stylesheet" href="aspectj-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.44"><link rel="home" href="index.html" title="The AspectJtm Problem Diagnosis Guide"><link rel="up" href="index.html" title="The AspectJtm Problem Diagnosis Guide"><link rel="previous" href="pointcuts-debugging.html" title="Debugging pointcuts"><link rel="next" href="trace.html" title="Chapter 4. Tracing"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. AspectJ Core Files</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pointcuts-debugging.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="trace.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><h2 class="title"><a name="ajcore"></a>Chapter 3. AspectJ Core Files</h2></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><a href="ajcore.html#ajcore-introduction">Introduction</a></dt><dd><dl><dt><a href="ajcore.html#configuration">Configuring dump files</a></dt><dt><a href="ajcore.html#ajcore-examples">AJCore File Examples</a></dt></dl></dd></dl></div><div class="sect1"><a name="ajcore-introduction"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="ajcore-introduction"></a>Introduction</h2></div></div><p> When the compiler terminates abnormally, either because a particular kind of message was |
| issued or an exception was thrown, an AspectJ core file will be produced. You will |
| find it the working directory of the compiler and it will have a name that contains |
| the date and time that the file was produced |
| e.g. <tt>ajcore.20060810.173655.626.txt</tt>. The file contains details |
| of the problem such as the exception thrown as well as information about the |
| environment such as operating system and Java version. When submitting a bug, |
| include this file whenever it is available.</p><div class="sect2"><a name="configuration"></a><div class="titlepage"><div><h3 class="title"><a name="configuration"></a>Configuring dump files</h3></div></div><p> By default AspectJ will only create an <tt>ajcore</tt> file |
| when an unexpected exception is thrown by the weaver or an |
| <tt>abort</tt> message is |
| issued. However it is possible to disable this feature or enable files to |
| be produced under different circumstances. The table below lists the System |
| properties that can be used to configure <tt>ajcore</tt> files. </p><div class="informaltable" id="d0e450"><a name="d0e450"></a><table border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Property</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><tt>org.aspectj.weaver.Dump.exception</tt></td><td><tt>true</tt></td><td> |
| Generate an <tt>ajcore</tt> files when an exception thrown. |
| </td></tr><tr><td><tt>org.aspectj.weaver.Dump.condition</tt></td><td><tt>abort</tt></td><td> |
| Message kind for which to generate <tt>ajcore</tt> |
| e.g. <tt>error</tt>. |
| </td></tr><tr><td><tt>org.aspectj.dump.directory</tt></td><td><tt>none</tt></td><td> |
| The directory used for ajcore files. |
| </td></tr></tbody></table></div></div><div class="sect2"><a name="ajcore-examples"></a><div class="titlepage"><div><h3 class="title"><a name="ajcore-examples"></a>AJCore File Examples</h3></div></div><p> Below is an extract from an <tt>ajcore</tt> file. You will see |
| details of the dump configuration as well as the exception (with stack trace) that |
| is the source of the problem and any messages issued by the compiler. Most importantly |
| the exact version of AspectJ is included. </p><pre class="programlisting"> |
| ---- AspectJ Properties --- |
| AspectJ Compiler DEVELOPMENT built on Tuesday Jul 25, 2006 at 13:00:09 GMT |
| ---- Dump Properties --- |
| Dump file: ajcore.20060810.173655.626.txt |
| Dump reason: java.lang.NoClassDefFoundError |
| Dump on exception: true |
| Dump at exit condition: abort |
| ---- Exception Information --- |
| java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory |
| at org.aspectj.weaver.tools.CommonsTraceFactory.<init>(CommonsTraceFactory.java:17) |
| at java.lang.Class.newInstance0(Native Method) |
| at java.lang.Class.newInstance(Class.java:232) |
| at org.aspectj.weaver.tools.TraceFactory.<clinit>(TraceFactory.java:35) |
| at org.aspectj.weaver.World.<clinit>(World.java:114) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.initBcelWorld(AjBuildManager.java:679) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.doBuild(AjBuildManager.java:224) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.batchBuild(AjBuildManager.java:164) |
| at org.aspectj.ajdt.ajc.AjdtCommand.doCommand(AjdtCommand.java:112) |
| at org.aspectj.ajdt.ajc.AjdtCommand.runCommand(AjdtCommand.java:60) |
| at org.aspectj.tools.ajc.Main.run(Main.java:367) |
| at org.aspectj.tools.ajc.Main.runMain(Main.java:246) |
| at org.aspectj.tools.ajc.Main.main(Main.java:86) |
| ---- System Properties --- |
| java.runtime.name=Java(TM) 2 Runtime Environment, Standard Edition |
| sun.boot.library.path=C:\jdk1.3.1_16\jre\bin |
| java.vm.version=1.3.1_16-b06 |
| java.vm.vendor=Sun Microsystems Inc. |
| java.vendor.url=http://java.sun.com/ |
| path.separator=; |
| java.vm.name=Java HotSpot(TM) Client VM |
| file.encoding.pkg=sun.io |
| java.vm.specification.name=Java Virtual Machine Specification |
| user.dir=C:\workspaces\org.aspectj\org.aspectj.ant.tests |
| java.runtime.version=1.3.1_16-b06 |
| java.awt.graphicsenv=sun.awt.Win32GraphicsEnvironment |
| os.arch=x86 |
| java.io.tmpdir=C:\DOCUME~1\IBM_user\LOCALS~1\Temp\ |
| line.separator= |
| |
| java.vm.specification.vendor=Sun Microsystems Inc. |
| java.awt.fonts= |
| os.name=Windows XP |
| java.library.path=C:\jdk1.3.1_16\jre\bin;... |
| java.specification.name=Java Platform API Specification |
| java.class.version=47.0 |
| os.version=5.1 |
| user.home=C:\Documents and Settings\IBM_user |
| user.timezone=Europe/London |
| java.awt.printerjob=sun.awt.windows.WPrinterJob |
| file.encoding=Cp1252 |
| java.specification.version=1.3 |
| java.class.path=C:\workspaces\org.aspectj\aj-build\dist\tools\lib\aspectjtools.jar |
| user.name=IBM_user |
| java.vm.specification.version=1.0 |
| java.home=C:\jdk1.3.1_16\jre |
| user.language=en |
| java.specification.vendor=Sun Microsystems Inc. |
| awt.toolkit=sun.awt.windows.WToolkit |
| java.vm.info=mixed mode |
| java.version=1.3.1_16 |
| java.ext.dirs=C:\jdk1.3.1_16\jre\lib\ext |
| sun.boot.class.path=C:\jdk1.3.1_16\jre\lib\rt.jar;... |
| java.vendor=Sun Microsystems Inc. |
| file.separator=\ |
| java.vendor.url.bug=http://java.sun.com/cgi-bin/bugreport.cgi |
| sun.io.unicode.encoding=UnicodeLittle |
| sun.cpu.endian=little |
| user.region=GB |
| sun.cpu.isalist=pentium i486 i386 |
| ---- Command Line --- |
| -d |
| C:\workspaces\org.aspectj\org.aspectj.ant.tests\IncrementalAjcTaskTest-temp |
| -g:none |
| -deprecation |
| -noExit |
| -warn:-unusedImport |
| -nowarn |
| -XterminateAfterCompilation |
| -preserveAllLocals |
| -proceedOnError |
| -referenceInfo |
| -source |
| 1.3 |
| -target |
| 1.1 |
| -time |
| -verbose |
| -classpath |
| C:\workspaces\org.aspectj\org.aspectj.ant.tests\..\lib\test\aspectjrt.jar |
| -argfile |
| C:\workspaces\org.aspectj\taskdefs\testdata\default.lst |
| -messageHolder |
| org.aspectj.bridge.MessageHandler |
| ---- Full Classpath --- |
| Empty |
| ---- Compiler Messages --- |
| abort ABORT -- (NoClassDefFoundError) org/apache/commons/logging/LogFactory |
| org/apache/commons/logging/LogFactory |
| java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory |
| at org.aspectj.weaver.tools.CommonsTraceFactory.<init>(CommonsTraceFactory.java:17) |
| at java.lang.Class.newInstance0(Native Method) |
| at java.lang.Class.newInstance(Class.java:232) |
| at org.aspectj.weaver.tools.TraceFactory.<clinit>(TraceFactory.java:35) |
| at org.aspectj.weaver.World.<clinit>(World.java:114) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.initBcelWorld(AjBuildManager.java:679) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.doBuild(AjBuildManager.java:224) |
| at org.aspectj.ajdt.internal.core.builder.AjBuildManager.batchBuild(AjBuildManager.java:164) |
| at org.aspectj.ajdt.ajc.AjdtCommand.doCommand(AjdtCommand.java:112) |
| at org.aspectj.ajdt.ajc.AjdtCommand.runCommand(AjdtCommand.java:60) |
| at org.aspectj.tools.ajc.Main.run(Main.java:367) |
| at org.aspectj.tools.ajc.Main.runMain(Main.java:246) |
| at org.aspectj.tools.ajc.Main.main(Main.java:86) |
| </pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pointcuts-debugging.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="trace.html">Next</a></td></tr><tr><td width="40%" align="left">Debugging pointcuts </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> Chapter 4. Tracing</td></tr></table></div></body></html> |
