ibis.gmi
Class CombinedInvocation

java.lang.Object
  extended by ibis.gmi.InvocationScheme
      extended by ibis.gmi.CombinedInvocation

public class CombinedInvocation
extends InvocationScheme

The CombinedInvocation class must be used whenever a group method must be configured using a combined invocation scheme. Currently, there are two such schemes: a "flat" invocation scheme, which uses a FlatInvocationCombiner to combine the parameters, and a "binomial" invocation scheme, which uses a BinomialInvocationCombiner to combine the parameters. In the flat invocation scheme, all invocations are sent to a single node, which combines the parameters and then invokes the method using the underlying invocation scheme (which could be single, group, or personalized). In the binomial invocation scheme, the parameters are combined using a binomial tree.


Field Summary
 
Fields inherited from class ibis.gmi.InvocationScheme
I_COMBINED, I_COMBINED_BINOMIAL, I_COMBINED_BINOMIAL_GROUP, I_COMBINED_BINOMIAL_PERSONAL, I_COMBINED_BINOMIAL_SINGLE, I_COMBINED_FLAT, I_COMBINED_FLAT_GROUP, I_COMBINED_FLAT_PERSONAL, I_COMBINED_FLAT_SINGLE, I_GROUP, I_PERSONAL, I_SINGLE
 
Constructor Summary
CombinedInvocation(String identifier, int rank, int size, BinomialInvocationCombiner combiner, InvocationScheme inv)
          Constructor.
CombinedInvocation(String identifier, int rank, int size, FlatInvocationCombiner combiner, InvocationScheme inv)
          Constructor.
 
Method Summary
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CombinedInvocation

public CombinedInvocation(String identifier,
                          int rank,
                          int size,
                          FlatInvocationCombiner combiner,
                          InvocationScheme inv)
                   throws ConfigurationException
Constructor. This one is for a flat invocation combining scheme.

Parameters:
identifier - identifies this combined invocation object
rank - indicates the rank of the creator of this CombinedInvocation object
size - indicates the total number of invokers
combiner - indicates the parameter combiner itself
inv - indicates the underlying invocation scheme
Throws:
ConfigurationException - is thrown on an illegal combination of arguments.

CombinedInvocation

public CombinedInvocation(String identifier,
                          int rank,
                          int size,
                          BinomialInvocationCombiner combiner,
                          InvocationScheme inv)
                   throws ConfigurationException
Constructor. This one is for a binomial invocation combining scheme.

Parameters:
identifier - identifies this combined invocation object
rank - indicates the rank of the creator of this CombinedInvocation object
size - indicates the total number of invokers
combiner - indicates the parameter combiner itself
inv - indicates the underlying invocation scheme
Throws:
ConfigurationException - is thrown on an illegal combination of arguments.


The Ibis project