net.sf.hajdbc.balancer.Balancer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ha-jdbc2 Show documentation

High-Availability JDBC

There is a newer version: 3.6.61

/*
 * HA-JDBC: High-Availability JDBC
 * Copyright (C) 2012  Paul Ferraro
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see .
 */
package net.sf.hajdbc.balancer;

import java.util.Set;

import net.sf.hajdbc.Database;
import net.sf.hajdbc.invocation.Invoker;

/**
 * The set of active databases and a strategy for determining the next balancing target.
 * 
 * @author Paul Ferraro
 *
 * @param  the database connection source
 * @param  the database descriptor
 */
public interface Balancer> extends Set
{
	/**
	 * Returns the primary database.
	 * The database returned by this method should be consistent across nodes.
	 * @return the primary database
	 */
	D primary();

	D local();
	
	/**
	 * The non-primary databases.
	 * @return an iterable collection of databases.
	 */
	Iterable backups();
	
	/**
	 * Returns the next database from this balancer
	 * @return the next database from this balancer
	 */
	D next();

	/**
	 * Invoke the specified invoker on the specified object against the specified database, potentially informing the balancer.
	 * @param  invoker target object type
	 * @param  invoker return type
	 * @param  invoker exception type
	 * @param invoker
	 * @param database
	 * @param object
	 * @return the result of the invocation
	 * @throws E
	 */
	 R invoke(Invoker invoker, D database, T object) throws E;

	Set getDatabases();
}