net.captp.jcomm
Class FarHandler

java.lang.Object
  |
  +--net.captp.jcomm.RemoteHandler
        |
        +--net.captp.jcomm.FarHandler

All Implemented Interfaces:

ProxyHandler

class FarHandler

extends RemoteHandler

A resolved reference that's still remote is necessarily a reference to a PassByProxy object.

Author:

Mark S. Miller

Field Summary

(package private) CapTPConnection	myConn Connection to the vat I point into
(package private) ProxyResolver	myResolver The Resolver of our Proxy, which also revives the Proxy on demand.
private BigInteger	mySwissHash

Constructor Summary

(package private)

FarHandler(CapTPConnection conn, int pos, BigInteger swissHash) Construct a new FarHandler.

Method Summary

(package private) void	countWireRef()
(package private) int	getPos()
SealedBox	handleOptSealedDispatch(Brand brand) How should my ref respond to an __optSealedDispatch request?
void	handleResolution(Object newTarget) Enabled: My Ref no longer needs me, as it's become equivalent to newTarget.
Ref	handleSendAll(String verb, Object[] args) Enabled: My Ref is asking me to deliver the message to the other side, and return a promise for the result.
void	handleSendAllOnly(String verb, Object[] args) Enabled: My Ref is asking me to deliver the message to the other side and ignore the result.
boolean	isFresh() Always resolved, so always fresh
void	reactToGC() Enabled: One of my Refs was GCed, and I have no current Ref.
boolean	sameConnection(Object other) Enabled: Are 'other' and the remote reference handled by 'this' part of the same comm system, and do they both connect to the same remote vat?

Methods inherited from class java.lang.Object

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

Field Detail

mySwissHash

private final BigInteger mySwissHash

myConn

final CapTPConnection myConn

Connection to the vat I point into

myResolver

final ProxyResolver myResolver

The Resolver of our Proxy, which also revives the Proxy on demand.

Constructor Detail

FarHandler

FarHandler(CapTPConnection conn,
           int pos,
           BigInteger swissHash)

Construct a new FarHandler.

Parameters:

conn - The CapTPConnection to communicate via

pos - The Imports or Questions map pos of the object

swissHash - The identity (within the connection's remote vat) of the object this FarRef designates.

Method Detail

isFresh

public boolean isFresh()

Always resolved, so always fresh

handleOptSealedDispatch

public SealedBox handleOptSealedDispatch(Brand brand)

How should my ref respond to an __optSealedDispatch request?

Specified by:

handleOptSealedDispatch in interface ProxyHandler

handleSendAllOnly

public void handleSendAllOnly(String verb,
                              Object[] args)

Description copied from interface: ProxyHandler

Enabled: My Ref is asking me to deliver the message to the other side and ignore the result.

If the underlying transport mechanism is shut down or otherwise not accepting messages, then it should throw a problem explaining why this message wasn't queued.

Specified by:

handleSendAllOnly in interface ProxyHandler

handleSendAll

public Ref handleSendAll(String verb,
                         Object[] args)

Description copied from interface: ProxyHandler

Enabled: My Ref is asking me to deliver the message to the other side, and return a promise for the result.

If the underlying transport mechanism is shut down or otherwise not accepting messages, then it should either throw a problem explaining why this message wasn't queued, or return a reference that's immediately broken by this problem.

Specified by:

handleSendAll in interface ProxyHandler

handleResolution

public void handleResolution(Object newTarget)

Description copied from interface: ProxyHandler

Enabled: My Ref no longer needs me, as it's become equivalent to newTarget.

Specified by:

handleResolution in interface ProxyHandler

reactToGC

public void reactToGC()

Description copied from interface: ProxyHandler

Enabled: One of my Refs was GCed, and I have no current Ref.

Specified by:

reactToGC in interface ProxyHandler

getPos

int getPos()

countWireRef

void countWireRef()

sameConnection

public boolean sameConnection(Object other)

Description copied from interface: ProxyHandler

Enabled: Are 'other' and the remote reference handled by 'this' part of the same comm system, and do they both connect to the same remote vat?

Specified by:

sameConnection in interface ProxyHandler