com.sun.tracing

Class ProviderFactory

java.lang.Object

com.sun.tracing.ProviderFactory

Direct Known Subclasses:

DTraceProviderFactory, MultiplexProviderFactory, NullProviderFactory, PrintStreamProviderFactory

public abstract class ProviderFactory
extends Object

ProviderFactory is a factory class used to create instances of providers. To enable tracing in an application, this class must be used to create instances of the provider interfaces defined by users. The system-defined factory is obtained by using the getDefaultFactory() static method. The resulting instance can be used to create any number of providers.

Since:

1.7

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ProviderFactory()

Method Summary

Methods

Modifier and Type	Method and Description
abstract <T extends Provider> T	createProvider(Class<T> cls) Creates an implementation of a Provider interface.
static ProviderFactory	getDefaultFactory() Returns an implementation of a ProviderFactory which creates instances of Providers.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ProviderFactory

protected ProviderFactory()

Method Detail

createProvider

public abstract <T extends Provider> T createProvider(Class<T> cls)

Creates an implementation of a Provider interface.

Parameters:

cls - the provider interface to be defined.

Returns:

an implementation of cls, whose methods, when called, will trigger tracepoints in the application.

Throws:

NullPointerException - if cls is null

IllegalArgumentException - if the class definition contains non-void methods

getDefaultFactory

public static ProviderFactory getDefaultFactory()

Returns an implementation of a ProviderFactory which creates instances of Providers. The created Provider instances will be linked to all appropriate and enabled system-defined tracing mechanisms in the JDK.

Returns:

a ProviderFactory that is used to create Providers.