Frames | No Frames |
1: /* ServantActivatorHelper.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 gnu.CORBA.Minor; 42: import gnu.CORBA.OrbRestricted; 43: 44: import org.omg.CORBA.Any; 45: import org.omg.CORBA.BAD_OPERATION; 46: import org.omg.CORBA.BAD_PARAM; 47: import org.omg.CORBA.MARSHAL; 48: import org.omg.CORBA.ORB; 49: import org.omg.CORBA.TypeCode; 50: import org.omg.CORBA.portable.InputStream; 51: import org.omg.CORBA.portable.OutputStream; 52: 53: /** 54: * The helper operations for the CORBA object {@link ServantActivator}. 55: * 56: * @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org) 57: */ 58: public abstract class ServantActivatorHelper 59: { 60: /** 61: * Get the type code of the {@link ServantActivator}. 62: */ 63: public static TypeCode type() 64: { 65: return OrbRestricted.Singleton.create_interface_tc(id(), "ServantActivator"); 66: } 67: 68: /** 69: * Insert the ServantActivator into the given Any. 70: * 71: * @param any the Any to insert into. 72: * @param that the ServantActivator to insert. 73: */ 74: public static void insert(Any any, ServantActivator that) 75: { 76: any.insert_Object(that); 77: } 78: 79: /** 80: * Extract the ServantActivator from given Any. 81: * 82: * @throws BAD_OPERATION if the passed Any does not contain ServantActivator. 83: */ 84: public static ServantActivator extract(Any any) 85: { 86: return narrow(any.extract_Object()); 87: } 88: 89: /** 90: * Get the ServantActivator repository id. 91: * 92: * @return "IDL:omg.org/PortableServer/ServantActivator:2.3", always. 93: */ 94: public static String id() 95: { 96: return "IDL:omg.org/PortableServer/ServantActivator:2.3"; 97: } 98: 99: /** 100: * Casts the passed object into the ServantActivator. 101: * 102: * @param obj the object to cast. 103: * @return casted instance. 104: * @throws BAD_PARAM if the passed object is not a ServantActivator. 105: */ 106: public static ServantActivator narrow(org.omg.CORBA.Object obj) 107: { 108: try 109: { 110: return (ServantActivator) obj; 111: } 112: catch (ClassCastException ex) 113: { 114: BAD_PARAM bad = new BAD_PARAM(); 115: bad.initCause(ex); 116: throw bad; 117: } 118: } 119: 120: /** 121: * Narrow the given object to the ServantActivator. For the objects that are 122: * always local, this operation does not differ from the ordinary 123: * {@link #narrow} (ClassCastException will be thrown if narrowing something 124: * different). 125: * 126: * @param obj the object to cast. 127: * 128: * @return the casted ServantActivator. 129: * 130: * @since 1.5 131: * 132: * @see OMG issue 4158. 133: */ 134: public static ServantActivator unchecked_narrow(org.omg.CORBA.Object obj) 135: { 136: return narrow(obj); 137: } 138: 139: 140: /** 141: * This should read the servant activator, but it cannot be transferred 142: * this way as its operations cannot be remote. The operations cannot 143: * be remote because one of the method parameters, POA, is required to be 144: * always a local object (both by 1.5 API and 3.0.3 OMG). 145: * 146: * @throws MARSHAL, always. 147: * 148: * @specnote Same as Sun. 149: */ 150: public static ServantActivator read(InputStream input) 151: { 152: MARSHAL m = new MARSHAL("Inappropriate"); 153: m.minor = Minor.Inappropriate; 154: throw m; 155: } 156: 157: /** 158: * This should write the servant activator, but it cannot be transferred 159: * this way as its operations cannot be remote. The operations cannot 160: * be remote because one of the method parameters, POA, is required to be 161: * always a local object (both by 1.5 API and 3.0.3 OMG). 162: * 163: * @throws MARSHAL, always. 164: * 165: * @specnote Same as Sun. 166: */ 167: public static void write(OutputStream output, ServantActivator value) 168: { 169: MARSHAL m = new MARSHAL("Inappropriate"); 170: m.minor = Minor.Inappropriate; 171: throw m; 172: }