Package oracle.simplefan.impl

Class FanManager

java.lang.Object

oracle.simplefan.FanManager

oracle.simplefan.impl.FanManager

public final class FanManager
extends FanManager

Since:

release specific (what release of product did this appear in)

Version:

$Header: dbjava/simplefan/src/java/oracle/simplefan/impl/FanManager.java /main/5 2015/09/09 23:06:27 vidnayak Exp $

Author:

dsurber

Constructor Summary

Constructors

Constructor	Description
FanManager()

Method Summary

Modifier and Type	Method	Description
void	configure(java.util.Properties props)	Configures the event daemon.
static FanManager	getInstanceInternal()	Get an instance of the concrete implementation class.
FanSubscription	subscribe(java.util.Properties props)	Creates a FanSubscription that retrieves FAN events using ONS.

Methods inherited from class oracle.simplefan.FanManager

getInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

FanManager

public FanManager()

Method Detail

getInstanceInternal

public static final FanManager getInstanceInternal()

Get an instance of the concrete implementation class.

Returns:

An instance of the concrete class.

configure

public final void configure(java.util.Properties props)

Configures the event daemon. Calling this method is optional. If called, it must be called only once and it must be called before any calls to subscribe. The argument is not captured. If not called, the event daemon must be configured using some other mechanism, specific to the daemon used. The only supported daemon is ONS in the initial release.

Specified by:

configure in class FanManager

Parameters:

props - Properties that configure the event daemon.

Throws:

java.lang.IllegalArgumentException - if the props are unrecognized.

java.lang.IllegalStateException - if it has been called previously or if subscribe has been called previously.

subscribe

public final FanSubscription subscribe(java.util.Properties props)

Creates a FanSubscription that retrieves FAN events using ONS. The argument is not captured. The return value is retained.

Specified by:

subscribe in class FanManager

Parameters:

props - Properties that define the events to retrieve.

Returns:

a FanSubscription for the specified events.

Throws:

java.lang.IllegalArgumentException - if the properties do not specify a valid subscription.

java.lang.IllegalStateException - if the daemon is not properly initialized.

java.security.AccessControlException - if the caller does not have oracle.ons.SubscribePermission.