ibis.gmi
Class CombinedInvocation

java.lang.Object
  ibis.gmi.InvocationScheme
      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(java.lang.String identifier, int rank, int size, BinomialInvocationCombiner combiner, InvocationScheme inv)
Constructor.

CombinedInvocation(java.lang.String identifier, int rank, int size, FlatInvocationCombiner combiner, InvocationScheme inv)
Constructor.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CombinedInvocation

public CombinedInvocation(java.lang.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(java.lang.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.