|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Probe
The Probe
interface represents a tracepoint. A Probe
instance
is obtained by calling the Provider.getProbe()
method of a provider
instance created by ProviderFactory.createProvider()
. Probe
can be used to trigger a probe manually (provided the correct arguments are
passed to it), or to check a probe to see if anything is currently tracing
it.
A tracing check can be used to avoid lengthy work that might be needed to set up the probe's arguments. However, checking whether the probe is enabled generally takes the same amount of time as actually triggering the probe. So, you should only check a probe's status without triggering it if setting up the arguments is very expensive.
Users do not need to implement this interface: instances are
created automatically by the system when a Provider)
is created.
Method Summary | |
---|---|
boolean |
isEnabled()
Checks whether there is an active trace of this probe. |
void |
trigger(java.lang.Object... args)
Determines whether a tracepoint is enabled. |
Method Detail |
---|
boolean isEnabled()
void trigger(java.lang.Object... args)
args
- the parameters to pass to the method.
java.lang.IllegalArgumentException
- if the provided parameters do not
match the method declaration for this probe.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |