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}