001/*
002 * HA-JDBC: High-Availability JDBC
003 * Copyright (C) 2012  Paul Ferraro
004 *
005 * This program is free software: you can redistribute it and/or modify
006 * it under the terms of the GNU Lesser General Public License as published by
007 * the Free Software Foundation, either version 3 of the License, or
008 * (at your option) any later version.
009 *
010 * This program is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
013 * GNU Lesser General Public License for more details.
014 *
015 * You should have received a copy of the GNU Lesser General Public License
016 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
017 */
018package net.sf.hajdbc.invocation;
019
020import net.sf.hajdbc.Database;
021
022/**
023 * Represents a method invocation on a SQL object against a database.
024 * @author Paul Ferraro
025 * @param <D> Type of the root object (e.g. driver, datasource)
026 * @param <T> Target object type of the invocation
027 * @param <R> Return type of this invocation
028 */
029public interface Invoker<Z, D extends Database<Z>, T, R, E extends Exception>
030{
031        /**
032         * Invokes an action against the specified database on the specified SQL object
033         * @param database a database
034         * @param object an SQL object
035         * @return the invocation result
036         * @throws Exception
037         */
038        R invoke(D database, T object) throws E;
039}