To define tracepoints, users must extend this interface and then use a {@code ProviderFactory} to create an instance of thenewly-defined interface. Each method in the defined interface represents a tracepoint (or probe), which can be triggered by calling the associated method on the returned instance.
This interface also contains a {@code getProbe()} method, which can beused to get direct handles to the {@code Probe} objects themselves.{@code Probe} objects can be triggered manually, or they can be queried tocheck their state.
When an application has finished triggering probes, it should call {@code dispose()} to free up any system resources associated with theProvider.
All methods declared in a subclass of this interface should have a {@code void} return type. Methods can have parameters, and when called thevalues of the arguments will be passed to the tracing implementation. If any methods do not have a {@code void} return type, an{@code java.lang.IllegalArgumentException} will be thrown when theprovider is registered. @since 1.7
|
|
|
|