net.sf.hajdbc.balancer

Interface Balancer<Z,D extends Database<Z>>

Type Parameters:

Z - the database connection source

D - the database descriptor

All Superinterfaces:

Collection<D>, Iterable<D>, Set<D>

All Known Implementing Classes:

AbstractBalancer, AbstractSetBalancer, LoadBalancer, RandomBalancer, RoundRobinBalancer, SimpleBalancer

public interface Balancer<Z,D extends Database<Z>>
extends Set<D>

The set of active databases and a strategy for determining the next balancing target.

Author:

Paul Ferraro

Method Summary

Methods

Modifier and Type	Method and Description
Iterable<D>	backups() The non-primary databases.
<T,R,E extends Exception> R	invoke(Invoker<Z,D,T,R,E> invoker, D database, T object) Invoke the specified invoker on the specified object against the specified database, potentially informing the balancer.
D	next() Returns the next database from this balancer
D	primary() Returns the primary database.

Methods inherited from interface java.util.Set

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Method Detail

primary

D primary()

Returns the primary database. The database returned by this method should be consistent across nodes.

Returns:

the primary database

backups

Iterable<D> backups()

The non-primary databases.

Returns:

an iterable collection of databases.

next

D next()

Returns the next database from this balancer

Returns:

the next database from this balancer

invoke

<T,R,E extends Exception> R invoke(Invoker<Z,D,T,R,E> invoker,
                                 D database,
                                 T object)
         throws E extends Exception

Invoke the specified invoker on the specified object against the specified database, potentially informing the balancer.

Type Parameters:

T - invoker target object type

R - invoker return type

E - invoker exception type

Parameters:

invoker -

database -

object -

Returns:

the result of the invocation

Throws:

E

E extends Exception