org.jumpi.impl.connector.mpi11
Class MpiDestination

java.lang.Object
  |
  +--org.jumpi.impl.AbstractDestination
        |
        +--org.jumpi.impl.connector.mpi11.MpiDestination

All Implemented Interfaces:

Destination, Destination

public class MpiDestination

extends AbstractDestination

A MpiDestination represents either.

• the MPI Connector implementation ( mpi:// ) - used to allow the client application to address the MPI implementation. See MpiConnector.getDestination(java.lang.String, java.util.Hashtable).
• a Group of MPI Processors ( mpi://GROUP-NAME ) - used to represent the Group as a whole.
• any MPI Processor within a Group ( mpi://GROUP-NAME:* ) - used for wildcard receives.
• most typically, a single Processor within a Group ( mpi://GROUP-NAME:ProcessorID ) - used to send and receive from individual Processors.

Field Summary

Fields inherited from class org.jumpi.impl.AbstractDestination

connector_, controller_, props_, url_, wildcard_

Fields inherited from interface org.jumpi.Destination

PROTOCOL_SEPARATOR, SEPARATOR

Constructor Summary

MpiDestination(java.lang.String url, Controller controller, Connector connector)
Creates a MpiDestination representing the MPI Connector.

MpiDestination(java.lang.String url, Controller controller, Connector connector, mpi.Intracomm comm)
Creates a MpiDestination representing a MPI Processor Group.

MpiDestination(java.lang.String url, Controller controller, Connector connector, mpi.Intracomm comm, int processorId)
Creates a MpiDestination representing a single Processor in a Group.

Method Summary

mpi.Intracomm	getComm() Return the MPI Intracomm bound to the Group.
int	getProcessorId() Return the Processor ID.
java.lang.String	getUrl() Return the Url representation of the Destination.
boolean	matches(Destination dest) Returns false always since no receive patching takes place in the MPI Connector, but rather this is done by the MPI implementation.

Methods inherited from class org.jumpi.impl.AbstractDestination

equals, getConnector, getController, getControllerName, getProperties, hashCode, isWildcard, setProperties

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MpiDestination

public MpiDestination(java.lang.String url,
                      Controller controller,
                      Connector connector)

Creates a MpiDestination representing the MPI Connector.

Parameters:

url - the Url representation of the MPI Connector.

controller - the Controller responsible for the MPI Connector.

connector - the MPI Connector itself.

MpiDestination

public MpiDestination(java.lang.String url,
                      Controller controller,
                      Connector connector,
                      mpi.Intracomm comm)

Creates a MpiDestination representing a MPI Processor Group.

Parameters:

url - the Url representation of the Group.

controller - the Controller responsible for the MPI Connector.

connector - the MPI Connector itself.

comm - the MPI Intracomm handle of the Group.

MpiDestination

public MpiDestination(java.lang.String url,
                      Controller controller,
                      Connector connector,
                      mpi.Intracomm comm,
                      int processorId)

Creates a MpiDestination representing a single Processor in a Group. If the Processor ID is a wildcard - MPI.ANY then this represents any Processor in the Group.

Parameters:

url - the Url representation of the Processor in the Group.

controller - the Controller responsible for the MPI Connector.

connector - the MPI Connector itself.

comm - the MPI Intracomm handle of the Group.

processorId - the Processor's ID.

Method Detail

getProcessorId

public int getProcessorId()

Return the Processor ID.

Returns:

the Processor ID.

getComm

public mpi.Intracomm getComm()

Return the MPI Intracomm bound to the Group.

Returns:

the MPI Intracomm bound to the Group.

getUrl

public java.lang.String getUrl()

Return the Url representation of the Destination.

Specified by:

getUrl in interface Destination

Specified by:

getUrl in class AbstractDestination

Returns:

the Url representation of the Destination.

matches

public boolean matches(Destination dest)

Returns false always since no receive patching takes place in the MPI Connector, but rather this is done by the MPI implementation.

Specified by:

matches in interface Destination

Overrides:

matches in class AbstractDestination

Parameters:

dest - the other Destination.

Returns:

false always.