All Packages  This Package  Class Hierarchy  Class Search  Index

java.lang.Object
   |
   +----edu.utah.janos.nodeos.CommSpaceHandle

Summary

public final class  CommSpaceHandle
     extends java.lang.Object
{
          // Fields 1
     private CommSpace commSpace;

          // Constructors 3
     public CommSpaceHandle();
     CommSpaceHandle(CommSpace);
     CommSpaceHandle(CommSpaceHandle);

          // Methods 12
     private static CommSpaceElement copy(CommSpaceElement);
     public static CommSpaceHandle newCommSpace(CommSpaceHandle, int);
     public static CommSpaceHandle newCommSpace(int);

     boolean empty();
     void handleFor(CommSpace);
     public CommSpaceElement read(int) throws ArrayIndexOutOfBoundsException;
     public int resize(int);
     public int size();
     public CommSpaceElement swap(int, CommSpaceElement) throws ArrayIndexOutOfBoundsException;
     public CommSpaceElement take(int) throws ArrayIndexOutOfBoundsException;
     public CommSpaceElement waitToTake(int) throws ArrayIndexOutOfBoundsException, InterruptedException;
     public void write(int, CommSpaceElement) throws ArrayIndexOutOfBoundsException;
}

Each flow has exactly one CommSpaceHandle. The CommSpaceHandle points to exactly one CommSpace.

XXX Semantics during a failed take() are probably wrong.

Author:

Janos Ministry of Development

Cross Reference

Returned By:

PrimordialNode.fillNeighborSpace(), PrimordialNode.fireUpNewFlow(), UnknownMidPackets.spaceForMID(), CommSpaceElement.getCommSpaceHandle(), CommSpaceHandle.newCommSpace(), CommSpaceHandle.newCommSpace()

   private CommSpace commSpace

Constructors

· CommSpaceHandle

Summary  |  Top

   public CommSpaceHandle() 

   CommSpaceHandle(CommSpaceHandle other) 

Copy constructor. Only used when passing a csh to a child flow.

   CommSpaceHandle(CommSpace commSpace) 

   public static CommSpaceHandle newCommSpace(int size) 

   public static CommSpaceHandle newCommSpace(CommSpaceHandle csh, 
                                              int size) 

   boolean empty() 

XXX Without this being public there is no way to tell if this thing actually points to a commSpace.

   void handleFor(CommSpace commSpace) 

   public int size() 

   public int resize(int newsize) 

   public void write(int index, 
                     CommSpaceElement elem)  throws ArrayIndexOutOfBoundsException

Write a CommSpaceElement into the CommSpace. Overwrites any pre-existing element at that index.

   private static CommSpaceElement copy(CommSpaceElement e) 

XXX is it necessary to copy the CommSpaceElement out of the CommSpace??

   public CommSpaceElement take(int index)  throws ArrayIndexOutOfBoundsException

   public CommSpaceElement waitToTake(int index)  throws ArrayIndexOutOfBoundsException, InterruptedException

   public CommSpaceElement read(int index)  throws ArrayIndexOutOfBoundsException

   public CommSpaceElement swap(int index, 
                                CommSpaceElement elem)  throws ArrayIndexOutOfBoundsException

All Packages  This Package  Class Hierarchy  Class Search  Index