com.ibm.aglets
Class RemoteAgletRef

java.lang.Object
  |
  +--com.ibm.awb.weakref.WeakRef
        |
        +--com.ibm.aglets.RemoteAgletRef
All Implemented Interfaces:
AgletRef, Ref

public final class RemoteAgletRef
extends WeakRef
implements AgletRef

Version:
1.00 $Date: 2001/07/28 06:32:11 $
Author:
Mitsuru Oshima, ONO Kouichi

Fields inherited from class com.ibm.awb.weakref.WeakRef
_table
 
Constructor Summary
RemoteAgletRef()
           
 
Method Summary
 void activate()
          Activate the aglet
 void checkValidation()
           
 void delegateMessage(Message msg)
          Delegates a message
protected  Ref findRef()
           
protected  Ref findRef(java.io.ObjectInputStream s)
           
 java.lang.String getAddress()
          Gets the address of the target aglet
 Aglet getAglet()
          Gets the aglet.
 AgletInfo getAgletInfo()
          Gets the information of the aglet
static RemoteAgletRef getAgletRef(Ticket ticket, Name n)
           
 java.lang.String getRefClassName()
           
protected  java.lang.Object getRefID()
           
 boolean isActive()
          Checks if it's active.
 boolean isRemote()
          Checks if it's valid.
 boolean isState(int s)
          Check the state
 boolean isValid()
          Checks if it's valid.
 void resume()
          Resume the aglet
 FutureReply sendFutureMessage(Message msg)
          Sends a message in asynchronous way.
 java.lang.Object sendMessage(Message msg)
          Sends a message in synchronous way.
 void sendOnewayMessage(Message msg)
          Sends a oneway message
static void showRefTable(java.io.PrintStream out)
           
 java.lang.String toString()
           
 void writeInfo(java.io.ObjectOutputStream s)
           
 
Methods inherited from class com.ibm.awb.weakref.WeakRef
getRef, referenced, setRef, unreferenced, updateRef
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.ibm.awb.weakref.Ref
getRef, referenced, setRef, unreferenced
 

Constructor Detail

RemoteAgletRef

public RemoteAgletRef()
Method Detail

activate

public void activate()
              throws java.io.IOException,
                     AgletException
Description copied from interface: AgletRef
Activate the aglet
Specified by:
activate in interface AgletRef

checkValidation

public void checkValidation()
                     throws InvalidAgletException
Specified by:
checkValidation in interface AgletRef

delegateMessage

public void delegateMessage(Message msg)
                     throws InvalidAgletException
Delegates a message
Specified by:
delegateMessage in interface AgletRef

findRef

protected Ref findRef()
Overrides:
findRef in class WeakRef

findRef

protected Ref findRef(java.io.ObjectInputStream s)
               throws java.io.IOException,
                      java.lang.ClassNotFoundException
Overrides:
findRef in class WeakRef

getAddress

public java.lang.String getAddress()
                            throws InvalidAgletException
Gets the address of the target aglet
Specified by:
getAddress in interface AgletRef
Following copied from interface: com.ibm.aglets.AgletRef
Returns:
the address

getAglet

public Aglet getAglet()
               throws InvalidAgletException
Gets the aglet. If the aglet is access protected it will require the right key to get access.
Specified by:
getAglet in interface AgletRef
Returns:
the aglet
Throws:
java.lang.SecurityException - if the current execution is not allowed.

getAgletInfo

public AgletInfo getAgletInfo()
Gets the information of the aglet
Specified by:
getAgletInfo in interface AgletRef
Returns:
the AgletInfo of the aglet

getAgletRef

public static RemoteAgletRef getAgletRef(Ticket ticket,
                                         Name n)

getRefClassName

public java.lang.String getRefClassName()
Specified by:
getRefClassName in interface Ref

getRefID

protected java.lang.Object getRefID()
Overrides:
getRefID in class WeakRef

isActive

public boolean isActive()
Description copied from interface: AgletRef
Checks if it's active.
Specified by:
isActive in interface AgletRef

isRemote

public boolean isRemote()
Description copied from interface: AgletRef
Checks if it's valid.
Specified by:
isRemote in interface AgletRef

isState

public boolean isState(int s)
Check the state
Specified by:
isState in interface AgletRef

isValid

public boolean isValid()
Description copied from interface: AgletRef
Checks if it's valid.
Specified by:
isValid in interface AgletRef

resume

public void resume()
            throws AgletException
Description copied from interface: AgletRef
Resume the aglet
Specified by:
resume in interface AgletRef

sendFutureMessage

public FutureReply sendFutureMessage(Message msg)
                              throws InvalidAgletException
Sends a message in asynchronous way.
Specified by:
sendFutureMessage in interface AgletRef
Parameters:
msg - the message to send

sendMessage

public java.lang.Object sendMessage(Message msg)
                             throws MessageException,
                                    InvalidAgletException,
                                    NotHandledException
Sends a message in synchronous way.
Specified by:
sendMessage in interface AgletRef
Parameters:
msg - the message to send

sendOnewayMessage

public void sendOnewayMessage(Message msg)
                       throws InvalidAgletException
Sends a oneway message
Specified by:
sendOnewayMessage in interface AgletRef
Parameters:
msg - the message to send

showRefTable

public static void showRefTable(java.io.PrintStream out)

toString

public java.lang.String toString()
Overrides:
toString in class WeakRef

writeInfo

public void writeInfo(java.io.ObjectOutputStream s)
               throws java.io.IOException
Specified by:
writeInfo in interface Ref