org.ektorp.changes
Interface ChangesFeed

All Known Implementing Classes:

ContinuousChangesFeed

public interface ChangesFeed

ChangesFeed listens to the _changes feed in a CouchDB database. Feeds are created by calling the method changesFeed(ChangesCommand cmd) in CouchDbConnector. An active feed buffers incoming changes in a unbounded queue that will grow until OutOfMemoryException if not polled.

Author:

henrik lundgren

Method Summary

void	cancel() Will close this feed and interrupt any threads waiting on next()
boolean	isAlive()
DocumentChange	next() Retrieves and removes the head of this changes feed, waiting if necessary until an element becomes available.
DocumentChange	next(long timeout, java.util.concurrent.TimeUnit unit) Retrieves and removes the head of this changes feed, waiting up to the specified wait time if necessary for an element to become available.
int	queueSize()

Method Detail

next

DocumentChange next()
                    throws java.lang.InterruptedException

Retrieves and removes the head of this changes feed, waiting if necessary until an element becomes available.

Returns:

Throws:

java.lang.InterruptedException - when this changes feed is closed or otherwise is interrupted

next

DocumentChange next(long timeout,
                    java.util.concurrent.TimeUnit unit)
                    throws java.lang.InterruptedException

Retrieves and removes the head of this changes feed, waiting up to the specified wait time if necessary for an element to become available.

Parameters:

timeout -

unit -

Returns:

Throws:

java.lang.InterruptedException - when this changes feed is closed or otherwise is interrupted

cancel

void cancel()

Will close this feed and interrupt any threads waiting on next()

isAlive

boolean isAlive()

Returns:

true if this feed is active.

queueSize

int queueSize()

Returns:

the size of this feed's unhandled internal queue.