| /* 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. */ | |
| package gnu.java.rmi.server; | |
| import java.io.IOException; | |
| import java.io.ObjectInput; | |
| import java.io.ObjectOutput; | |
| import java.rmi.Remote; | |
| import java.rmi.RemoteException; | |
| import java.rmi.activation.ActivationID; | |
| import java.rmi.server.ObjID; | |
| import java.rmi.server.RMIServerSocketFactory; | |
| import java.rmi.server.RemoteStub; | |
| import java.rmi.server.Skeleton; | |
| /** | |
| * 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. | |
| * | |
| * @author Audrius Meskauskas (Audriusa@Bioinformatics.org) | |
| */ | |
| public class ActivatableServerRef extends UnicastServerRef | |
| { | |
| /** | |
| * Use SVUID for interoperability | |
| */ | |
| private static final long serialVersionUID = 1; | |
| /** | |
| * The object activation id. | |
| */ | |
| public ActivationID actId; | |
| /** | |
| * Used by serialization only | |
| */ | |
| public ActivatableServerRef() | |
| { | |
| super(); | |
| } | |
| /** | |
| * Create the new activatable server reference that will activate object on | |
| * the first call using the given activation id. | |
| */ | |
| public ActivatableServerRef(ObjID id, ActivationID anId, int aPort, | |
| RMIServerSocketFactory ssFactory) | |
| throws RemoteException | |
| { | |
| super(id, aPort, ssFactory); | |
| actId = anId; | |
| // The object ID will be placed in the object map and should deliver | |
| // incoming call to {@link #incommingMessageCall}. The object itself | |
| // is currently null. | |
| UnicastServer.exportActivatableObject(this); | |
| } | |
| /** | |
| * Inactivate the object (stop the server). | |
| */ | |
| public void inactivate() | |
| { | |
| manager.stopServer(); | |
| } | |
| /** | |
| * Activate the object (normally during the first call). | |
| */ | |
| protected void activate() throws RemoteException | |
| { | |
| try | |
| { | |
| Remote self = actId.activate(false); | |
| // This will call UnicastServer.exportObject, replacing null by | |
| // the activated object (self) in the object map. | |
| exportObject(self); | |
| } | |
| catch (RemoteException rex) | |
| { | |
| throw rex; | |
| } | |
| catch (Exception exc) | |
| { | |
| RemoteException rx = new RemoteException("Activation failed."); | |
| rx.detail = exc; | |
| throw rx; | |
| } | |
| } | |
| /** | |
| * If the object is not active, activate it first. | |
| */ | |
| public Object incomingMessageCall(UnicastConnection conn, int method, | |
| long hash) throws Exception | |
| { | |
| if (myself == null) | |
| activate(); | |
| return super.incomingMessageCall(conn, method, hash); | |
| } | |
| /** | |
| * Export object and ensure it is present in the server activation table | |
| * as well. | |
| */ | |
| public Remote exportObject(Remote obj) throws RemoteException | |
| { | |
| Remote r = super.exportObject(obj); | |
| UnicastServer.registerActivatable(this); | |
| return r; | |
| } | |
| /** | |
| * Export object and ensure it is present in the server activation table as | |
| * well. | |
| * | |
| * @param aClass the class being exported, must implement Remote. | |
| */ | |
| public Remote exportClass(Class aClass) throws RemoteException | |
| { | |
| if (!Remote.class.isAssignableFrom(aClass)) | |
| throw new InternalError(aClass.getName()+" must implement Remote"); | |
| String ignoreStubs; | |
| ClassLoader loader =aClass.getClassLoader(); | |
| // Stubs are always searched for the bootstrap classes that may have | |
| // obsolete pattern and may still need also skeletons. | |
| if (loader==null) | |
| ignoreStubs = "false"; | |
| else | |
| ignoreStubs = System.getProperty("java.rmi.server.ignoreStubClasses", | |
| "false"); | |
| if (! ignoreStubs.equals("true")) | |
| { | |
| // Find and install the stub | |
| Class cls = aClass; | |
| // where ist the _Stub? (check superclasses also) | |
| Class expCls = findStubSkelClass(cls); | |
| if (expCls != null) | |
| { | |
| stub = (RemoteStub) getHelperClass(expCls, "_Stub"); | |
| // Find and install the skeleton (if there is one) | |
| skel = (Skeleton) getHelperClass(expCls, "_Skel"); | |
| } | |
| } | |
| if (stub == null) | |
| stub = createProxyStub(aClass, this); | |
| // Build hash of methods which may be called. | |
| buildMethodHash(aClass, true); | |
| UnicastServer.registerActivatable(this); | |
| return stub; | |
| } | |
| /** | |
| * Get the referencing class. | |
| */ | |
| public String getRefClass(ObjectOutput out) | |
| { | |
| return "ActivatableRef"; | |
| } | |
| /** | |
| * Read the content from the input stream. | |
| */ | |
| public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException | |
| { | |
| super.readExternal(in); | |
| actId = (ActivationID) in.readObject(); | |
| } | |
| /** | |
| * Write the content to the output stream. | |
| */ | |
| public void writeExternal(ObjectOutput out) throws IOException | |
| { | |
| super.writeExternal(out); | |
| out.writeObject(actId); | |
| } | |
| } |