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}