duke@1: /*
ohair@158:  * Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved.
duke@1:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1:  *
duke@1:  * This code is free software; you can redistribute it and/or modify it
duke@1:  * under the terms of the GNU General Public License version 2 only, as
ohair@158:  * published by the Free Software Foundation.  Oracle designates this
duke@1:  * particular file as subject to the "Classpath" exception as provided
ohair@158:  * by Oracle in the LICENSE file that accompanied this code.
duke@1:  *
duke@1:  * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
duke@1:  * version 2 for more details (a copy is included in the LICENSE file that
duke@1:  * accompanied this code).
duke@1:  *
duke@1:  * You should have received a copy of the GNU General Public License version
duke@1:  * 2 along with this work; if not, write to the Free Software Foundation,
duke@1:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1:  *
ohair@158:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@158:  * or visit www.oracle.com if you need additional information or have any
ohair@158:  * questions.
duke@1:  */
duke@1: 
duke@1: package org.omg.CORBA;
duke@1: 
duke@1: import org.omg.CORBA.portable.InputStream;
duke@1: import org.omg.CORBA.portable.OutputStream;
duke@1: import org.omg.CORBA.portable.Streamable;
duke@1: import org.omg.CORBA.portable.IDLEntity;
duke@1: 
duke@1: /**
duke@1:  * Serves as a container for any data that can be
duke@1:  * described in IDL or for any IDL primitive type.
duke@1:  * An <code>Any</code> object is used as a component of a
duke@1:  * <code>NamedValue</code> object, which provides information about
duke@1:  * arguments or return values in requests, and which is used to define
duke@1:  * name/value pairs in <code>Context</code> objects.
duke@1:  <p>
duke@1:  *
duke@1:  * An <code>Any</code> object consists of two parts:
duke@1:  * <OL>
duke@1:  * <LI>a data value
duke@1:  * <LI>a <code>TypeCode</code> object describing the type of the data
duke@1:  * value contained in the <code>Any</code> object.  For example,
duke@1:  * a <code>TypeCode</code> object for an array contains
duke@1:  * a field for the length of the array and a field for
duke@1:  * the type of elements in the array. (Note that in     this case, the
duke@1:  * second field of the <code>TypeCode</code> object is itself a
duke@1:  * <code>TypeCode</code> object.)
duke@1:  * </OL>
duke@1:  *
duke@1:  * <P>
duke@1:  * <a name="anyOps"</a>
duke@1:  * A large part of the <code>Any</code> class consists of pairs of methods
duke@1:  * for inserting values into and extracting values from an
duke@1:  * <code>Any</code> object.
duke@1:  * <P>
duke@1:  * For a given primitive type X, these methods are:
duke@1:  *  <dl>
duke@1:  *      <dt><code><bold> void insert_X(X x)</bold></code>
duke@1:  *      <dd> This method allows the insertion of
duke@1:  *        an instance <code>x</code> of primitive type <code>X</code>
duke@1:  *    into the <code>value</code> field of the <code>Any</code> object.
duke@1:  *    Note that the method
duke@1:  *    <code>insert_X</code> also resets the <code>Any</code> object's
duke@1:  *    <code>type</code> field if necessary.
duke@1:  *      <dt> <code><bold>X extract_X()</bold></code>
duke@1:  *      <dd> This method allows the extraction of an instance of
duke@1:  *        type <code>X</code> from the <code>Any</code> object.
duke@1:  *    <BR>
duke@1:  *    <P>
duke@1:  *    This method throws the exception <code>BAD_OPERATION</code> under two conditions:
duke@1:  *    <OL>
duke@1:  *     <LI> the type of the element contained in the <code>Any</code> object is not
duke@1:  *         <code>X</code>
duke@1:  *     <LI> the method <code>extract_X</code> is called before
duke@1:  *     the <code>value</code> field of the <code>Any</code> object
duke@1:  *     has been set
duke@1:  *    </OL>
duke@1:  * </dl>
duke@1:  * <P>
duke@1:  * There are distinct method pairs for each
duke@1:  * primitive IDL data type (<code>insert_long</code> and <code>extract_long</code>,
duke@1:  * <code>insert_string</code> and <code>extract_string</code>, and so on).<BR>
duke@1:  * <P>
duke@1:  * The class <code>Any</code> also has methods for
duke@1:  * getting and setting the type code,
duke@1:  * for testing two <code>Any</code> objects for equality,
duke@1:  * and for reading an <code>Any</code> object from a stream or
duke@1:  * writing it to a stream.
duke@1:  * <BR>
duke@1:  * @since   JDK1.2
duke@1:  */
duke@1: abstract public class Any implements IDLEntity {
duke@1: 
duke@1:     /**
duke@1:      * Checks for equality between this <code>Any</code> object and the
duke@1:      * given <code>Any</code> object.  Two <code>Any</code> objects are
duke@1:      * equal if both their values and type codes are equal.
duke@1:      *
duke@1:      * @param a the <code>Any</code> object to test for equality
duke@1:      * @return  <code>true</code> if the <code>Any</code> objects are equal;
duke@1:      * <code>false</code> otherwise
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     abstract public boolean equal(Any a);
duke@1: 
duke@1:     /**
duke@1:      * Returns type information for the element contained in this
duke@1:      * <code>Any</code> object.
duke@1:      *
duke@1:      * @return          the <code>TypeCode</code> object containing type information
duke@1:      *                about the value contained in this <code>Any</code> object
duke@1:      */
duke@1:     abstract public TypeCode type();
duke@1: 
duke@1:     /**
duke@1:      * Sets this <code>Any</code> object's <code>type</code> field
duke@1:      * to the given <code>TypeCode</code> object and clears its value.
duke@1:      * <P>
duke@1:      * Note that using this method to set the type code wipes out the
duke@1:      * value if there is one. The method
duke@1:      * is provided primarily so that the type may be set properly for
duke@1:      * IDL <code>out</code> parameters.  Generally, setting the type
duke@1:      * is done by the <code>insert_X</code> methods, which will set the type
duke@1:      * to X if it is not already set to X.
duke@1:      *
duke@1:      * @param t       the <code>TypeCode</code> object giving
duke@1:      *                information for the value in
duke@1:      *                this <code>Any</code> object
duke@1:      */
duke@1:     abstract public void type(TypeCode t);
duke@1: 
duke@1:     ///////////////////////////////////////////////////////////////////////////
duke@1:     // marshalling/unmarshalling routines
duke@1: 
duke@1:     /**
duke@1:      * Reads off (unmarshals) the value of an <code>Any</code> object from
duke@1:      * the given input stream using the given typecode.
duke@1:      *
duke@1:      * @param is the <code>org.omg.CORBA.portable.InputStream</code>
duke@1:      *                object from which to read
duke@1:      *                the value contained in this <code>Any</code> object
duke@1:      *
duke@1:      * @param t  a <code>TypeCode</code> object containing type information
duke@1:      *           about the value to be read
duke@1:      *
duke@1:      * @exception MARSHAL when the given <code>TypeCode</code> object is
duke@1:      *                    not consistent with the value that was contained
duke@1:      *                    in the input stream
duke@1:      */
duke@1:     abstract public void   read_value(InputStream is, TypeCode t)
duke@1:         throws MARSHAL;
duke@1: 
duke@1:     /**
duke@1:      * Writes out the value of this <code>Any</code> object
duke@1:      * to the given output stream.  If both <code>typecode</code>
duke@1:      * and <code>value</code> need to be written, use
duke@1:      * <code>create_output_stream()</code> to create an <code>OutputStream</code>,
duke@1:      * then use <code>write_any</code> on the <code>OutputStream</code>.
duke@1:      * <P>
duke@1:      * If this method is called on an <code>Any</code> object that has not
duke@1:      * had a value inserted into its <code>value</code> field, it will throw
duke@1:      * the exception <code>java.lang.NullPointerException</code>.
duke@1:      *
duke@1:      * @param os        the <code>org.omg.CORBA.portable.OutputStream</code>
duke@1:      *                object into which to marshal the value
duke@1:      *                of this <code>Any</code> object
duke@1:      *
duke@1:      */
duke@1:     abstract public void   write_value(OutputStream os);
duke@1: 
duke@1:     /**
duke@1:      * Creates an output stream into which this <code>Any</code> object's
duke@1:      * value can be marshalled.
duke@1:      *
duke@1:      * @return          the newly-created <code>OutputStream</code>
duke@1:      */
duke@1:     abstract public OutputStream  create_output_stream();
duke@1: 
duke@1:     /**
duke@1:      * Creates an input stream from which this <code>Any</code> object's value
duke@1:      * can be unmarshalled.
duke@1:      *
duke@1:      * @return          the newly-created <code>InputStream</code>
duke@1:      */
duke@1:     abstract public InputStream  create_input_stream();
duke@1: 
duke@1:     ///////////////////////////////////////////////////////////////////////////
duke@1:     // basic insertion/extraction methods
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>short</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>short</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>short</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public short    extract_short() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>short</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param s         the <code>short</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_short(short s);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>int</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>int</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than an <code>int</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public int      extract_long() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>int</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param l         the <code>int</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_long(int l);
duke@1: 
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>long</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>long</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>long</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public long     extract_longlong() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>long</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param l         the <code>long</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_longlong(long l);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>short</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>short</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>short</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public short    extract_ushort() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>short</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param s         the <code>short</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_ushort(short s);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>int</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>int</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than an <code>int</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public int      extract_ulong() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>int</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param l         the <code>int</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_ulong(int l);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>long</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>long</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>long</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public long     extract_ulonglong() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>long</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param l         the <code>long</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_ulonglong(long l);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>float</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>float</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>float</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public float    extract_float() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>float</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param f         the <code>float</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_float(float f);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>double</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>double</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>double</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public double   extract_double() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>double</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param d         the <code>double</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_double(double d);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>boolean</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>boolean</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>boolean</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public boolean  extract_boolean() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>boolean</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param b         the <code>boolean</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_boolean(boolean b);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>char</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>char</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>char</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public char     extract_char() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>char</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param c         the <code>char</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @exception DATA_CONVERSION if there is a data conversion
duke@1:          *            error
duke@1:      */
duke@1:     abstract public void     insert_char(char c) throws DATA_CONVERSION;
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>char</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>char</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>char</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public char     extract_wchar() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>char</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param c         the <code>char</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_wchar(char c);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>byte</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>byte</code> stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>byte</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public byte     extract_octet() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>byte</code>
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param b         the <code>byte</code> to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_octet(byte b);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>Any</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>Any</code> object stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this <code>Any</code> object
duke@1:      *              contains something other than an <code>Any</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public Any      extract_any() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>Any</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param a         the <code>Any</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void     insert_any(Any a);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>org.omg.CORBA.Object</code> in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>org.omg.CORBA.Object</code> stored in
duke@1:      *         this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than an
duke@1:      *              <code>org.omg.CORBA.Object</code> or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public org.omg.CORBA.Object extract_Object() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>org.omg.CORBA.Object</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param o         the <code>org.omg.CORBA.Object</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void insert_Object(org.omg.CORBA.Object o);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>java.io.Serializable</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>java.io.Serializable</code> object stored in
duke@1:      *         this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>java.io.Serializable</code>
duke@1:      *              object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public java.io.Serializable extract_Value() throws BAD_OPERATION ;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>java.io.Serializable</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param v         the <code>java.io.Serializable</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void insert_Value(java.io.Serializable v) ;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>java.io.Serializable</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param v         the <code>java.io.Serializable</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @param t     the <code>TypeCode</code> object that is to be inserted into
duke@1:      *              this <code>Any</code> object's <code>type</code> field
duke@1:      *              and that describes the <code>java.io.Serializable</code>
duke@1:      *              object being inserted
duke@1:          * @throws MARSHAL if the ORB has a problem marshalling or
duke@1:          *          unmarshalling parameters
duke@1:      */
duke@1:     abstract public void insert_Value(java.io.Serializable v, TypeCode t)
duke@1:         throws MARSHAL ;
duke@1: /**
duke@1:      * Inserts the given <code>org.omg.CORBA.Object</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param o         the <code>org.omg.CORBA.Object</code> instance to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @param t     the <code>TypeCode</code> object that is to be inserted into
duke@1:      *              this <code>Any</code> object and that describes
duke@1:      *              the <code>Object</code> being inserted
duke@1:      * @exception BAD_OPERATION if this  method is invalid for this
duke@1:          *            <code>Any</code> object
duke@1:      *
duke@1:      */
duke@1:     abstract public void insert_Object(org.omg.CORBA.Object o, TypeCode t)
duke@1:         throws BAD_PARAM;
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>String</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>String</code> object stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>String</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public String   extract_string() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>String</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param s         the <code>String</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @exception DATA_CONVERSION if there is a data conversion error
duke@1:      * @exception MARSHAL if the ORB has a problem marshalling or
duke@1:          *             unmarshalling parameters
duke@1:      */
duke@1:     abstract public void     insert_string(String s) throws DATA_CONVERSION, MARSHAL;
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>String</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>String</code> object stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>String</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public String   extract_wstring() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>String</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param s         the <code>String</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @exception MARSHAL if the ORB has a problem marshalling or
duke@1:          *             unmarshalling parameters
duke@1:      */
duke@1:     abstract public void     insert_wstring(String s) throws MARSHAL;
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>TypeCode</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>TypeCode</code> object stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a <code>TypeCode</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      */
duke@1:     abstract public TypeCode extract_TypeCode() throws BAD_OPERATION;
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>TypeCode</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param t         the <code>TypeCode</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      */
duke@1:     abstract public void           insert_TypeCode(TypeCode t);
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>Principal</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      * Note that the class <code>Principal</code> has been deprecated.
duke@1:      *
duke@1:      * @return the <code>Principal</code> object stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a
duke@1:      *              <code>Principal</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      * @deprecated Deprecated by CORBA 2.2.
duke@1:      */
duke@1:     @Deprecated
duke@1:     public Principal extract_Principal() throws BAD_OPERATION {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT() ;
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>Principal</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      * Note that the class <code>Principal</code> has been deprecated.
duke@1:      *
duke@1:      * @param p         the <code>Principal</code> object to insert into this
duke@1:      *                <code>Any</code> object
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      * @deprecated Deprecated by CORBA 2.2.
duke@1:      */
duke@1:     @Deprecated
duke@1:     public void    insert_Principal(Principal p) {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT() ;
duke@1:     }
duke@1: 
duke@1:     ///////////////////////////////////////////////////////////////////////////
duke@1:     // insertion/extraction of streamables
duke@1: 
duke@1:     /**
duke@1:      * Extracts a <code>Streamable</code> from this <code>Any</code> object's
duke@1:      * <code>value</code> field.  This method allows the extraction of
duke@1:      * non-primitive IDL types.
duke@1:      *
duke@1:      * @return the <code>Streamable</code> stored in the <code>Any</code> object.
duke@1:      * @throws BAD_INV_ORDER if the caller has invoked operations in the wrong order
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     public org.omg.CORBA.portable.Streamable extract_Streamable()
duke@1:         throws org.omg.CORBA.BAD_INV_ORDER {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT() ;
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * Inserts the given <code>Streamable</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      * This method allows the insertion of non-primitive IDL types.
duke@1:      *
duke@1:      * @param s         the <code>Streamable</code> object to insert into this
duke@1:      *                <code>Any</code> object; may be a non-primitive
duke@1:      *                IDL type
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     public void insert_Streamable(Streamable s) {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT() ;
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * Extracts the <code>java.math.BigDecimal</code> object in this
duke@1:      * <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @return the <code>java.math.BigDecimal</code> object
duke@1:      *         stored in this <code>Any</code> object
duke@1:      * @exception BAD_OPERATION if this  <code>Any</code> object
duke@1:      *              contains something other than a
duke@1:      *              <code>java.math.BigDecimal</code> object or the
duke@1:      *              <code>value</code> field has not yet been set
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     public java.math.BigDecimal extract_fixed() {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * Throws an <a href="package-summary.html#NO_IMPLEMENT">
duke@1:      * <code>org.omg.CORBA.NO_IMPLEMENT</code></a> exception.
duke@1:      * <P>
duke@1:      * Inserts the given <code>java.math.BigDecimal</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param value             the <code>java.math.BigDecimal</code> object
duke@1:      *                  to insert into this <code>Any</code> object
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     public void insert_fixed(java.math.BigDecimal value) {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1:     }
duke@1: 
duke@1:     /**
duke@1:      * Throws an <a href="package-summary.html#NO_IMPLEMENT">
duke@1:      * <code>org.omg.CORBA.NO_IMPLEMENT</code></a> exception.
duke@1:      * <P>
duke@1:      * Inserts the given <code>java.math.BigDecimal</code> object
duke@1:      * into this <code>Any</code> object's <code>value</code> field.
duke@1:      *
duke@1:      * @param value             the <code>java.math.BigDecimal</code> object
duke@1:      *                  to insert into this <code>Any</code> object
duke@1:      * @param type     the <code>TypeCode</code> object that is to be inserted into
duke@1:      *              this <code>Any</code> object's <code>type</code> field
duke@1:      *              and that describes the <code>java.math.BigDecimal</code>
duke@1:      *              object being inserted
duke@1:      * @throws org.omg.CORBA.BAD_INV_ORDER if this method is  invoked improperly
duke@1:      * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
duke@1:      *      comments for unimplemented features</a>
duke@1:      */
duke@1:     public void insert_fixed(java.math.BigDecimal value, org.omg.CORBA.TypeCode type)
duke@1:         throws org.omg.CORBA.BAD_INV_ORDER
duke@1:     {
duke@1:         throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1:     }
duke@1: }