comparison truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/AdvancedInstrumentResultListener.java @ 22228:c9681cd54d90

Truffle/Instrumentation: remove @Deprecated Instrument factory methods, Javadoc cleanup
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Sun, 20 Sep 2015 16:11:02 -0700
parents dc83cc1f94f2
children 3f2052afcb6d
comparison
equal deleted inserted replaced
22227:68a0c3dcea10 22228:c9681cd54d90
29 import com.oracle.truffle.api.nodes.Node; 29 import com.oracle.truffle.api.nodes.Node;
30 30
31 /** 31 /**
32 * Listener for receiving the result a client-provided {@linkplain AdvancedInstrumentRoot AST 32 * Listener for receiving the result a client-provided {@linkplain AdvancedInstrumentRoot AST
33 * fragment}, when executed by a 33 * fragment}, when executed by a
34 * {@linkplain Instrument#create(AdvancedInstrumentResultListener, AdvancedInstrumentRootFactory, Class, String) 34 * {@linkplain Instrumenter#attach(Probe, AdvancedInstrumentResultListener, AdvancedInstrumentRootFactory, Class, String)
35 * Advanced Instrument}. 35 * Advanced Instrument}.
36 * 36 *
37 * @see Instrument 37 * @see Instrument
38 * @see AdvancedInstrumentRoot 38 * @see AdvancedInstrumentRoot
39 * @see AdvancedInstrumentRootFactory 39 * @see AdvancedInstrumentRootFactory
41 public interface AdvancedInstrumentResultListener { 41 public interface AdvancedInstrumentResultListener {
42 42
43 /** 43 /**
44 * Notifies listener that a client-provided {@linkplain AdvancedInstrumentRoot AST fragment} has 44 * Notifies listener that a client-provided {@linkplain AdvancedInstrumentRoot AST fragment} has
45 * been executed by an 45 * been executed by an
46 * {@linkplain Instrument#create(AdvancedInstrumentResultListener, AdvancedInstrumentRootFactory, Class, String) 46 * {@linkplain Instrumenter#attach(Probe, AdvancedInstrumentResultListener, AdvancedInstrumentRootFactory, Class, String)
47 * Advanced Instrument} with the specified result, possibly {@code null}. 47 * Advanced Instrument} with the specified result, possibly {@code null}.
48 * <p> 48 * <p>
49 * <strong>Note: </strong> Truffle will attempt to optimize implementations through partial 49 * <strong>Note: </strong> Truffle will attempt to optimize implementations through partial
50 * evaluation; annotate with {@link TruffleBoundary} if this should not be permitted. 50 * evaluation; annotate with {@link TruffleBoundary} if this should not be permitted.
51 * 51 *