1. /*

  2.  * @(#)IRObjectOperations.java	1.7 00/02/02

  3.  *

  4.  * Copyright 1999, 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. package org.omg.CORBA;

  11. 

  12. 

  13. /*

  14.  tempout/org/omg/CORBA/IRObjectOperations.java

  15.  Generated by the IBM IDL-to-Java compiler, version 1.0

  16.  from ../../Lib/ir.idl

  17.  Thursday, February 25, 1999 2:11:21 o'clock PM PST

  18. */

  19. 

  20. /**

  21.  * This is the Operations interface for the mapping from IRObject.

  22.  * Several interfaces are used as base interfaces for objects in 

  23.  * the Interface Repository (IR). These base interfaces are not instantiable.

  24.  * A common set of operations is used to locate objects within the 

  25.  * Interface Repository. Some of these operations are defined in 

  26.  * the IRObject. All IR objects inherit from the IRObject interface, 

  27.  * which provides an operation for identifying the actual type of 

  28.  * the object. (The IDL base interface IRObject represents the most 

  29.  * generic interface from which all other Interface Repository interfaces 

  30.  * are derived, even the Repository itself.) All java implementations of 

  31.  * IR objects must implement the IRObjectOperations interface.

  32.  * @see IDLTypeOperations

  33.  * @see IDLType

  34.  * @see IRObject

  35.  */

  36. public interface IRObjectOperations 

  37. {

  38. 

  39.     // read interface

  40.     /**

  41.      * Returns the <code>DefinitionKind</code> corresponding to this Interface Repository object.

  42.      * @return the <code>DefinitionKind</code> corresponding to this Interface Repository object.

  43.      */

  44.     org.omg.CORBA.DefinitionKind def_kind ();

  45. 

  46.     // write interface

  47.     /**

  48.      * Destroys this object. If the object is a Container,

  49.      * this method is applied to all its contents. If the object contains an IDLType

  50.      * attribute for an anonymous type, that IDLType is destroyed.

  51.      * If the object is currently contained in some other object, it is removed.

  52.      * If the method is invoked on a <code>Repository</code> or on a <code>PrimitiveDef</code>

  53.      * then the <code>BAD_INV_ORDER</code> exception is raised with minor value 2.

  54.      * An attempt to destroy an object that would leave the repository in an

  55.      * incoherent state causes <code>BAD_INV_ORDER</code> exception to be raised

  56.      * with the minor code 1.

  57.      * @exception <code>BAD_INV_ORDER</code>

  58.      */

  59.     void destroy ();

  60. } // interface IRObjectOperations