001/*
002 * HA-JDBC: High-Availability JDBC
003 * Copyright (c) 2004-2007 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.util.Map;
024import java.util.Set;
025import java.util.SortedMap;
026
027import net.sf.hajdbc.Database;
028import net.sf.hajdbc.DatabaseCluster;
029
030/**
031 * @author Paul Ferraro
032 * @since 2.0
033 */
034public interface SQLProxy<D, T>
035{
036        public DatabaseCluster<D> getDatabaseCluster();
037        
038        public Map.Entry<Database<D>, T> entry();
039        
040        public Set<Map.Entry<Database<D>, T>> entries();
041        
042        public void addChild(SQLProxy<D, ?> child);
043
044        public void removeChild(SQLProxy<D, ?> child);
045        
046        public void removeChildren();
047
048        public SQLProxy<D, ?> getRoot();
049        
050        public T getObject(Database<D> database);
051        
052        public void retain(Set<Database<D>> databaseSet);
053        
054        public void handleFailure(Database<D> database, Exception cause) throws Exception;
055        
056        public void handleFailures(SortedMap<Database<D>, Exception> exceptionMap) throws Exception;
057        
058        public <R> SortedMap<Database<D>, R> handlePartialFailure(SortedMap<Database<D>, R> resultMap, SortedMap<Database<D>, Exception> exceptionMap) throws Exception;
059}