net.lightoze.jooq.postgresql.notify

Class NotificationListener

java.lang.Object

com.google.common.util.concurrent.AbstractExecutionThreadService

net.lightoze.jooq.postgresql.notify.NotificationListener

All Implemented Interfaces:

com.google.common.util.concurrent.Service

public abstract class NotificationListener
extends com.google.common.util.concurrent.AbstractExecutionThreadService

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.common.util.concurrent.Service

com.google.common.util.concurrent.Service.Listener, com.google.common.util.concurrent.Service.State

Constructor Summary

Constructors

Constructor and Description
NotificationListener()

Method Summary

Modifier and Type	Method and Description
protected abstract void	closeConnection(Connection connection) Close database connection and make sure it is not reused by anyone else (e.g.
String[]	getChannels()
protected abstract Connection	getConnection() Obtain a new database connection.
long	getFetchIntervalMillis()
long	getRetryDelayMillis()
protected abstract void	receiveNotification(org.postgresql.PGNotification notification) Process incoming notification.
protected void	run()
void	setChannels(String[] channels)
void	setFetchIntervalMillis(long fetchIntervalMillis)
void	setRetryDelayMillis(long retryDelayMillis)

Methods inherited from class com.google.common.util.concurrent.AbstractExecutionThreadService

addListener, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, executor, failureCause, isRunning, serviceName, shutDown, startAsync, startUp, state, stopAsync, toString, triggerShutdown

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NotificationListener

public NotificationListener()

Method Detail

getChannels

public String[] getChannels()

setChannels

public void setChannels(String[] channels)

getRetryDelayMillis

public long getRetryDelayMillis()

setRetryDelayMillis

public void setRetryDelayMillis(long retryDelayMillis)

getFetchIntervalMillis

public long getFetchIntervalMillis()

setFetchIntervalMillis

public void setFetchIntervalMillis(long fetchIntervalMillis)

getConnection

protected abstract Connection getConnection()
                                     throws SQLException

Obtain a new database connection. The connection should not have a timeout because it will be kept open as long as new notifications are listened for.

Returns:

database connection

Throws:

SQLException - when database connection failed

closeConnection

protected abstract void closeConnection(Connection connection)
                                 throws SQLException

Close database connection and make sure it is not reused by anyone else (e.g. by connection pool) to prevent leaking notification subscriptions.

Parameters:

connection - database connection

Throws:

SQLException - when error occurred

receiveNotification

protected abstract void receiveNotification(org.postgresql.PGNotification notification)

Process incoming notification.

Parameters:

notification - notification

run

protected void run()
            throws Exception

Specified by:

run in class com.google.common.util.concurrent.AbstractExecutionThreadService

Throws:

Exception