org.firebirdsql.event
Interface EventManager
- FBEventManager
public interface EventManager
An interface for registering EventListener
s to listen for
database events.
void | addEventListener(String eventName, EventListener listener) - Register an EventListener that will be called when an event occurs.
|
void | connect() - Make a connection with a database to listen for events.
|
void | disconnect() - Close the connection to the database.
|
String | getDatabase() - Returns the database path for the connection to the database.
|
String | getHost() - Returns the host for the connection to the database.
|
String | getPassword() - Returns the password for the connection to the database.
|
int | getPort() - Returns the port for the connection to the database.
|
String | getUser() - Returns the username for the connection to the databaes.
|
void | removeEventListener(String eventName, EventListener listener) - Remove an EventListener for a given event.
|
void | setDatabase(String database) - Sets the database path for the connection to the database.
|
void | setHost(String host) - Sets the host for the connection to the database.
|
void | setPassword(String password) - Sets the password for the connection to the database.
|
void | setPort(int port) - Sets the port for the connection to the database.
|
void | setUser(String user) - Sets the username for the connection to the database .
|
int | waitForEvent(String eventName) - Wait for the one-time occurence of an event.
|
int | waitForEvent(String eventName, int timeout) - Wait for the one-time occurence of an event.
|
addEventListener
public void addEventListener(String eventName,
EventListener listener)
throws SQLException
Register an EventListener that will be called when an event occurs.
eventName
- The name of the event for which the listener will
be notifiedlistener
- The EventListener that will be called when the given
event occurs
connect
public void connect()
throws SQLException
Make a connection with a database to listen for events.
disconnect
public void disconnect()
throws SQLException
Close the connection to the database.
getDatabase
public String getDatabase()
Returns the database path for the connection to the database.
- the database path for the connection to the database.
getHost
public String getHost()
Returns the host for the connection to the database.
- the host for the connection to the database.
getPassword
public String getPassword()
Returns the password for the connection to the database.
- the password for the connection to the database.
getPort
public int getPort()
Returns the port for the connection to the database.
- the port for the connection to the database.
getUser
public String getUser()
Returns the username for the connection to the databaes.
- the username for the connection to the database.
removeEventListener
public void removeEventListener(String eventName,
EventListener listener)
throws SQLException
Remove an EventListener for a given event.
eventName
- The name of the event for which the listener
will be unregistered.listener
- The EventListener that is to be unregistered
setDatabase
public void setDatabase(String database)
Sets the database path for the connection to the database.
database
- path for the connection to the database.
setHost
public void setHost(String host)
Sets the host for the connection to the database.
host
- for the connection to the database.
setPassword
public void setPassword(String password)
Sets the password for the connection to the database.
password
- for the connection to the database.
setPort
public void setPort(int port)
Sets the port for the connection to the database.
port
- for the connection to the database.
setUser
public void setUser(String user)
Sets the username for the connection to the database .
waitForEvent
public int waitForEvent(String eventName)
throws InterruptedException,
SQLException
Wait for the one-time occurence of an event.
This method blocks indefinitely until the event identified by the
value of eventName
occurs. The return value is the
number of occurrences of the requested event.
eventName
- The name of the event to wait for
- The number of occurences of the requested event
waitForEvent
public int waitForEvent(String eventName,
int timeout)
throws InterruptedException,
SQLException
Wait for the one-time occurence of an event.
This method blocks for a maximum of timeout
milliseconds,
waiting for the event identified by eventName
to occur.
A timeout value of 0
means wait indefinitely.
The return value is the number of occurences of the event in question,
or -1
if the call timed out.
timeout
- The maximum number of milliseconds to wait
- The number of occurrences of the requested event, or
-1
if the call timed out
Copyright B) 2001 David Jencks and other authors. All rights reserved.