001/* 002 * HA-JDBC: High-Availability JDBC 003 * Copyright (c) 2004-2008 Paul Ferraro 004 * 005 * This library is free software; you can redistribute it and/or modify it 006 * under the terms of the GNU Lesser General Public License as published by the 007 * Free Software Foundation; either version 2.1 of the License, or (at your 008 * option) any later version. 009 * 010 * This library is distributed in the hope that it will be useful, but WITHOUT 011 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 012 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License 013 * for more details. 014 * 015 * You should have received a copy of the GNU Lesser General Public License 016 * along with this library; if not, write to the Free Software Foundation, 017 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 018 * 019 * Contact: ferraro@users.sourceforge.net 020 */ 021package net.sf.hajdbc.sql; 022 023import java.sql.Connection; 024import java.sql.SQLException; 025 026/** 027 * Decorates and invocation strategy with transaction boundary logic. 028 * @author Paul Ferraro 029 * @param <D> DataSource or Driver 030 */ 031public interface TransactionContext<D> 032{ 033 /** 034 * Decorates the specified invocation strategy with start transaction logic. 035 * @param <T> Target object type of the invocation 036 * @param <R> Return type of this invocation 037 * @param strategy 038 * @param connection 039 * @return the decorated invocation strategy 040 * @throws SQLException 041 */ 042 public <T, R> InvocationStrategy<D, T, R> start(InvocationStrategy<D, T, R> strategy, Connection connection) throws SQLException; 043 044 /** 045 * Decorates the specified invocation strategy with end transaction logic. 046 * @param <T> Target object type of the invocation 047 * @param <R> Return type of this invocation 048 * @param strategy 049 * @return the decorated invocation strategy 050 * @throws SQLException 051 */ 052 public <T, R> InvocationStrategy<D, T, R> end(InvocationStrategy<D, T, R> strategy) throws SQLException; 053 054 /** 055 * Closes this transaction context. 056 */ 057 public void close(); 058}