1. package org.omg.DynamicAny;
  2. /**
  3. * org/omg/DynamicAny/DynValueOperations.java .
  4. * Generated by the IDL-to-Java compiler (portable), version "3.1"
  5. * from ../../../../src/share/classes/org/omg/DynamicAny/DynamicAny.idl
  6. * Monday, February 23, 2004 7:03:09 AM GMT
  7. */
  8. /**
  9. * DynValue objects support the manipulation of IDL non-boxed value types.
  10. * The DynValue interface can represent both null and non-null value types.
  11. * For a DynValue representing a non-null value type, the DynValue's components comprise
  12. * the public and private members of the value type, including those inherited from concrete base value types,
  13. * in the order of definition. A DynValue representing a null value type has no components
  14. * and a current position of -1.
  15. * <P>Warning: Indiscriminantly changing the contents of private value type members can cause the value type
  16. * implementation to break by violating internal constraints. Access to private members is provided to support
  17. * such activities as ORB bridging and debugging and should not be used to arbitrarily violate
  18. * the encapsulation of the value type.
  19. */
  20. public interface DynValueOperations extends org.omg.DynamicAny.DynValueCommonOperations
  21. {
  22. /**
  23. * Returns the name of the member at the current position.
  24. * This operation may return an empty string since the TypeCode of the value being
  25. * manipulated may not contain the names of members.
  26. *
  27. * @exception TypeMismatch if the DynValue represents a null value type.
  28. * @exception InvalidValue if the current position does not indicate a member
  29. */
  30. String current_member_name () throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  31. /**
  32. * Returns the TCKind associated with the member at the current position.
  33. *
  34. * @exception TypeMismatch if the DynValue represents a null value type.
  35. * @exception InvalidValue if the current position does not indicate a member
  36. */
  37. org.omg.CORBA.TCKind current_member_kind () throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  38. /**
  39. * Returns a sequence of NameValuePairs describing the name and the value of each member
  40. * in the value type.
  41. * The sequence contains members in the same order as the declaration order of members
  42. * as indicated by the DynValue's TypeCode. The current position is not affected.
  43. * The member names in the returned sequence will be empty strings if the DynValue's TypeCode
  44. * does not contain member names.
  45. *
  46. * @exception InvalidValue if this object represents a null value type
  47. */
  48. org.omg.DynamicAny.NameValuePair[] get_members () throws org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  49. /**
  50. * Initializes the value type's members from a sequence of NameValuePairs.
  51. * The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
  52. * if an empty sequence is passed, the current position is set to -1.
  53. * A null value type can be initialized to a non-null value type using this method.
  54. * <P>Members must appear in the NameValuePairs in the order in which they appear in the IDL specification
  55. * of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
  56. * The operation makes no attempt to assign member values based on member names.
  57. *
  58. * @exception TypeMismatch if the member names supplied in the passed sequence do not match the
  59. * corresponding member name in the DynValue's TypeCode and they are not empty strings
  60. * @exception InvalidValue if the passed sequence has a number of elements that disagrees
  61. * with the number of members as indicated by the DynValue's TypeCode
  62. */
  63. void set_members (org.omg.DynamicAny.NameValuePair[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  64. /**
  65. * Returns a sequence of NameDynAnyPairs describing the name and the value of each member
  66. * in the value type.
  67. * The sequence contains members in the same order as the declaration order of members
  68. * as indicated by the DynValue's TypeCode. The current position is not affected.
  69. * The member names in the returned sequence will be empty strings if the DynValue's TypeCode
  70. * does not contain member names.
  71. *
  72. * @exception InvalidValue if this object represents a null value type
  73. */
  74. org.omg.DynamicAny.NameDynAnyPair[] get_members_as_dyn_any () throws org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  75. /**
  76. * Initializes the value type's members from a sequence of NameDynAnyPairs.
  77. * The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
  78. * if an empty sequence is passed, the current position is set to -1.
  79. * A null value type can be initialized to a non-null value type using this method.
  80. * <P>Members must appear in the NameDynAnyPairs in the order in which they appear in the IDL specification
  81. * of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
  82. * The operation makes no attempt to assign member values based on member names.
  83. *
  84. * @exception TypeMismatch if the member names supplied in the passed sequence do not match the
  85. * corresponding member name in the DynValue's TypeCode and they are not empty strings
  86. * @exception InvalidValue if the passed sequence has a number of elements that disagrees
  87. * with the number of members as indicated by the DynValue's TypeCode
  88. */
  89. void set_members_as_dyn_any (org.omg.DynamicAny.NameDynAnyPair[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;
  90. } // interface DynValueOperations