Frames | No Frames |
1: /* _ServantActivatorStub.java -- 2: Copyright (C) 2005 Free Software Foundation, Inc. 3: 4: This file is part of GNU Classpath. 5: 6: GNU Classpath is free software; you can redistribute it and/or modify 7: it under the terms of the GNU General Public License as published by 8: the Free Software Foundation; either version 2, or (at your option) 9: any later version. 10: 11: GNU Classpath is distributed in the hope that it will be useful, but 12: WITHOUT ANY WARRANTY; without even the implied warranty of 13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14: General Public License for more details. 15: 16: You should have received a copy of the GNU General Public License 17: along with GNU Classpath; see the file COPYING. If not, write to the 18: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 19: 02110-1301 USA. 20: 21: Linking this library statically or dynamically with other modules is 22: making a combined work based on this library. Thus, the terms and 23: conditions of the GNU General Public License cover the whole 24: combination. 25: 26: As a special exception, the copyright holders of this library give you 27: permission to link this library with independent modules to produce an 28: executable, regardless of the license terms of these independent 29: modules, and to copy and distribute the resulting executable under 30: terms of your choice, provided that you also meet, for each linked 31: independent module, the terms and conditions of the license of that 32: module. An independent module is a module which is not derived from 33: or based on this library. If you modify this library, you may extend 34: this exception to your version of the library, but you are not 35: obligated to do so. If you do not wish to do so, delete this 36: exception statement from your version. */ 37: 38: 39: package org.omg.PortableServer; 40: 41: import org.omg.CORBA.MARSHAL; 42: import org.omg.CORBA.ORB; 43: import org.omg.CORBA.ObjectHelper; 44: import org.omg.CORBA.portable.ApplicationException; 45: import org.omg.CORBA.portable.Delegate; 46: import org.omg.CORBA.portable.InputStream; 47: import org.omg.CORBA.portable.ObjectImpl; 48: import org.omg.CORBA.portable.OutputStream; 49: import org.omg.CORBA.portable.RemarshalException; 50: 51: import java.io.Serializable; 52: 53: /** 54: * <p>This ServantActivator stub is an optional base for the 55: * servant activators. This stub cannot accept remote invocations, as 56: * methods in {@link ServantActivatorOperations} take POA as one of parameters. 57: * Both JDK 1.5 API and OMG specifies that POA is a local object that must not 58: * be transferred to the remote invocation target. 59: * </p><p> 60: * You do not need to derive your servant activator from this stub, 61: * it is enough to implement the {@link ServantActivator} interface. 62: * But you may choose to do this if you need the functional 63: * {@link #_ids()} method or want to keep default behavior during 64: * the incarnation or etherialization. 65: * </p> 66: * @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org) 67: */ 68: public class _ServantActivatorStub 69: extends ObjectImpl 70: implements ServantActivator, Serializable 71: { 72: /** 73: * Use serialVersionUID (v1.4) for interoperability. 74: */ 75: private static final long serialVersionUID = -685959979577281419L; 76: 77: /** 78: * This the purpose of this field is undocumented up till 1.5 java API 79: * inclusive. 80: */ 81: public static final Class _opsClass = ServantActivatorOperations.class; 82: 83: /** 84: * Return the array of repository ids for this object. 85: * 86: * @return { "IDL:omg.org/PortableServer/ServantActivator:2.3", 87: * "IDL:omg.org/PortableServer/ServantManager:1.0" }, always. 88: */ 89: public String[] _ids() 90: { 91: return new String[] 92: { 93: "IDL:omg.org/PortableServer/ServantActivator:2.3", 94: "IDL:omg.org/PortableServer/ServantManager:1.0" 95: }; 96: } 97: 98: /** 99: * It is your responsibility to handle the incarnation event and 100: * supply the servant. Override this method if using the class. 101: * The default method instructs POA that the servant cannot be 102: * provided by activator. The OBJ_ADAPTER exception will be 103: * thrown by POA, unless the servant is provided as one of the 104: * parameters in the activation method. 105: * 106: * @see ServantActivatorOperations#incarnate 107: * 108: * @specnote in GNU Classpath, returning null means that the 109: * activator does not supply the servant. 110: * 111: * @throws ForwardRequest 112: */ 113: public Servant incarnate(byte[] Object_id, POA poa) 114: throws ForwardRequest 115: { 116: return null; 117: } 118: 119: /** 120: * It is your responsibility to handle the etherialization event. 121: * Override this method if using the class. The default method 122: * does nothing. 123: * 124: * @see ServantActivatorOperations#incarnate 125: */ 126: public void etherealize(byte[] Object_id, POA poa, Servant servant, 127: boolean cleanup, boolean remaining 128: ) 129: { 130: }