001/*
002 * HA-JDBC: High-Availability JDBC
003 * Copyright (C) 2012  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.distributed;
019
020import java.io.Serializable;
021
022import net.sf.hajdbc.Identifiable;
023
024
025/**
026 * Factory for creating instances of {@link CommandDispatcher}.
027 * 
028 * @author Paul Ferraro
029 */
030public interface CommandDispatcherFactory extends Identifiable, Serializable
031{
032        /**
033         * Create a new dispatcher for remote command execution.
034         * @param <C> execution context type
035         * @param id unique identifier of this dispatcher
036         * @param context command execution context
037         * @param stateful handler for state transfers
038         * @param membershipListener handler for group membership changes
039         * @return a new command dispatcher
040         * @throws Exception if an error occurred creating the dispatcher
041         */
042        <C> CommandDispatcher<C> createCommandDispatcher(String id, C context, Stateful stateful, MembershipListener membershipListener) throws Exception;
043}