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