Frames | No Frames |
1: /* DynUnionHelper.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.DynamicAny; 40: 41: import gnu.CORBA.OrbRestricted; 42: 43: import org.omg.CORBA.BAD_PARAM; 44: import org.omg.CORBA.TypeCode; 45: import org.omg.CORBA.ORB; 46: import org.omg.CORBA.Any; 47: import org.omg.CORBA.portable.InputStream; 48: import org.omg.CORBA.MARSHAL; 49: import org.omg.CORBA.portable.OutputStream; 50: 51: /** 52: * The helper operations for {@link DynUnion}. Following the 1.5 JDK 53: * specifications, DynUnion is always a local object, so the two methods of this 54: * helper ({@link #read} and {@link #write} are not in use, always throwing 55: * {@link MARSHAL}. 56: * 57: * @specnote always throwing MARSHAL in read and write ensures compatibility 58: * with other popular implementations like Sun's. 59: * 60: * @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org) 61: */ 62: public abstract class DynUnionHelper 63: { 64: /** 65: * Cast the passed object into the DynUnion. As DynUnion is a local object, 66: * the method just uses java type cast. 67: * 68: * @param obj the object to narrow. 69: * @return narrowed instance. 70: * @throws BAD_PARAM if the passed object is not a DynUnion. 71: */ 72: public static DynUnion narrow(org.omg.CORBA.Object obj) 73: { 74: try 75: { 76: return (DynUnion) obj; 77: } 78: catch (ClassCastException cex) 79: { 80: throw new BAD_PARAM(obj.getClass().getName() + " is not a DynUnion"); 81: } 82: } 83: 84: /** 85: * Narrow the given object to the DynUnion. For the objects that are 86: * always local, this operation does not differ from the ordinary 87: * {@link #narrow} (ClassCastException will be thrown if narrowing something 88: * different). 89: * 90: * @param obj the object to cast. 91: * 92: * @return the casted DynUnion. 93: * 94: * @since 1.5 95: * 96: * @see OMG issue 4158. 97: */ 98: public static DynUnion unchecked_narrow(org.omg.CORBA.Object obj) 99: { 100: return narrow(obj); 101: } 102: 103: /** 104: * Get the type code of the {@link DynUnion}. 105: */ 106: public static TypeCode type() 107: { 108: return OrbRestricted.Singleton.create_interface_tc(id(), "DynUnion"); 109: } 110: 111: /** 112: * Insert the DynUnion into the given Any. 113: * 114: * @param any the Any to insert into. 115: * 116: * @param that the DynUnion to insert. 117: */ 118: public static void insert(Any any, DynUnion that) 119: { 120: any.insert_Object(that); 121: } 122: 123: /** 124: * Extract the DynUnion from given Any. 125: * 126: * @throws BAD_OPERATION if the passed Any does not contain DynUnion. 127: */ 128: public static DynUnion extract(Any any) 129: { 130: return narrow(any.extract_Object()); 131: } 132: 133: /** 134: * Get the DynUnion repository id. 135: * 136: * @return "IDL:omg.org/DynamicAny/DynUnion:1.0", always. 137: */ 138: public static String id() 139: { 140: return "IDL:omg.org/DynamicAny/DynUnion:1.0"; 141: } 142: 143: /** 144: * This should read DynUnion from the CDR input stream, but (following the JDK 145: * 1.5 API) it does not. 146: * 147: * @param input a org.omg.CORBA.portable stream to read from. 148: * 149: * @specenote Sun throws the same exception. 150: * 151: * @throws MARSHAL always. 152: */ 153: public static DynUnion read(InputStream input) 154: { 155: throw new MARSHAL(DynAnyFactoryHelper.not_applicable(id())); 156: } 157: 158: /** 159: * This should read DynUnion from the CDR input stream, but (following the JDK 160: * 1.5 API) it does not. 161: * 162: * @param input a org.omg.CORBA.portable stream to read from. 163: * 164: * @specenote Sun throws the same exception. 165: * 166: * @throws MARSHAL always. 167: */ 168: public static void write(OutputStream output, DynUnion value) 169: { 170: throw new MARSHAL(DynAnyFactoryHelper.not_applicable(id())); 171: }