source: protocol/src/main/java/geniusweb/protocol/partyconnection/ProtocolToPartyConnFactory.java@ 34

package geniusweb.protocol.partyconnection;

import java.io.IOException;
import java.util.List;

import geniusweb.actions.Action;
import geniusweb.connection.ConnectionFactory;
import geniusweb.inform.Inform;
import geniusweb.references.Reference;
import tudelft.utilities.repository.NoResourcesNowException;

/**
 * An extended {@link ConnectionFactory} that store PartyIDs with the
 * connections, making it possible to find back the appropriate connection given
 * a PartyID. Also, it allows the connection factory to actually assign the
 * PartyIDs.
 *
 */
public interface ProtocolToPartyConnFactory
                extends ConnectionFactory<Action, Inform> {
        @Override
        public ProtocolToPartyConn connect(Reference reference)
                        throws IOException, NoResourcesNowException;

        /**
         * Connects a set of References in one go, following a modified Banker's
         * algorthm.
         * 
         * @param references the list of references to connect with
         * @return a List of connections, one fore each Reference.
         * @throws IOException             if a connection is failing irrecoverably.
         * @throws NoResourcesNowException is there are insufficient resources now.
         *                                 This also includes a suggested moment to
         *                                 retry.
         */
        List<ProtocolToPartyConn> connect(List<Reference> references)
                        throws IOException, NoResourcesNowException;

}