public abstract class FanManager
extends java.lang.Object
The current implementation of this package depends on the Oracle ONS message transport mechanism. You must configure your system, servers, and clients to use ONS before you can use this package. Future versions may use other transport mechanisms and so require different configuration values.
An instance of this class can optionally be configured once. If it is configured, it must be configured before any subscriptions are created. If it is not configured, then ONS must be configured using the $ORACLE_HOME/conf/opmn/ons.config file. Instructions for configuring ONS can be found in the Oracle JDBC Developer's Guide chapter on Fast Connection Failover.
Modifier and Type | Method and Description |
---|---|
abstract void |
configure(java.util.Properties props)
Configures the event daemon.
|
static FanManager |
getInstance()
Gets an instance of the concrete implementation class.
|
abstract FanSubscription |
subscribe(java.util.Properties props)
Creates a FanSubscription that retrieves FAN events using ONS.
|
public static final FanManager getInstance()
public abstract void configure(java.util.Properties props)
props
- Properties that configure the event daemon.java.lang.IllegalArgumentException
- if the props are unrecognized.java.lang.IllegalStateException
- if it has been called previously or if subscribe has been called previously.java.security.AccessControlException
- if the caller does not have oracle.ons.CreatePermission.public abstract FanSubscription subscribe(java.util.Properties props)
props
- Properties that define the events to retrieve.java.lang.IllegalArgumentException
- if the properties do not specify a valid subscription.java.lang.IllegalStateException
- if the daemon has not been properly initialized.java.security.AccessControlException
- if the caller does not have oracle.ons.SubscribePermission.