Skip navigation links

Oracle® Database JDBC Java API Reference
11g Release 2

E13995-02


oracle.jdbc.dcn
Interface DatabaseChangeRegistration

All Superinterfaces:
NotificationRegistration

public interface DatabaseChangeRegistration
extends NotificationRegistration
Since:
11.1
See Also:
oracle.jdbc.OracleStatement.setDatabaseChangeRegistration(oracle.jdbc.dcn.DatabaseChangeRegistration)

Nested Class Summary

 

Nested classes/interfaces inherited from interface oracle.jdbc.NotificationRegistration
NotificationRegistration.RegistrationState

 

Method Summary
 void addListener(DatabaseChangeListener listener)
          Register a listener with this registration.
 void addListener(DatabaseChangeListener listener, java.util.concurrent.Executor e)
          Register a listener with this registration.
 long getRegId()
          Returns the registration id provided by the database.
 int getRegistrationId()
          Deprecated. This method is deprecated in 11.2. Use getRegId() instead.
 java.lang.String[] getTables()
          Returns the name of the tables associated with this registration.
 void removeListener(DatabaseChangeListener listener)
          Remove a listener from the list of registered listeners.

 

Methods inherited from interface oracle.jdbc.NotificationRegistration
getDatabaseName, getRegistrationOptions, getState, getUserName

 

Method Detail

getRegistrationId

int getRegistrationId()
Deprecated. This method is deprecated in 11.2. Use getRegId() instead.
Returns the registration id provided by the database. this is the value as the value contained in column 'regid' in table 'USER_CHANGE_NOTIFICATION_REGS'.

getRegId

long getRegId()
Returns the registration id provided by the database. this is the value as the value contained in column 'regid' in table 'USER_CHANGE_NOTIFICATION_REGS'.

getTables

java.lang.String[] getTables()
Returns the name of the tables associated with this registration.

addListener

void addListener(DatabaseChangeListener listener)
                 throws java.sql.SQLException
Register a listener with this registration. The listener will be notified when an even occurs. You can register multiple listeners with this registration. The order in which they will be registered isn't guaranteed and may vary.

Note that the listener's code will be executed in the thread owned by the driver.

Throws:
java.sql.SQLException

addListener

void addListener(DatabaseChangeListener listener,
                 java.util.concurrent.Executor e)
                 throws java.sql.SQLException
Register a listener with this registration. The listener will be notified when an even occurs. You can register multiple listeners with this registration. The order in which they will be registered isn't guaranteed and may vary.

This method lets you control which thread will execute the listener's code when an event occurs by specifying an executor. You can provide your own executor which can for example use a pool of threads.

Throws:
java.sql.SQLException

removeListener

void removeListener(DatabaseChangeListener listener)
                    throws java.sql.SQLException
Remove a listener from the list of registered listeners.
Throws:
java.sql.SQLException

Skip navigation links

Oracle® Database JDBC Java API Reference
11g Release 2

E13995-02


Copyright © 2009, Oracle and/or its affiliates. All rights reserved.