Mercurial > hg > graal-jvmci-8

comparison graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Instrument.java @ 21407:36285949c1d5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Truffle/Instrumentation: some commentary and a new AST printing method needed for tools.
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Sun, 17 May 2015 20:35:31 -0700
parents b4aca5ec3f10
children
comparison
equal deleted inserted replaced
21406:b4aca5ec3f10 21407:36285949c1d5
128 128
129 /** 129 /**
130 * Creates an <em>Advanced Instrument</em>: this Instrument executes efficiently, subject to 130 * Creates an <em>Advanced Instrument</em>: this Instrument executes efficiently, subject to
131 * full Truffle optimization, a client-provided AST fragment every time the Probed node is 131 * full Truffle optimization, a client-provided AST fragment every time the Probed node is
132 * entered. 132 * entered.
133 * <p>
134 * Any {@link RuntimeException} thrown by execution of the fragment is caught by the framework
135 * and reported to the listener; there is no other notification.
133 * 136 *
134 * @param resultListener optional client callback for results/failure notification 137 * @param resultListener optional client callback for results/failure notification
135 * @param rootFactory provider of AST fragments on behalf of the client 138 * @param rootFactory provider of AST fragments on behalf of the client
136 * @param requiredResultType optional requirement, any non-assignable result is reported to the 139 * @param requiredResultType optional requirement, any non-assignable result is reported to the
137 * the listener, if any, as a failure 140 * the listener, if any, as a failure