1. /*

  2.  * @(#)Any.java	1.25 01/11/29

  3.  *

  4.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package org.omg.CORBA;

  9. 

  10. import org.omg.CORBA.portable.InputStream;

  11. import org.omg.CORBA.portable.OutputStream;

  12. import org.omg.CORBA.portable.Streamable;

  13. import org.omg.CORBA.portable.IDLEntity;

  14. 

  15. 

  16. /**

  17.  * Serves as a container for any data that can be

  18.  * described in IDL or for any IDL primitive type.

  19.  * An <code>Any</code> object is used as a component of a

  20.  * <code>NamedValue</code> object, which provides information about

  21.  * arguments or return values in requests, and which is used to define

  22.  * name/value pairs in <code>Context</code> objects.

  23.  <p>

  24.  *

  25.  * An <code>Any</code> object consists of two parts:

  26.  * <OL>

  27.  * <LI>a data value

  28.  * <LI>a <code>TypeCode</code> object describing the type of the data

  29.  * value contained in the <code>Any</code> object.  For example,

  30.  * a <code>TypeCode</code> object for an array contains

  31.  * a field for the length of the array and a field for

  32.  * the type of elements in the array. (Note that in	this case, the

  33.  * second field of the <code>TypeCode</code> object is itself a

  34.  * <code>TypeCode</code> object.)

  35.  *

  36.  *

  37.  * </OL>

  38.  * <P>

  39.  * <a name="anyOps">

  40.  * A large part of the <code>Any</code> class consists of pairs of methods

  41.  * for inserting values into and extracting values from an

  42.  * <code>Any</code> object.

  43.  * <P>

  44.  * For a given primitive type X, these methods are:

  45.  *  <dl>

  46.  *	<dt><code><bold> void insert_X(X x)</bold></code>

  47.  *	<dd> This method allows the insertion of

  48.  *	  an instance <code>x</code> of primitive type <code>X</code>

  49.  *    into the <code>value</code> field of the <code>Any</code> object.

  50.  *    Note that the method

  51.  *    <code>insert_X</code> also resets the <code>Any</code> object's

  52.  *    <code>type</code> field if necessary.

  53.  *	<dt> <code><bold>X extract_X()</bold></code>

  54.  *	<dd> This method allows the extraction of an instance of

  55.  *	  type <code>X</code> from the <code>Any</code> object.

  56.  *    <BR>

  57.  *    <P>

  58.  *    This method throws the exception <code>BAD_OPERATION</code> under two conditions:

  59.  *    <OL>

  60.  *     <LI> the type of the element contained in the <code>Any</code> object is not

  61.  *	   <code>X</code>

  62.  *     <LI> the method <code>extract_X</code> is called before

  63.  *     the <code>value</code> field of the <code>Any</code> object

  64.  *     has been set

  65.  *    </OL>

  66.  * </dl>

  67.  * <P>

  68.  * There are distinct method pairs for each

  69.  * primitive IDL data type (<code>insert_long</code> and <code>extract_long</code>,

  70.  * <code>insert_string</code> and <code>extract_string</code>, and so on).<BR>

  71.  * <P>

  72.  * The class <code>Any</code> also has methods for

  73.  * getting and setting the type code,

  74.  * for testing two <code>Any</code> objects for equality,

  75.  * and for reading an <code>Any</code> object from a stream or

  76.  * writing it to a stream.

  77.  * <BR>

  78.  * @version 1.12, 09/09/97

  79.  * @since   JDK1.2

  80.  */

  81. abstract public class Any implements IDLEntity {

  82. 

  83.     /**

  84.      * Returns type information for the element contained in this

  85.      * <code>Any</code> object.

  86.      *

  87.      * @return		the <code>TypeCode</code> object containing type information

  88.      *                about the value contained in this <code>Any</code> object.

  89.      */

  90. 

  91.     abstract public TypeCode type();

  92. 

  93.     /**

  94.      * Sets this <code>Any</code> object's <code>type</code> field

  95.      * to the given <code>TypeCode</code> object and clears its value.

  96.      * <P>

  97.      * Note that using this method to set the type code wipes out the

  98.      * value if there is one. The method

  99.      * is provided primarily so that the type may be set properly for

  100.      * IDL <code>out</code> parameters.  Generally, setting the type

  101.      * is done by the <code>insert_X</code> methods, which will set the type

  102.      * to X if it is not already set to X.

  103.      *

  104.      * @param t       the <code>TypeCode</code> object giving

  105.      *                information for the value in

  106.      *                this <code>Any</code> object

  107.      */

  108. 

  109.     abstract public void type(TypeCode t);

  110. 

  111.     /**

  112.      * Checks for equality between this <code>Any</code> object and the

  113.      * given <code>Any</code> object.  Two <code>Any</code> objects are

  114.      * equal if both their values and type codes are equal.

  115.      *

  116.      * @param a	the <code>Any</code> object to test for equality

  117.      * @return	<code>true</code> if the <code>Any</code> objects are equal;

  118.      * <code>false</code> otherwise

  119.      */

  120. 

  121.     abstract public boolean equal(Any a);

  122. 

  123.     ///////////////////////////////////////////////////////////////////////////

  124.     // marshalling/unmarshalling routines

  125. 

  126.     /**

  127.      * Reads off (unmarshals) the value of an <code>Any</code> object from

  128.      * the given input stream using the given typecode.

  129.      *

  130.      * @param is the <code>org.omg.CORBA.portable.InputStream</code>

  131.      *                object from which to read

  132.      *                the value contained in this <code>Any</code> object

  133.      *

  134.      * @param t	 a <code>TypeCode</code> object containing type information

  135.      *           about the value to be read

  136.      *

  137.      * @exception MARSHAL when the given <code>TypeCode</code> object is

  138.      *                    not consistent with the value that was contained

  139.      *                    in the input stream

  140.      */

  141. 

  142.     abstract public void   read_value(InputStream is, TypeCode t)

  143.       throws MARSHAL;

  144. 

  145.     /**

  146.      * Writes out to the given output stream the typecode and value

  147.      * of this <code>Any</code> object.

  148.      * <P>

  149.      * If this method is called on an <code>Any</code> object that has not

  150.      * had a value inserted into its <code>value</code> field, it will throw

  151.      * the exception <code>java.lang.NullPointerException</code>.

  152.      *

  153.      * @param os	the <code>org.omg.CORBA.portable.OutputStream</code>

  154.      *                object into which to marshal the value and typecode

  155.      *                of this <code>Any</code> object

  156.      *

  157.      */

  158. 

  159.     abstract public void   write_value(OutputStream os);

  160. 

  161.     /**

  162.      * Creates an output stream into which this <code>Any</code> object's

  163.      * value can be marshalled.

  164.      *

  165.      * @return		the newly-created <code>OutputStream</code>

  166.      */

  167. 

  168.     abstract public OutputStream  create_output_stream();

  169. 

  170.     /**

  171.      * Creates an input stream from which this <code>Any</code> object's value

  172.      * can be unmarshalled.

  173.      *

  174.      * @return		the newly-created <code>InputStream</code>

  175.      */

  176. 

  177.     abstract public InputStream  create_input_stream();

  178. 

  179.     ///////////////////////////////////////////////////////////////////////////

  180.     // insertion of streamables

  181. 

  182.     /**

  183.      * Inserts the given <code>Streamable</code> object

  184.      * into this <code>Any</code> object's <code>value</code> field.

  185.      * This method allows the insertion of non-primitive IDL types.

  186.      *

  187.      * @param s		the <code>Streamable</code> object to insert into this

  188.      *                <code>Any</code> object; may be a non-primitive

  189. 	 *                IDL type

  190.      */

  191. 

  192.     abstract public void insert_Streamable(Streamable s);

  193. 

  194. 

  195.     ///////////////////////////////////////////////////////////////////////////

  196.     // basic insertion/extraction methods

  197. 

  198.     /**

  199.      * Extracts the <code>short</code> in this

  200.      * <code>Any</code> object's <code>value</code> field.

  201.      *

  202.      * @return the <code>short</code> stored in this <code>Any</code> object

  203. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  204. 	 *              contains something other than a <code>short</code> or the

  205. 	 *              <code>value</code> field has not yet been set

  206.      */

  207.     abstract public short    extract_short() throws BAD_OPERATION;

  208. 

  209.     /**

  210.      * Inserts the given <code>short</code> 

  211.      * into this <code>Any</code> object's <code>value</code> field.

  212.      *

  213.      * @param s		the <code>short</code> to insert into this

  214.      *                <code>Any</code> object

  215.      */

  216.     abstract public void     insert_short(short s);

  217. 

  218.     /**

  219.      * Extracts the <code>int</code> in this

  220.      * <code>Any</code> object's <code>value</code> field.

  221.      *

  222.      * @return the <code>int</code> stored in this <code>Any</code> object

  223. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  224. 	 *              contains something other than an <code>int</code> or the

  225. 	 *              <code>value</code> field has not yet been set

  226.      */

  227. 

  228.     abstract public int      extract_long() throws BAD_OPERATION;

  229. 

  230.     /**

  231.      * Inserts the given <code>int</code> 

  232.      * into this <code>Any</code> object's <code>value</code> field.

  233.      *

  234.      * @param l		the <code>int</code> to insert into this

  235.      *                <code>Any</code> object

  236.      */

  237.     abstract public void     insert_long(int l);

  238. 

  239. 

  240.     /**

  241.      * Extracts the <code>long</code> in this

  242.      * <code>Any</code> object's <code>value</code> field.

  243.      *

  244.      * @return the <code>long</code> stored in this <code>Any</code> object

  245. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  246. 	 *              contains something other than a <code>long</code> or the

  247. 	 *              <code>value</code> field has not yet been set

  248.      */

  249.     abstract public long     extract_longlong() throws BAD_OPERATION;

  250. 

  251.     /**

  252.      * Inserts the given <code>long</code> 

  253.      * into this <code>Any</code> object's <code>value</code> field.

  254.      *

  255.      * @param l		the <code>long</code> to insert into this

  256.      *                <code>Any</code> object

  257.      */

  258.     abstract public void     insert_longlong(long l);

  259. 

  260. 

  261.     /**

  262.      * Extracts the <code>short</code> in this

  263.      * <code>Any</code> object's <code>value</code> field.

  264.      *

  265.      * @return the <code>short</code> stored in this <code>Any</code> object

  266. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  267. 	 *              contains something other than a <code>short</code> or the

  268. 	 *              <code>value</code> field has not yet been set

  269.      */

  270.     abstract public short    extract_ushort() throws BAD_OPERATION;

  271. 

  272.     /**

  273.      * Inserts the given <code>short</code> 

  274.      * into this <code>Any</code> object's <code>value</code> field.

  275.      *

  276.      * @param s		the <code>short</code> to insert into this

  277.      *                <code>Any</code> object

  278.      */

  279.     abstract public void     insert_ushort(short s);

  280. 

  281. 

  282.     /**

  283.      * Extracts the <code>int</code> in this

  284.      * <code>Any</code> object's <code>value</code> field.

  285.      *

  286.      * @return the <code>int</code> stored in this <code>Any</code> object

  287. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  288. 	 *              contains something other than an <code>int</code> or the

  289. 	 *              <code>value</code> field has not yet been set

  290.      */

  291.     abstract public int      extract_ulong() throws BAD_OPERATION;

  292. 

  293.     /**

  294.      * Inserts the given <code>int</code> 

  295.      * into this <code>Any</code> object's <code>value</code> field.

  296.      *

  297.      * @param l		the <code>int</code> to insert into this

  298.      *                <code>Any</code> object

  299.      */

  300.     abstract public void     insert_ulong(int l);

  301. 

  302. 

  303.     /**

  304.      * Extracts the <code>long</code> in this

  305.      * <code>Any</code> object's <code>value</code> field.

  306.      *

  307.      * @return the <code>long</code> stored in this <code>Any</code> object

  308. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  309. 	 *              contains something other than a <code>long</code> or the

  310. 	 *              <code>value</code> field has not yet been set

  311.      */

  312.     abstract public long     extract_ulonglong() throws BAD_OPERATION;

  313. 

  314.     /**

  315.      * Inserts the given <code>long</code> 

  316.      * into this <code>Any</code> object's <code>value</code> field.

  317.      *

  318.      * @param l		the <code>long</code> to insert into this

  319.      *                <code>Any</code> object

  320.      */

  321.     abstract public void     insert_ulonglong(long l);

  322. 

  323. 

  324.     /**

  325.      * Extracts the <code>float</code> in this

  326.      * <code>Any</code> object's <code>value</code> field.

  327.      *

  328.      * @return the <code>float</code> stored in this <code>Any</code> object

  329. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  330. 	 *              contains something other than a <code>float</code> or the

  331. 	 *              <code>value</code> field has not yet been set

  332.      */

  333.     abstract public float    extract_float() throws BAD_OPERATION;

  334. 

  335.     /**

  336.      * Inserts the given <code>float</code> 

  337.      * into this <code>Any</code> object's <code>value</code> field.

  338.      *

  339.      * @param f		the <code>float</code> to insert into this

  340.      *                <code>Any</code> object

  341.      */

  342.     abstract public void     insert_float(float f);

  343. 

  344. 

  345.     /**

  346.      * Extracts the <code>double</code> in this

  347.      * <code>Any</code> object's <code>value</code> field.

  348.      *

  349.      * @return the <code>double</code> stored in this <code>Any</code> object

  350. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  351. 	 *              contains something other than a <code>double</code> or the

  352. 	 *              <code>value</code> field has not yet been set

  353.      */

  354.     abstract public double   extract_double() throws BAD_OPERATION;

  355. 

  356.     /**

  357.      * Inserts the given <code>double</code> 

  358.      * into this <code>Any</code> object's <code>value</code> field.

  359.      *

  360.      * @param d		the <code>double</code> to insert into this

  361.      *                <code>Any</code> object

  362.      */

  363.     abstract public void     insert_double(double d);

  364. 

  365. 

  366.     /**

  367.      * Extracts the <code>boolean</code> in this

  368.      * <code>Any</code> object's <code>value</code> field.

  369.      *

  370.      * @return the <code>boolean</code> stored in this <code>Any</code> object

  371. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  372. 	 *              contains something other than a <code>boolean</code> or the

  373. 	 *              <code>value</code> field has not yet been set

  374.      */

  375.     abstract public boolean  extract_boolean() throws BAD_OPERATION;

  376. 

  377.     /**

  378.      * Inserts the given <code>boolean</code> 

  379.      * into this <code>Any</code> object's <code>value</code> field.

  380.      *

  381.      * @param b		the <code>boolean</code> to insert into this

  382.      *                <code>Any</code> object

  383.      */

  384.     abstract public void     insert_boolean(boolean b);

  385. 

  386. 

  387.     /**

  388.      * Extracts the <code>char</code> in this

  389.      * <code>Any</code> object's <code>value</code> field.

  390.      *

  391.      * @return the <code>char</code> stored in this <code>Any</code> object

  392. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  393. 	 *              contains something other than a <code>char</code> or the

  394. 	 *              <code>value</code> field has not yet been set

  395.      */

  396.     abstract public char     extract_char() throws BAD_OPERATION;

  397. 

  398.     /**

  399.      * Inserts the given <code>char</code> 

  400.      * into this <code>Any</code> object's <code>value</code> field.

  401.      *

  402.      * @param c		the <code>char</code> to insert into this

  403.      *                <code>Any</code> object

  404. 	 * @exception <code>DATA_CONVERSION</code>

  405.      */

  406.     abstract public void     insert_char(char c) throws DATA_CONVERSION;

  407. 

  408. 

  409.     /**

  410.      * Extracts the <code>byte</code> in this

  411.      * <code>Any</code> object's <code>value</code> field.

  412.      *

  413.      * @return the <code>byte</code> stored in this <code>Any</code> object

  414. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  415. 	 *              contains something other than a <code>byte</code> or the

  416. 	 *              <code>value</code> field has not yet been set

  417.      */

  418.     abstract public byte     extract_octet() throws BAD_OPERATION;

  419. 

  420.     /**

  421.      * Inserts the given <code>byte</code> 

  422.      * into this <code>Any</code> object's <code>value</code> field.

  423.      *

  424.      * @param b		the <code>byte</code> to insert into this

  425.      *                <code>Any</code> object

  426.      */

  427.     abstract public void     insert_octet(byte b);

  428. 

  429. 

  430.     /**

  431.      * Extracts the <code>char</code> in this

  432.      * <code>Any</code> object's <code>value</code> field.

  433.      *

  434.      * @return the <code>char</code> stored in this <code>Any</code> object

  435. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  436. 	 *              contains something other than a <code>char</code> or the

  437. 	 *              <code>value</code> field has not yet been set

  438.      */

  439.     abstract public char     extract_wchar() throws BAD_OPERATION;

  440. 

  441.     /**

  442.      * Inserts the given <code>char</code> 

  443.      * into this <code>Any</code> object's <code>value</code> field.

  444.      *

  445.      * @param c		the <code>char</code> to insert into this

  446.      *                <code>Any</code> object

  447.      */

  448.     abstract public void     insert_wchar(char c);

  449. 

  450. 

  451.     /**

  452.      * Extracts the <code>Any</code> object in this

  453.      * <code>Any</code> object's <code>value</code> field.

  454.      *

  455.      * @return the <code>Any</code> object stored in this <code>Any</code> object

  456. 	 * @exception <code>BAD_OPERATION</code> if this <code>Any</code> object 

  457. 	 *              contains something other than an <code>Any</code> object or the

  458. 	 *              <code>value</code> field has not yet been set

  459.      */

  460.     abstract public Any      extract_any() throws BAD_OPERATION;

  461. 

  462.     /**

  463.      * Inserts the given <code>Any</code> object

  464.      * into this <code>Any</code> object's <code>value</code> field.

  465.      *

  466.      * @param a		the <code>Any</code> object to insert into this

  467.      *                <code>Any</code> object

  468.      */

  469.     abstract public void     insert_any(Any a);

  470. 

  471. 

  472.     /**

  473.      * Extracts the <code>String</code> object in this

  474.      * <code>Any</code> object's <code>value</code> field.

  475.      *

  476.      * @return the <code>String</code> object stored in this <code>Any</code> object

  477. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  478. 	 *              contains something other than a <code>String</code> object or the

  479. 	 *              <code>value</code> field has not yet been set

  480.      */

  481.     abstract public String   extract_string() throws BAD_OPERATION;

  482. 

  483.     /**

  484.      * Inserts the given <code>String</code> object

  485.      * into this <code>Any</code> object's <code>value</code> field.

  486.      *

  487.      * @param s		the <code>String</code> object to insert into this

  488.      *                <code>Any</code> object

  489. 	 * @exception <code>DATA_CONVERSION</code>

  490. 	 * @exception <code>MARSHAL</code>

  491.      */

  492.     abstract public void     insert_string(String s) throws DATA_CONVERSION, MARSHAL;

  493. 

  494. 

  495.     /**

  496.      * Extracts the <code>String</code> object in this

  497.      * <code>Any</code> object's <code>value</code> field.

  498.      *

  499.      * @return the <code>String</code> object stored in this <code>Any</code> object

  500. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  501. 	 *              contains something other than a <code>String</code> object or the

  502. 	 *              <code>value</code> field has not yet been set

  503.      */

  504.     abstract public String   extract_wstring() throws BAD_OPERATION;

  505. 

  506.     /**

  507.      * Inserts the given <code>String</code> object

  508.      * into this <code>Any</code> object's <code>value</code> field.

  509.      *

  510.      * @param s		the <code>String</code> object to insert into this

  511.      *                <code>Any</code> object

  512.      */

  513.     abstract public void     insert_wstring(String s) throws MARSHAL;

  514. 

  515. 

  516.     /**

  517.      * Extracts the <code>org.omg.CORBA.Object</code> in this

  518.      * <code>Any</code> object's <code>value</code> field.

  519.      *

  520.      * @return the <code>org.omg.CORBA.Object</code> stored in 

  521. 	 *         this <code>Any</code> object

  522. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  523. 	 *              contains something other than an 

  524. 	 *              <code>org.omg.CORBA.Object</code> or the

  525. 	 *              <code>value</code> field has not yet been set

  526.      */

  527.     abstract public org.omg.CORBA.Object extract_Object() throws BAD_OPERATION;

  528. 

  529.     /**

  530.      * Inserts the given <code>org.omg.CORBA.Object</code> object

  531.      * into this <code>Any</code> object's <code>value</code> field.

  532.      *

  533.      * @param o		the <code>org.omg.CORBA.Object</code> object to insert into this

  534.      *                <code>Any</code> object

  535.      */

  536.     abstract public void     insert_Object(org.omg.CORBA.Object o);

  537. 

  538.     /**

  539.      * Inserts the given <code>org.omg.CORBA.Object</code> object

  540.      * into this <code>Any</code> object's <code>value</code> field.

  541.      *

  542.      * @param o		the <code>org.omg.CORBA.Object</code> instance to insert into this

  543.      *                <code>Any</code> object

  544. 	 * @param t     the <code>TypeCode</code> object that is to be inserted into

  545. 	 *              this <code>Any</code> object and that describes

  546. 	 *              the <code>Object</code> being inserted

  547. 	 *              

  548.      */

  549.     abstract public void     insert_Object(org.omg.CORBA.Object o, 

  550. 					   TypeCode t) 

  551. 	throws BAD_OPERATION;

  552. 

  553.     /**

  554.      * Extracts the <code>TypeCode</code> object in this

  555.      * <code>Any</code> object's <code>value</code> field.

  556.      *

  557.      * @return the <code>TypeCode</code> object stored in this <code>Any</code> object

  558. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  559. 	 *              contains something other than a <code>TypeCode</code> object or the

  560. 	 *              <code>value</code> field has not yet been set

  561.      */

  562.     abstract public TypeCode extract_TypeCode() throws BAD_OPERATION;

  563. 

  564.     /**

  565.      * Inserts the given <code>TypeCode</code> object

  566.      * into this <code>Any</code> object's <code>value</code> field.

  567.      *

  568.      * @param t		the <code>TypeCode</code> object to insert into this

  569.      *                <code>Any</code> object

  570.      */

  571.     abstract public void	   insert_TypeCode(TypeCode t);

  572. 

  573. 

  574.     /**

  575.     * Extracts the <code>Principal</code> object in this

  576.     * <code>Any</code> object's <code>value</code> field.

  577.     * Note that the class <code>Principal</code> has been deprecated.

  578.     *

  579.     * @return the <code>Principal</code> object stored in this <code>Any</code> object

  580.     * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object

  581.     *              contains something other than a

  582.     *              <code>Principal</code> object or the

  583.     *              <code>value</code> field has not yet been set

  584.     * @deprecated Deprecated by CORBA 2.2.

  585.     */

  586.     abstract public Principal extract_Principal() throws BAD_OPERATION;

  587. 

  588.     /**

  589.     * Inserts the given <code>Principal</code> object

  590.     * into this <code>Any</code> object's <code>value</code> field.

  591.     * Note that the class <code>Principal</code> has been deprecated.

  592.     *

  593.     * @param p		the <code>Principal</code> object to insert into this

  594.     *                <code>Any</code> object

  595.     * @deprecated Deprecated by CORBA 2.2.

  596.     */

  597.     abstract public void	   insert_Principal(Principal p);

  598. 

  599. 

  600.     /**

  601.      * Extracts the <code>java.math.BigDecimal</code> object in this

  602.      * <code>Any</code> object's <code>value</code> field.

  603.      *

  604.      * @return the <code>java.math.BigDecimal</code> object 

  605. 	 *         stored in this <code>Any</code> object

  606. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  607. 	 *              contains something other than a

  608. 	 *              <code>java.math.BigDecimal</code> object or the

  609. 	 *              <code>value</code> field has not yet been set

  610.      */

  611.     public java.math.BigDecimal extract_fixed() {

  612.         throw new org.omg.CORBA.NO_IMPLEMENT();

  613.     }

  614. 

  615. 

  616.     /**

  617.      * Inserts the given <code>java.math.BigDecimal</code> object

  618.      * into this <code>Any</code> object's <code>value</code> field.

  619.      *

  620.      * @param value		the <code>java.math.BigDecimal</code> object

  621. 	 *                  to insert into this <code>Any</code> object

  622.      */

  623.     public void insert_fixed(java.math.BigDecimal value) {

  624. 	throw new org.omg.CORBA.NO_IMPLEMENT();

  625.     }

  626. 

  627. 

  628.     /**

  629.      * Inserts the given <code>java.math.BigDecimal</code> object

  630.      * into this <code>Any</code> object's <code>value</code> field.

  631.      *

  632.      * @param value		the <code>java.math.BigDecimal</code> object

  633. 	 *                  to insert into this <code>Any</code> object

  634. 	 * @param type     the <code>TypeCode</code> object that is to be inserted into

  635. 	 *              this <code>Any</code> object's <code>type</code> field

  636. 	 *              and that describes the <code>java.math.BigDecimal</code> 

  637. 	 *              object being inserted

  638.      */

  639.     public void insert_fixed(java.math.BigDecimal value,

  640. 			     org.omg.CORBA.TypeCode type) {

  641. 	throw new org.omg.CORBA.NO_IMPLEMENT();

  642.     }

  643. 

  644.     // Changes due to orbos/98-01-18: Objects-by-Value

  645. 

  646. 

  647.     /**

  648.      * Extracts the <code>java.io.Serializable</code> object in this

  649.      * <code>Any</code> object's <code>value</code> field.

  650.      *

  651.      * @return the <code>java.io.Serializable</code> object stored in

  652. 	 *         this <code>Any</code> object

  653. 	 * @exception <code>BAD_OPERATION</code> if this  <code>Any</code> object 

  654. 	 *              contains something other than a <code>java.io.Serializable</code> 

  655. 	 *              object or the

  656. 	 *              <code>value</code> field has not yet been set

  657.      */

  658.     public java.io.Serializable extract_Value() throws BAD_OPERATION {

  659. 	throw new org.omg.CORBA.NO_IMPLEMENT();

  660.     }

  661. 

  662. 

  663.     /**

  664.      * Inserts the given <code>java.io.Serializable</code> object

  665.      * into this <code>Any</code> object's <code>value</code> field.

  666.      *

  667.      * @param v		the <code>java.io.Serializable</code> object to insert into this

  668.      *                <code>Any</code> object

  669.      */

  670.     public void insert_Value(java.io.Serializable v) {

  671. 	throw new org.omg.CORBA.NO_IMPLEMENT();

  672.     }

  673. 

  674. 

  675.     /**

  676.      * Inserts the given <code>java.io.Serializable</code> object

  677.      * into this <code>Any</code> object's <code>value</code> field.

  678.      *

  679.      * @param v		the <code>java.io.Serializable</code> object to insert into this

  680.      *                <code>Any</code> object

  681. 	 * @param t     the <code>TypeCode</code> object that is to be inserted into

  682. 	 *              this <code>Any</code> object's <code>type</code> field

  683. 	 *              and that describes the <code>java.io.Serializable</code> 

  684. 	 *              object being inserted

  685.      */

  686.     public void insert_Value(java.io.Serializable v, TypeCode t)

  687. 	throws MARSHAL

  688.     {

  689. 	throw new org.omg.CORBA.NO_IMPLEMENT();

  690.     }

  691. }