001/*
002 * HA-JDBC: High-Availability JDBC
003 * Copyright (C) 2013  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.sql;
019
020import java.util.Map;
021import java.util.Set;
022
023import net.sf.hajdbc.Database;
024import net.sf.hajdbc.DatabaseCluster;
025import net.sf.hajdbc.ExceptionFactory;
026import net.sf.hajdbc.invocation.Invoker;
027
028/**
029 * A factory for creating proxies
030 * @author Paul Ferraro
031 */
032public interface ProxyFactory<Z, D extends Database<Z>, T, E extends Exception>
033{
034        T get(D database);
035        
036        Set<Map.Entry<D, T>> entries();
037
038        DatabaseCluster<Z, D> getDatabaseCluster();
039        
040        ExceptionFactory<E> getExceptionFactory();
041        
042        void record(Invoker<Z, D, T, ?, E> invoker);
043
044        void replay(D database, T object) throws E;
045
046        void addChild(ChildProxyFactory<Z, D, T, E, ?, ? extends Exception> child);
047
048        void removeChild(ChildProxyFactory<Z, D, T, E, ?, ? extends Exception> child);
049        
050        void removeChildren();
051        
052        T createProxy();
053}