comparison graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Instrument.java @ 20888:e7ece52e1ff3

Truffle/Instrumentation: remove two helper classes not adding enough value.
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Fri, 10 Apr 2015 16:55:38 -0700
parents 2e3cc2a27711
children 73b1844b5b14
comparison
equal deleted inserted replaced
20173:c6ba61a3d05a 20888:e7ece52e1ff3
72 * {@link ASTInstrumentListener} . Their event handling methods account for both the entry into an 72 * {@link ASTInstrumentListener} . Their event handling methods account for both the entry into an
73 * AST node (about to call) and three possible kinds of <em>execution return</em> from an AST node.</li> 73 * AST node (about to call) and three possible kinds of <em>execution return</em> from an AST node.</li>
74 * <li>Extend one of the <em>helper implementations</em>: {@link DefaultInstrumentListener} or 74 * <li>Extend one of the <em>helper implementations</em>: {@link DefaultInstrumentListener} or
75 * {@link DefaultASTInstrumentListener}. These provide no-op implementation of every listener 75 * {@link DefaultASTInstrumentListener}. These provide no-op implementation of every listener
76 * method, so only the methods of interest need to be overridden.</li> 76 * method, so only the methods of interest need to be overridden.</li>
77 * <li>Extend one of the <em>helper implementations</em>: {@link SimpleInstrumentListener} or
78 * {@link SimpleASTInstrumentListener}. These re-route all <em>execution returns</em> to a single
79 * method, ignoring return values, so only two methods (for "enter" and "return") will notify all
80 * events.</li>
81 * </ol> 77 * </ol>
82 * <p> 78 * <p>
83 * <h4>General guidelines for {@link ASTInstrumentListener} implementation:</h4> 79 * <h4>General guidelines for {@link ASTInstrumentListener} implementation:</h4>
84 * <p> 80 * <p>
85 * Unlike the listener interface {@link InstrumentListener}, which isolates implementations 81 * Unlike the listener interface {@link InstrumentListener}, which isolates implementations