Voyager ORB

com.objectspace.voyager.mobility
Class Mobility

java.lang.Object
  |
  +--com.objectspace.voyager.mobility.Mobility

public class Mobility
extends java.lang.Object
implements IMobility, IFacet, java.io.Serializable

The Mobility class provides methods for moving any Serializable object. To move an object to a new location, use Mobility.of() to obtain the object’s mobility facet and then use the methods defined in IMobility.

Version:
3.0
See Also:
Serialized Form

Field Summary
protected  java.lang.String destination
           
protected  java.util.Vector proxies
           
protected  Snapshot snapshot
           
 
Constructor Summary
Mobility()
           
Mobility(IFacets facets)
           
 
Method Summary
static com.objectspace.voyager.orb.AddressCarrier[] activate(Mobility mobility, java.lang.String callback, java.lang.Object[] arguments)
           
protected  void cleanMobilityFacet(Mobility facet)
           
protected  void execute(java.lang.String callback, java.lang.Object[] arguments)
           
 void finalize()
           
static IMobility get(java.lang.Object object)
          If the specified object implements IMobility, return the object.
protected  java.lang.String getHome()
           
protected  Mobility getMobilityFacet()
           
protected  void initMobilityFacet(Mobility facet)
           
 boolean isTransient()
           
 void moveTo(java.lang.Object destination)
           
 void moveTo(java.lang.Object destination, java.lang.String callback)
           
 void moveTo(java.lang.Object destination, java.lang.String callback, java.lang.Object[] args)
           
 void moveTo(java.lang.String destination)
           
 void moveTo(java.lang.String destination, java.lang.String callback)
           
 void moveTo(java.lang.String xurl, java.lang.String callback, java.lang.Object[] arguments)
           
protected  com.objectspace.voyager.mobility.MobilityInputStream newMobilityInputStream(java.io.ObjectInputStream input)
           
protected  com.objectspace.voyager.mobility.MobilityOutputStream newMobilityOutputStream(java.io.ObjectOutputStream output)
           
static IMobility of(java.lang.Object object)
          If the specified object implements IMobility, return the object.
protected  void postArrival()
           
protected  void postDeparture()
           
protected  com.objectspace.voyager.orb.AddressCarrier[] updateDestination()
           
protected  void updateOrigination(com.objectspace.voyager.orb.AddressCarrier[] addresses)
           
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

snapshot

protected transient Snapshot snapshot

proxies

protected transient java.util.Vector proxies

destination

protected transient java.lang.String destination
Constructor Detail

Mobility

public Mobility()

Mobility

public Mobility(IFacets facets)
Method Detail

finalize

public void finalize()
Overrides:
finalize in class java.lang.Object

getHome

protected java.lang.String getHome()

isTransient

public boolean isTransient()
Specified by:
isTransient in interface IFacet

moveTo

public void moveTo(java.lang.String destination)
            throws MobilityException
Specified by:
moveTo in interface IMobility

moveTo

public void moveTo(java.lang.String destination,
                   java.lang.String callback)
            throws MobilityException

moveTo

public void moveTo(java.lang.String xurl,
                   java.lang.String callback,
                   java.lang.Object[] arguments)
            throws MobilityException

moveTo

public void moveTo(java.lang.Object destination)
            throws MobilityException
Specified by:
moveTo in interface IMobility

moveTo

public void moveTo(java.lang.Object destination,
                   java.lang.String callback)
            throws MobilityException

moveTo

public void moveTo(java.lang.Object destination,
                   java.lang.String callback,
                   java.lang.Object[] args)
            throws MobilityException

getMobilityFacet

protected Mobility getMobilityFacet()

activate

public static com.objectspace.voyager.orb.AddressCarrier[] activate(Mobility mobility,
                                                                    java.lang.String callback,
                                                                    java.lang.Object[] arguments)
                                                             throws MobilityException,
                                                                    java.io.IOException,
                                                                    java.lang.ClassNotFoundException

execute

protected void execute(java.lang.String callback,
                       java.lang.Object[] arguments)

updateDestination

protected com.objectspace.voyager.orb.AddressCarrier[] updateDestination()
                                                                  throws java.io.IOException

postArrival

protected void postArrival()

updateOrigination

protected void updateOrigination(com.objectspace.voyager.orb.AddressCarrier[] addresses)
                          throws java.io.IOException

postDeparture

protected void postDeparture()

newMobilityOutputStream

protected com.objectspace.voyager.mobility.MobilityOutputStream newMobilityOutputStream(java.io.ObjectOutputStream output)
                                                                                 throws java.io.IOException

newMobilityInputStream

protected com.objectspace.voyager.mobility.MobilityInputStream newMobilityInputStream(java.io.ObjectInputStream input)
                                                                               throws java.io.IOException,
                                                                                      java.lang.ClassNotFoundException

initMobilityFacet

protected void initMobilityFacet(Mobility facet)

cleanMobilityFacet

protected void cleanMobilityFacet(Mobility facet)

of

public static IMobility of(java.lang.Object object)
                    throws java.lang.ClassCastException
If the specified object implements IMobility, return the object. If the specified object has a facet that implements IMobility, return the facet. If neither rule applies, add a facet that implements IMobility.
Parameters:
object - The primary object.
Throws:
java.lang.ClassCastException - A facet that implements IMobility could not be added.

get

public static IMobility get(java.lang.Object object)
If the specified object implements IMobility, return the object. If the specified object has a facet that implements IMobility, return a proxy to the facet. If neither rule applies, return null.
Parameters:
object - The primary object.

ObjectSpace Inc.

(c) Copyright 1997-1999 ObjectSpace, Inc.
14850 Quorum Drive, Suite 500
Dallas, Texas 75240