old-autovect-branch/libjava/classpath/org/omg/PortableInterceptor/IORInterceptor_3_0Helper.java

   1 /* IORInterceptor_3_0Helper.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.PortableInterceptor;
  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.BAD_PARAM;
  46 import org.omg.CORBA.ORB;
  47 import org.omg.CORBA.TypeCode;
  48 import org.omg.CORBA.portable.Delegate;
  49 import org.omg.CORBA.portable.InputStream;
  50 import org.omg.CORBA.portable.ObjectImpl;
  51 import org.omg.CORBA.portable.OutputStream;
  52
  53 /**
  54  * The helper operations for the CORBA object {@link IORInterceptor_3_0}.
  55  *
  56  * @since 1.5
  57  *
  58  * @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org)
  59  */
  60 public abstract class IORInterceptor_3_0Helper
  61 {
  62   /**
  63    * The cached {@link IORInterceptor_3_0} typecode, computed once.
  64    */
  65   private static TypeCode typeCode;
  66
  67   /**
  68    * Get the type code of the {@link IORInterceptor_3_0}.
  69    */
  70   public static TypeCode type()
  71   {
  72     if (typeCode == null)
  73       typeCode = ORB.init().create_interface_tc(id(), "IORInterceptor_3_0");
  74     return typeCode;
  75   }
  76
  77   /**
  78    * Insert the IORInterceptor_3_0 into the given Any.
  79    *
  80    * @param any the Any to insert into.
  81    * @param that the IORInterceptor_3_0 to insert.
  82    */
  83   public static void insert(Any any, IORInterceptor_3_0 that)
  84   {
  85     any.insert_Streamable(new IORInterceptor_3_0Holder(that));
  86   }
  87
  88   /**
  89    * Extract the IORInterceptor_3_0 from given Any.
  90    *
  91    * @throws BAD_OPERATION if the passed Any does not contain
  92    * IORInterceptor_3_0.
  93    */
  94   public static IORInterceptor_3_0 extract(Any any)
  95   {
  96     try
  97       {
  98         IORInterceptor_3_0Holder holder = (IORInterceptor_3_0Holder)
  99           any.extract_Streamable();
 100         return holder.value;
 101       }
 102     catch (ClassCastException cex)
 103       {
 104         BAD_OPERATION bad = new BAD_OPERATION("IORInterceptor_3_0 expected");
 105         bad.minor = Minor.Any;
 106         bad.initCause(cex);
 107         throw bad;
 108       }
 109   }
 110
 111   /**
 112    * Get the IORInterceptor_3_0 repository id.
 113    *
 114    * @return "IDL:omg.org/PortableInterceptor/IORInterceptor_3_0:1.0", always.
 115    */
 116   public static String id()
 117   {
 118     return "IDL:omg.org/PortableInterceptor/IORInterceptor_3_0:1.0";
 119   }
 120
 121   /**
 122    * Narrow the passed object into the IORInterceptor_3_0. If the object has a
 123    * different java type, create an instance of the _IORInterceptor_3_0Stub,
 124    * using the same delegate, as for the passed parameter. Hence, unlike java
 125    * type cast, this method may return a different object, than has been passed.
 126    *
 127    * @param obj the object to narrow.
 128    * @return narrowed instance.
 129    * @throws BAD_PARAM if the passed object is not a IORInterceptor_3_0.
 130    */
 131   public static IORInterceptor_3_0 narrow(org.omg.CORBA.Object obj)
 132   {
 133     if (obj == null)
 134       return null;
 135     else if (obj instanceof IORInterceptor_3_0)
 136       return (IORInterceptor_3_0) obj;
 137     else if (!obj._is_a(id()))
 138       throw new BAD_PARAM("Not a IORInterceptor_3_0");
 139     else
 140       {
 141         Delegate delegate = ((ObjectImpl) obj)._get_delegate();
 142         return new _IORInterceptor_3_0Stub(delegate);
 143       }
 144   }
 145
 146   /**
 147    * Narrow the passed object into the IORInterceptor_3_0. No type-checking is
 148    * performed to verify that the object actually supports the requested type.
 149    * The {@link BAD_OPERATION} will be thrown if unsupported operations are
 150    * invoked on the new returned reference, but no failure is expected at the
 151    * time of the unchecked_narrow. For instance, the narrowing of the
 152    * remote instance of the {@link IORInterceptor} will work as long as only the
 153    * methods, inherited from this parent, are invoked.
 154    *
 155    *
 156    * @param obj the object to narrow.
 157    * @return narrowed instance.
 158    * @throws BAD_PARAM if the passed object is not a IORInterceptor_3_0.
 159    */
 160   public static IORInterceptor_3_0 unchecked_narrow(org.omg.CORBA.Object obj)
 161   {
 162     if (obj == null)
 163       return null;
 164     else if (obj instanceof IORInterceptor_3_0)
 165       return (IORInterceptor_3_0) obj;
 166     else
 167       {
 168         Delegate delegate = ((ObjectImpl) obj)._get_delegate();
 169         return new _IORInterceptor_3_0Stub(delegate);
 170       }
 171   }
 172
 173
 174   /**
 175    * Read the IORInterceptor_3_0 from the CDR intput stream (IOR profile
 176    * expected).
 177    *
 178    * @param input a org.omg.CORBA.portable stream to read from.
 179    */
 180   public static IORInterceptor_3_0 read(InputStream input)
 181   {
 182     return unchecked_narrow(input.read_Object());
 183   }
 184
 185   /**
 186    * Write the IORInterceptor_3_0 to the CDR output stream (as IOR profile).
 187    *
 188    * @param output a org.omg.CORBA.portable stream stream to write into.
 189    * @param value a value to write.
 190    */
 191   public static void write(OutputStream output, IORInterceptor_3_0 value)
 192   {
 193     output.write_Object(value);
 194   }
 195 }