gnu.java.rmi.server

Class ActivatableServerRef

Implemented Interfaces:
Externalizable, ProtocolConstants, RemoteRef, Serializable

public class ActivatableServerRef
extends UnicastServerRef

The activatable server reference works like UnicastServerReference, but it additionally activates the associated object on demand, during the first incoming call. When UnicastServerReference takes the working reference, the ActivatableServerRef takes the activation id instead.

Field Summary

ActivationID
actId
The object activation id.

Fields inherited from class gnu.java.rmi.server.UnicastServerRef

methods, skel, stub

Fields inherited from class gnu.java.rmi.server.UnicastRef

objid

Fields inherited from interface gnu.java.rmi.server.ProtocolConstants

DEFAULT_PROTOCOL, MESSAGE_CALL, MESSAGE_CALL_ACK, MESSAGE_DGCACK, MESSAGE_PING, MESSAGE_PING_ACK, MULTIPLEX_PROTOCOL, PROTOCOL_ACK, PROTOCOL_HEADER, PROTOCOL_NACK, PROTOCOL_VERSION, RETURN_ACK, RETURN_NACK, SINGLE_OP_PROTOCOL, STREAM_PROTOCOL

Fields inherited from interface java.rmi.server.RemoteRef

packagePrefix, serialVersionUID

Constructor Summary

ActivatableServerRef()
Used by serialization only
ActivatableServerRef(ObjID id, ActivationID anId, int aPort, RMIServerSocketFactory ssFactory)
Create the new activatable server reference that will activate object on the first call using the given activation id.

Method Summary

protected void
activate()
Activate the object (normally during the first call).
Remote
exportClass(Class<T> aClass)
Export object and ensure it is present in the server activation table as well.
Remote
exportObject(Remote obj)
Export object and ensure it is present in the server activation table as well.
String
getRefClass(ObjectOutput out)
Get the referencing class.
void
inactivate()
Inactivate the object (stop the server).
Object
incomingMessageCall(UnicastConnection conn, int method, long hash)
If the object is not active, activate it first.
void
readExternal(ObjectInput in)
Read the content from the input stream.
void
writeExternal(ObjectOutput out)
Write the content to the output stream.

Methods inherited from class gnu.java.rmi.server.UnicastServerRef

buildMethodHash, exportObject, findStubSkelClass, getClientHost, getHelperClass, getStub, incomingMessageCall, unexportObject

Methods inherited from class gnu.java.rmi.server.UnicastRef

done, dump, equals, getRefClass, hashCode, invoke, invoke, invokeCommon, invokeCommon, newCall, notifyDGC, readExternal, remoteEquals, remoteHashCode, remoteToString, writeExternal

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

actId

public ActivationID actId
The object activation id.

Constructor Details

ActivatableServerRef

public ActivatableServerRef()
Used by serialization only

ActivatableServerRef

public ActivatableServerRef(ObjID id,
                            ActivationID anId,
                            int aPort,
                            RMIServerSocketFactory ssFactory)
            throws RemoteException
Create the new activatable server reference that will activate object on the first call using the given activation id.

Method Details

activate

protected void activate()
            throws RemoteException
Activate the object (normally during the first call).

exportClass

public Remote exportClass(Class<T> aClass)
            throws RemoteException
Export object and ensure it is present in the server activation table as well.
Parameters:
aClass - the class being exported, must implement Remote.

exportObject

public Remote exportObject(Remote obj)
            throws RemoteException
Export object and ensure it is present in the server activation table as well.
Overrides:
exportObject in interface UnicastServerRef

getRefClass

public String getRefClass(ObjectOutput out)
Get the referencing class.
Specified by:
getRefClass in interface RemoteRef
Overrides:
getRefClass in interface UnicastRef

inactivate

public void inactivate()
Inactivate the object (stop the server).

incomingMessageCall

public Object incomingMessageCall(UnicastConnection conn,
                                  int method,
                                  long hash)
            throws Exception
If the object is not active, activate it first.
Overrides:
incomingMessageCall in interface UnicastServerRef

readExternal

public void readExternal(ObjectInput in)
            throws IOException,
                   ClassNotFoundException
Read the content from the input stream.
Specified by:
readExternal in interface Externalizable
Overrides:
readExternal in interface UnicastRef

writeExternal

public void writeExternal(ObjectOutput out)
            throws IOException
Write the content to the output stream.
Specified by:
writeExternal in interface Externalizable
Overrides:
writeExternal in interface UnicastRef

ActivatableServerRef.java -- The activatable server reference Copyright (C) 2006 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.