edu.utah.janosvm.kit.comm.commspace
Class CommHashtableHandle

java.lang.Object
  |
  +--edu.utah.janosvm.sys.ListNode
        |
        +--edu.utah.janosvm.sys.Importable
              |
              +--edu.utah.janosvm.kit.comm.commspace.CommHashtableHandle

public final class CommHashtableHandle

extends Importable

A handle for a CommHashtable that may be in another Flow.

Field Summary

private CommHashtable

ch

Fields inherited from class edu.utah.janosvm.sys.Importable

em

Fields inherited from class edu.utah.janosvm.sys.ListNode

pred, succ

Constructor Summary

CommHashtableHandle()
Construct a new CommHashtable and attach this handle to it.

CommHashtableHandle(CommHashtableHandle chh)
Copy constructor.

Method Summary

protected void	bindTo(Exportable ex) Bind this Importable to the given Exportable.
boolean	containsKey(CommSpaceElement id)
CommSpaceElement	lookup(CommSpaceElement id)
CommSpaceElement	put(CommSpaceElement id, CommSpaceElement val)
void	remove(CommSpaceElement id)
java.lang.String	toString()
protected void	unbindFrom() Unbind this Importable from any objects it is referencing.

Methods inherited from class edu.utah.janosvm.sys.Importable

copy, finalize, getExportManager, revoke, setExportManager

Methods inherited from class edu.utah.janosvm.sys.ListNode

append, clone, inList, prepend, remove

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait, wait0

Field Detail

ch

private CommHashtable ch

Constructor Detail

CommHashtableHandle

public CommHashtableHandle()

Construct a new CommHashtable and attach this handle to it.

CommHashtableHandle

public CommHashtableHandle(CommHashtableHandle chh)

Copy constructor.

Parameters:

chh - The handle to copy.

Method Detail

bindTo

protected final void bindTo(Exportable ex)

Description copied from class: Importable

Bind this Importable to the given Exportable. The most common implementation of this method would be to cast the Exportable to the type that the Importable subclass handles and store it in the object as well as any other handy pointers/values.

This method will be invoked as a side-effect of binding this importable to an Exportable object via TeamHandle.importObject(edu.utah.janosvm.sys.Importable, java.lang.Object).

XXX Add note about synchronized.

Overrides:

bindTo in class Importable

Following copied from class: edu.utah.janosvm.sys.Importable

Parameters:

ex - The Exportable that is being imported.

unbindFrom

protected final void unbindFrom()

Description copied from class: Importable

Unbind this Importable from any objects it is referencing. The most common implementation of this method would be null out any object references in this object.

This method will be invoked as a side-effect of canceling this import, or when the Team owning the Exportable is terminated, or when the Exportable is revoked.

XXX rename to just 'unbind'.

Overrides:

unbindFrom in class Importable

Following copied from class: edu.utah.janosvm.sys.Importable

See Also:

TeamHandle.cancelImport(edu.utah.janosvm.sys.Importable), Team.revokeObject(java.lang.Object), TeamHandle.terminate()

put

public CommSpaceElement put(CommSpaceElement id,
                            CommSpaceElement val)

Parameters:

id - Identifier to be paired with a value

val - Value to pair with an identifier

Returns:

The element that was previously paired with the identifier.

lookup

public CommSpaceElement lookup(CommSpaceElement id)

Parameters:

id - The identifier to lookup in the hash table.

Returns:

Null or the element that is paired with the given identifier

remove

public void remove(CommSpaceElement id)

Parameters:

id - The identifier to remove from the hash table.

containsKey

public boolean containsKey(CommSpaceElement id)

Parameters:

id - The identifier to check for in the hash table.

Returns:

True if the identifier was found in the table, false otherwise.

toString

public java.lang.String toString()

Overrides:

toString in class Importable