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}