1.1.1

Chapter 55
SQLFire API
Here are brief descriptions of SQLFire classes and interfaces, with links to the JavaDoc and pertinent user guide
sections.
DescriptionSQLFire Class or Interface
Provides a mechansim to receive callbacks on execution of DML
(Create,Update,Delete) statements in SQLFire. Use an
AsyncEventListener
AsyncEventListener to analyze data and take desired actions such as
persisting data in a specific format.
To do this, you create a class implementing the AsyncEventListener
interface. The callback method processEvents(List<Event> events)
processes information related to manipulated rows, such as new values.
An AsyncEventListener instance is serviced by its own dedicated thread
in which a callback method is invoked. Events corresponding to DML
are placed in an internal queue and the dedicated thread dispatches a
batch of events at a time to the user-implemented callback class, the
frequency of which is governed by the configuration of the
AsyncEventListener.
Built-in AsyncEventListener used to asynchronously persist data to a
third- party JDBC 4.0-compliant RDBMS. The steps for configuring
DBSynchronizer
DBSynchronizer are the same as those for configuring
AsyncEventListener. Using DBSynchronizer to Apply DML to an
RDBMS on page 203 describes the process.
Provides information about the row inserted, updated, or deleted using
the callback mechanism. The callback itself can be registered either
Event
through CacheListener or AsyncEventListener. How the
AsyncEventListener Works on page 197 provides more information.
Interface to be implemented by synchronous cache plug-ins (writers and
listeners). Handling DML Events Synchronously on page 195 and the
JavaDoc provide more information about implementing this interface.
SYS.ADD_LISTENER on page 612 shows a sample implementation.
EventCallback
Singleton that provides locator services in the distributed system that
allow peers to discover one another.
FabricLocator
Enables an application process to join the SQLFire cluster either as a
data store by hosting data or as an accessor (peer client) to the real data.
FabricServer
Facilitates acquiring a FabricServer or FabricLocator instance. A virtual
machine can be booted as either a FabricServer or a FabricLocator but
not both.
FabricServiceManager
Clients can connect to a NetworkInterface using the SQLFire JDBC
client driver (URL of the form 'jdbc:sqlfire://<host>:<port>'). Network
NetworkInterface
listener instance can be acquired by invoking FabricServer
startNetworkServer method. SQLFire uses DRDA protocol for
463