1. /*

  2.  * @(#)DynAny.java	1.18 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. 

  12. package org.omg.CORBA;

  13. 

  14. 

  15. /** org.omg.CORBA.Any values can be dynamically interpreted (traversed) and

  16.  *  constructed

  17.  *  through DynAny objects. A DynAny object is associated with a data value

  18.  *  which may correspond to a copy of the value inserted into an Any.

  19.  *  The DynAny APIs enable traversal of the data value associated with an

  20.  *  Any at runtime and extraction of the primitive constituents of the

  21.  *  data value.

  22.  */

  23. 

  24. 

  25. public interface DynAny extends org.omg.CORBA.Object

  26. {

  27.     /**

  28.      * Returns the <code>TypeCode</code> of the object inserted into

  29.      * this <code>DynAny</code>.

  30.      *

  31.      * @return the <code>TypeCode</code> object.

  32.      */

  33.     public org.omg.CORBA.TypeCode type() ;

  34.     

  35.     /**

  36.      * Copy the contents from one Dynamic Any into another.

  37.      *

  38.      * @param dyn_any the <code>DynAny</code> object whose contents

  39.      *                are assigned to this <code>DynAny</code>. 

  40.      * @throws Invalid if the source <code>DynAny</code> is

  41.      *            invalid 

  42.      */

  43.     public void assign(org.omg.CORBA.DynAny dyn_any)

  44.         throws org.omg.CORBA.DynAnyPackage.Invalid;

  45. 

  46.     /**

  47.      * Make a <code>DynAny</code> object from an <code>Any</code>

  48.      * object.

  49.      *

  50.      * @param value the <code>Any</code> object.

  51.      * @throws Invalid if the source <code>Any</code> object is

  52.      *                    empty or bad

  53.      */

  54.     public void from_any(org.omg.CORBA.Any value)

  55.         throws org.omg.CORBA.DynAnyPackage.Invalid;

  56. 

  57.     /**

  58.      * Convert a <code>DynAny</code> object to an <code>Any</code>

  59.      * object.

  60.      *

  61.      * @return the <code>Any</code> object.

  62.      * @throws Invalid if this <code>DynAny</code> is empty or

  63.      *                    bad.

  64.      *            created or does not contain a meaningful value

  65.      */

  66.     public org.omg.CORBA.Any to_any()

  67.         throws org.omg.CORBA.DynAnyPackage.Invalid;

  68. 

  69.     /**

  70.      * Destroys this <code>DynAny</code> object and frees any resources

  71.      * used to represent the data value associated with it. This method

  72.      * also destroys all <code>DynAny</code> objects obtained from it.

  73.      * <p>

  74.      * Destruction of <code>DynAny</code> objects should be handled with

  75.      * care, taking into account issues dealing with the representation of 

  76.      * data values associated with <code>DynAny</code> objects.  A programmer

  77.      * who wants to destroy a <code>DynAny</code> object but still be able

  78.      * to manipulate some component of the data value associated with it,

  79.      * should first create a <code>DynAny</code> object for the component

  80.      * and then make a copy of the created <code>DynAny</code> object.

  81.      */

  82.     public void destroy() ;

  83. 

  84.     /**

  85.      * Clones this <code>DynAny</code> object.

  86.      *

  87.      * @return a copy of this <code>DynAny</code> object

  88.      */

  89.     public org.omg.CORBA.DynAny copy() ;

  90. 

  91.     /**

  92.      * Inserts the given <code>boolean</code> as the value for this

  93.      * <code>DynAny</code> object.

  94.      *

  95.      * <p> If this method is called on a constructed <code>DynAny</code>

  96.      * object, it initializes the next component of the constructed data

  97.      * value associated with this <code>DynAny</code> object.

  98.      *

  99.      * @param value the <code>boolean</code> to insert into this

  100.      *              <code>DynAny</code> object

  101.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  102.      *            if the value inserted is not consistent with the type

  103.      *            of the accessed component in this <code>DynAny</code> object

  104.      */

  105.     public void insert_boolean(boolean value)

  106.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  107. 

  108.     /**

  109.      * Inserts the given <code>byte</code> as the value for this

  110.      * <code>DynAny</code> object.

  111.      *

  112.      * <p> If this method is called on a constructed <code>DynAny</code>

  113.      * object, it initializes the next component of the constructed data

  114.      * value associated with this <code>DynAny</code> object.

  115.      *

  116.      * @param value the <code>byte</code> to insert into this

  117.      *              <code>DynAny</code> object

  118.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  119.      *            if the value inserted is not consistent with the type

  120.      *            of the accessed component in this <code>DynAny</code> object

  121.      */

  122.     public void insert_octet(byte value)

  123.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  124. 

  125.     /**

  126.      * Inserts the given <code>char</code> as the value for this

  127.      * <code>DynAny</code> object.

  128.      *

  129.      * <p> If this method is called on a constructed <code>DynAny</code>

  130.      * object, it initializes the next component of the constructed data

  131.      * value associated with this <code>DynAny</code> object.

  132.      *

  133.      * @param value the <code>char</code> to insert into this

  134.      *              <code>DynAny</code> object

  135.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  136.      *            if the value inserted is not consistent with the type

  137.      *            of the accessed component in this <code>DynAny</code> object

  138.      */

  139.     public void insert_char(char value)

  140.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  141. 

  142.     /**

  143.      * Inserts the given <code>short</code> as the value for this

  144.      * <code>DynAny</code> object.

  145.      *

  146.      * <p> If this method is called on a constructed <code>DynAny</code>

  147.      * object, it initializes the next component of the constructed data

  148.      * value associated with this <code>DynAny</code> object.

  149.      *

  150.      * @param value the <code>short</code> to insert into this

  151.      *              <code>DynAny</code> object

  152.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  153.      *            if the value inserted is not consistent with the type

  154.      *            of the accessed component in this <code>DynAny</code> object

  155.      */

  156.     public void insert_short(short value)

  157.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  158. 

  159.     /**

  160.      * Inserts the given <code>short</code> as the value for this

  161.      * <code>DynAny</code> object.

  162.      *

  163.      * <p> If this method is called on a constructed <code>DynAny</code>

  164.      * object, it initializes the next component of the constructed data

  165.      * value associated with this <code>DynAny</code> object.

  166.      *

  167.      * @param value the <code>short</code> to insert into this

  168.      *              <code>DynAny</code> object

  169.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  170.      *            if the value inserted is not consistent with the type

  171.      *            of the accessed component in this <code>DynAny</code> object

  172.      */

  173.     public void insert_ushort(short value)

  174.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  175. 

  176.     /**

  177.      * Inserts the given <code>int</code> as the value for this

  178.      * <code>DynAny</code> object.

  179.      *

  180.      * <p> If this method is called on a constructed <code>DynAny</code>

  181.      * object, it initializes the next component of the constructed data

  182.      * value associated with this <code>DynAny</code> object.

  183.      *

  184.      * @param value the <code>int</code> to insert into this

  185.      *              <code>DynAny</code> object

  186.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  187.      *            if the value inserted is not consistent with the type

  188.      *            of the accessed component in this <code>DynAny</code> object

  189.      */

  190.     public void insert_long(int value)

  191.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  192. 

  193.     /**

  194.      * Inserts the given <code>int</code> as the value for this

  195.      * <code>DynAny</code> object.

  196.      *

  197.      * <p> If this method is called on a constructed <code>DynAny</code>

  198.      * object, it initializes the next component of the constructed data

  199.      * value associated with this <code>DynAny</code> object.

  200.      *

  201.      * @param value the <code>int</code> to insert into this

  202.      *              <code>DynAny</code> object

  203.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  204.      *            if the value inserted is not consistent with the type

  205.      *            of the accessed component in this <code>DynAny</code> object

  206.      */

  207.     public void insert_ulong(int value)

  208.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  209. 

  210.     /**

  211.      * Inserts the given <code>float</code> as the value for this

  212.      * <code>DynAny</code> object.

  213.      *

  214.      * <p> If this method is called on a constructed <code>DynAny</code>

  215.      * object, it initializes the next component of the constructed data

  216.      * value associated with this <code>DynAny</code> object.

  217.      *

  218.      * @param value the <code>float</code> to insert into this

  219.      *              <code>DynAny</code> object

  220.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  221.      *            if the value inserted is not consistent with the type

  222.      *            of the accessed component in this <code>DynAny</code> object

  223.      */

  224.     public void insert_float(float value)

  225.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  226. 

  227.     /**

  228.      * Inserts the given <code>double</code> as the value for this

  229.      * <code>DynAny</code> object.

  230.      *

  231.      * <p> If this method is called on a constructed <code>DynAny</code>

  232.      * object, it initializes the next component of the constructed data

  233.      * value associated with this <code>DynAny</code> object.

  234.      *

  235.      * @param value the <code>double</code> to insert into this

  236.      *              <code>DynAny</code> object

  237.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  238.      *            if the value inserted is not consistent with the type

  239.      *            of the accessed component in this <code>DynAny</code> object

  240.      */

  241.     public void insert_double(double value)

  242.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  243. 

  244.     /**

  245.      * Inserts the given <code>String</code> object as the value for this

  246.      * <code>DynAny</code> object.

  247.      *

  248.      * <p> If this method is called on a constructed <code>DynAny</code>

  249.      * object, it initializes the next component of the constructed data

  250.      * value associated with this <code>DynAny</code> object.

  251.      *

  252.      * @param value the <code>String</code> to insert into this

  253.      *              <code>DynAny</code> object

  254.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  255.      *            if the value inserted is not consistent with the type

  256.      *            of the accessed component in this <code>DynAny</code> object

  257.      */

  258.     public void insert_string(String value)

  259.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  260. 

  261.     /**

  262.      * Inserts the given <code>org.omg.CORBA.Object</code> as the value for this

  263.      * <code>DynAny</code> object.

  264.      *

  265.      * <p> If this method is called on a constructed <code>DynAny</code>

  266.      * object, it initializes the next component of the constructed data

  267.      * value associated with this <code>DynAny</code> object.

  268.      *

  269.      * @param value the <code>org.omg.CORBA.Object</code> to insert into this

  270.      *              <code>DynAny</code> object

  271.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  272.      *            if the value inserted is not consistent with the type

  273.      *            of the accessed component in this <code>DynAny</code> object

  274.      */

  275.     public void insert_reference(org.omg.CORBA.Object value)

  276.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  277. 

  278.     /**

  279.      * Inserts the given <code>org.omg.CORBA.TypeCode</code> as the value for this

  280.      * <code>DynAny</code> object.

  281.      *

  282.      * <p> If this method is called on a constructed <code>DynAny</code>

  283.      * object, it initializes the next component of the constructed data

  284.      * value associated with this <code>DynAny</code> object.

  285.      *

  286.      * @param value the <code>org.omg.CORBA.TypeCode</code> to insert into this

  287.      *              <code>DynAny</code> object

  288.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  289.      *            if the value inserted is not consistent with the type

  290.      *            of the accessed component in this <code>DynAny</code> object

  291.      */

  292.     public void insert_typecode(org.omg.CORBA.TypeCode value)

  293.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  294. 

  295.     /**

  296.      * Inserts the given <code>long</code> as the value for this

  297.      * <code>DynAny</code> object.

  298.      *

  299.      * <p> If this method is called on a constructed <code>DynAny</code>

  300.      * object, it initializes the next component of the constructed data

  301.      * value associated with this <code>DynAny</code> object.

  302.      *

  303.      * @param value the <code>long</code> to insert into this

  304.      *              <code>DynAny</code> object

  305.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  306.      *            if the value inserted is not consistent with the type

  307.      *            of the accessed component in this <code>DynAny</code> object

  308.      */

  309.     public void insert_longlong(long value)

  310.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  311. 

  312.     /**

  313.      * Inserts the given <code>long</code> as the value for this

  314.      * <code>DynAny</code> object.

  315.      *

  316.      * <p> If this method is called on a constructed <code>DynAny</code>

  317.      * object, it initializes the next component of the constructed data

  318.      * value associated with this <code>DynAny</code> object.

  319.      *

  320.      * @param value the <code>long</code> to insert into this

  321.      *              <code>DynAny</code> object

  322.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  323.      *            if the value inserted is not consistent with the type

  324.      *            of the accessed component in this <code>DynAny</code> object

  325.      */

  326.     public void insert_ulonglong(long value)

  327.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  328. 

  329.     /**

  330.      * Inserts the given <code>char</code> as the value for this

  331.      * <code>DynAny</code> object.

  332.      *

  333.      * <p> If this method is called on a constructed <code>DynAny</code>

  334.      * object, it initializes the next component of the constructed data

  335.      * value associated with this <code>DynAny</code> object.

  336.      *

  337.      * @param value the <code>char</code> to insert into this

  338.      *              <code>DynAny</code> object

  339.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  340.      *            if the value inserted is not consistent with the type

  341.      *            of the accessed component in this <code>DynAny</code> object

  342.      */

  343.     public void insert_wchar(char value)

  344.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  345. 

  346.     /**

  347.      * Inserts the given <code>String</code> as the value for this

  348.      * <code>DynAny</code> object.

  349.      *

  350.      * <p> If this method is called on a constructed <code>DynAny</code>

  351.      * object, it initializes the next component of the constructed data

  352.      * value associated with this <code>DynAny</code> object.

  353.      *

  354.      * @param value the <code>String</code> to insert into this

  355.      *              <code>DynAny</code> object

  356.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  357.      *            if the value inserted is not consistent with the type

  358.      *            of the accessed component in this <code>DynAny</code> object

  359.      */

  360.     public void insert_wstring(String value)

  361.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  362. 

  363.     /**

  364.      * Inserts the given <code>org.omg.CORBA.Any</code> object as the value for this

  365.      * <code>DynAny</code> object.

  366.      *

  367.      * <p> If this method is called on a constructed <code>DynAny</code>

  368.      * object, it initializes the next component of the constructed data

  369.      * value associated with this <code>DynAny</code> object.

  370.      *

  371.      * @param value the <code>org.omg.CORBA.Any</code> object to insert into this

  372.      *              <code>DynAny</code> object

  373.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  374.      *            if the value inserted is not consistent with the type

  375.      *            of the accessed component in this <code>DynAny</code> object

  376.      */

  377.     public void insert_any(org.omg.CORBA.Any value)

  378.         throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  379. 

  380.     // orbos 98-01-18: Objects By Value -- begin

  381.     

  382.     /**

  383.      * Inserts the given <code>java.io.Serializable</code> object as the value for this

  384.      * <code>DynAny</code> object.

  385.      *

  386.      * <p> If this method is called on a constructed <code>DynAny</code>

  387.      * object, it initializes the next component of the constructed data

  388.      * value associated with this <code>DynAny</code> object.

  389.      *

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

  391.      *              <code>DynAny</code> object

  392.      * @throws org.omg.CORBA.DynAnyPackage.InvalidValue

  393.      *            if the value inserted is not consistent with the type

  394.      *            of the accessed component in this <code>DynAny</code> object

  395.      */

  396.     public void insert_val(java.io.Serializable value)

  397. 	throws org.omg.CORBA.DynAnyPackage.InvalidValue;

  398. 

  399.     /**

  400.      * Retrieves the <code>java.io.Serializable</code> object contained

  401.      * in this <code>DynAny</code> object.

  402.      *

  403.      * @return the <code>java.io.Serializable</code> object that is the 

  404.      *         value for this <code>DynAny</code> object

  405.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  406.      *               if the type code of the accessed component in this

  407.      *               <code>DynAny</code> object is not equivalent to

  408.      *               the type code for a <code>java.io.Serializable</code> object

  409.      */               

  410.     public java.io.Serializable get_val()

  411. 	throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  412.     

  413.     // orbos 98-01-18: Objects By Value -- end

  414. 

  415.     /**

  416.      * Retrieves the <code>boolean</code> contained

  417.      * in this <code>DynAny</code> object.

  418.      *

  419.      * @return the <code>boolean</code> that is the 

  420.      *         value for this <code>DynAny</code> object

  421.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  422.      *               if the type code of the accessed component in this

  423.      *               <code>DynAny</code> object is not equivalent to

  424.      *               the type code for a <code>boolean</code>

  425.      */               

  426.     public boolean get_boolean()

  427.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  428. 

  429. 

  430.     /**

  431.      * Retrieves the <code>byte</code> contained

  432.      * in this <code>DynAny</code> object.

  433.      *

  434.      * @return the <code>byte</code> that is the 

  435.      *         value for this <code>DynAny</code> object

  436.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  437.      *               if the type code of the accessed component in this

  438.      *               <code>DynAny</code> object is not equivalent to

  439.      *               the type code for a <code>byte</code>

  440.      */               

  441.     public byte get_octet()

  442.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  443. 

  444.     /**

  445.      * Retrieves the <code>char</code> contained

  446.      * in this <code>DynAny</code> object.

  447.      *

  448.      * @return the <code>char</code> that is the 

  449.      *         value for this <code>DynAny</code> object

  450.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  451.      *               if the type code of the accessed component in this

  452.      *               <code>DynAny</code> object is not equivalent to

  453.      *               the type code for a <code>char</code>

  454.      */               

  455.     public char get_char()

  456.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  457. 

  458. 

  459.     /**

  460.      * Retrieves the <code>short</code> contained

  461.      * in this <code>DynAny</code> object.

  462.      *

  463.      * @return the <code>short</code> that is the 

  464.      *         value for this <code>DynAny</code> object

  465.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  466.      *               if the type code of the accessed component in this

  467.      *               <code>DynAny</code> object is not equivalent to

  468.      *               the type code for a <code>short</code>

  469.      */               

  470.     public short get_short()

  471.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  472. 

  473. 

  474.     /**

  475.      * Retrieves the <code>short</code> contained

  476.      * in this <code>DynAny</code> object.

  477.      *

  478.      * @return the <code>short</code> that is the 

  479.      *         value for this <code>DynAny</code> object

  480.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  481.      *               if the type code of the accessed component in this

  482.      *               <code>DynAny</code> object is not equivalent to

  483.      *               the type code for a <code>short</code>

  484.      */               

  485.     public short get_ushort()

  486.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  487. 

  488. 

  489.     /**

  490.      * Retrieves the <code>int</code> contained

  491.      * in this <code>DynAny</code> object.

  492.      *

  493.      * @return the <code>int</code> that is the 

  494.      *         value for this <code>DynAny</code> object

  495.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  496.      *               if the type code of the accessed component in this

  497.      *               <code>DynAny</code> object is not equivalent to

  498.      *               the type code for a <code>int</code>

  499.      */               

  500.     public int get_long()

  501.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  502. 

  503. 

  504.     /**

  505.      * Retrieves the <code>int</code> contained

  506.      * in this <code>DynAny</code> object.

  507.      *

  508.      * @return the <code>int</code> that is the 

  509.      *         value for this <code>DynAny</code> object

  510.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  511.      *               if the type code of the accessed component in this

  512.      *               <code>DynAny</code> object is not equivalent to

  513.      *               the type code for a <code>int</code>

  514.      */               

  515.     public int get_ulong()

  516.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  517. 

  518. 

  519.     /**

  520.      * Retrieves the <code>float</code> contained

  521.      * in this <code>DynAny</code> object.

  522.      *

  523.      * @return the <code>float</code> that is the 

  524.      *         value for this <code>DynAny</code> object

  525.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  526.      *               if the type code of the accessed component in this

  527.      *               <code>DynAny</code> object is not equivalent to

  528.      *               the type code for a <code>float</code>

  529.      */               

  530.     public float get_float()

  531.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  532. 

  533. 

  534.     /**

  535.      * Retrieves the <code>double</code> contained

  536.      * in this <code>DynAny</code> object.

  537.      *

  538.      * @return the <code>double</code> that is the 

  539.      *         value for this <code>DynAny</code> object

  540.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  541.      *               if the type code of the accessed component in this

  542.      *               <code>DynAny</code> object is not equivalent to

  543.      *               the type code for a <code>double</code>

  544.      */               

  545.     public double get_double()

  546.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  547. 

  548. 

  549.     /**

  550.      * Retrieves the <code>String</code> contained

  551.      * in this <code>DynAny</code> object.

  552.      *

  553.      * @return the <code>String</code> that is the 

  554.      *         value for this <code>DynAny</code> object

  555.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  556.      *               if the type code of the accessed component in this

  557.      *               <code>DynAny</code> object is not equivalent to

  558.      *               the type code for a <code>String</code>

  559.      */               

  560.     public String get_string()

  561.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  562. 

  563. 

  564.     /**

  565.      * Retrieves the <code>org.omg.CORBA.Other</code> contained

  566.      * in this <code>DynAny</code> object.

  567.      *

  568.      * @return the <code>org.omg.CORBA.Other</code> that is the 

  569.      *         value for this <code>DynAny</code> object

  570.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  571.      *               if the type code of the accessed component in this

  572.      *               <code>DynAny</code> object is not equivalent to

  573.      *               the type code for an <code>org.omg.CORBA.Other</code>

  574.      */               

  575.     public org.omg.CORBA.Object get_reference()

  576.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  577. 

  578. 

  579.     /**

  580.      * Retrieves the <code>org.omg.CORBA.TypeCode</code> contained

  581.      * in this <code>DynAny</code> object.

  582.      *

  583.      * @return the <code>org.omg.CORBA.TypeCode</code> that is the 

  584.      *         value for this <code>DynAny</code> object

  585.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  586.      *               if the type code of the accessed component in this

  587.      *               <code>DynAny</code> object is not equivalent to

  588.      *               the type code for a <code>org.omg.CORBA.TypeCode</code>

  589.      */               

  590.     public org.omg.CORBA.TypeCode get_typecode()

  591.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  592. 

  593. 

  594.     /**

  595.      * Retrieves the <code>long</code> contained

  596.      * in this <code>DynAny</code> object.

  597.      *

  598.      * @return the <code>long</code> that is the 

  599.      *         value for this <code>DynAny</code> object

  600.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  601.      *               if the type code of the accessed component in this

  602.      *               <code>DynAny</code> object is not equivalent to

  603.      *               the type code for a <code>long</code>

  604.      */               

  605.     public long get_longlong()

  606.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  607. 

  608. 

  609.     /**

  610.      * Retrieves the <code>long</code> contained

  611.      * in this <code>DynAny</code> object.

  612.      *

  613.      * @return the <code>long</code> that is the 

  614.      *         value for this <code>DynAny</code> object

  615.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  616.      *               if the type code of the accessed component in this

  617.      *               <code>DynAny</code> object is not equivalent to

  618.      *               the type code for a <code>long</code>

  619.      */               

  620.     public long get_ulonglong()

  621.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  622. 

  623. 

  624.     /**

  625.      * Retrieves the <code>char</code> contained

  626.      * in this <code>DynAny</code> object.

  627.      *

  628.      * @return the <code>char</code> that is the 

  629.      *         value for this <code>DynAny</code> object

  630.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  631.      *               if the type code of the accessed component in this

  632.      *               <code>DynAny</code> object is not equivalent to

  633.      *               the type code for a <code>char</code>

  634.      */               

  635.     public char get_wchar()

  636.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  637. 

  638. 

  639.     /**

  640.      * Retrieves the <code>String</code> contained

  641.      * in this <code>DynAny</code> object.

  642.      *

  643.      * @return the <code>String</code> that is the 

  644.      *         value for this <code>DynAny</code> object

  645.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  646.      *               if the type code of the accessed component in this

  647.      *               <code>DynAny</code> object is not equivalent to

  648.      *               the type code for a <code>String</code>

  649.      */               

  650.     public String get_wstring()

  651.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  652. 

  653. 

  654.     /**

  655.      * Retrieves the <code>org.omg.CORBA.Any</code> contained

  656.      * in this <code>DynAny</code> object.

  657.      *

  658.      * @return the <code>org.omg.CORBA.Any</code> that is the 

  659.      *         value for this <code>DynAny</code> object

  660.      * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch

  661.      *               if the type code of the accessed component in this

  662.      *               <code>DynAny</code> object is not equivalent to

  663.      *               the type code for an <code>org.omg.CORBA.Any</code>

  664.      */               

  665.     public org.omg.CORBA.Any get_any()

  666.         throws org.omg.CORBA.DynAnyPackage.TypeMismatch;

  667. 

  668.     /**

  669.      * Returns a <code>DynAny</code> object reference that can

  670.      * be used to get/set the value of the component currently accessed.

  671.      * The appropriate <code>insert</code> method

  672.      * can be called on the resulting <code>DynAny</code> object

  673.      * to initialize the component.

  674.      * The appropriate <code>get</code> method

  675.      * can be called on the resulting <code>DynAny</code> object

  676.      * to extract the value of the component.

  677. 	 *

  678. 	 * @return a <code>DynAny</code> object reference that can be

  679. 	 *         used to retrieve or set the value of the component currently

  680. 	 *         accessed

  681.      */

  682.     public org.omg.CORBA.DynAny current_component() ;

  683. 

  684.     /**

  685.      * Moves to the next component of this <code>DynAny</code> object.

  686.      * This method is used for iterating through the components of

  687.      * a constructed type, effectively moving a pointer from one

  688.      * component to the next.  The pointer starts out on the first

  689.      * component when a <code>DynAny</code> object is created.

  690.      *

  691.      * @return <code>true</code> if the pointer points to a component;

  692.      * <code>false</code> if there are no more components or this

  693.      * <code>DynAny</code> is associated with a basic type rather than

  694.      * a constructed type

  695.      */ 

  696.     public boolean next() ;

  697. 

  698.     /**

  699.      * Moves the internal pointer to the given index. Logically, this method

  700.      * sets a new offset for this pointer.  

  701.      *

  702.      * @param index an <code>int</code> indicating the position to which

  703.      *              the pointer should move.  The first position is 0.

  704.      * @return <code>true</code> if the pointer points to a component;

  705.      * <code>false</code> if there is no component at the designated

  706.      * index.  If this <code>DynAny</code> object is associated with a

  707.      * basic type, this method returns <code>false</code> for any index

  708.      * other than 0.

  709.      */

  710.     public boolean seek(int index) ;

  711. 

  712.     /**

  713.      * Moves the internal pointer to the first component.

  714.      */

  715.     public void rewind() ;

  716. }