// Copyright (c) 09/29/98, by Sun Microsystems, Inc. // All rights reserved. // "@(#)AdaptorServer.idl 3.1 98/09/29 SMI" // ___________________________________________________________________ // // JAVA PACKAGE // // ___________________________________________________________________ #pragma javaPackage "com.sun.jaw.impl.adaptor.iiop.internal" // ___________________________________________________________________ // // MODULE DEFINITION // // ___________________________________________________________________ module CorbaServer { // --------------------------------------------------------------- // typedef declaration // --------------------------------------------------------------- // // String list // typedef sequence <string> StringListType; // // object serialization // typedef sequence <octet> SerializedObjectType ; // // serialized object list // typedef sequence <SerializedObjectType> SerializedObjectListType ; // --------------------------------------------------------------- // Exception declaration // --------------------------------------------------------------- exception JdmkServerRuntimeException { SerializedObjectType JavaObjectException ; } ; exception JdmkIllegalAccessException { string JavaStringException ; } ; exception JdmkInstantiationException { string JavaStringException ; } ; exception JdmkClassNotFoundException { string JavaStringException ; } ; exception JdmkServiceNotFoundException { string JavaStringException ; } ; exception JdmkInstanceAlreadyExistException { string JavaStringException ; } ; exception JdmkInstanceNotFoundException { string JavaStringException ; } ; exception JdmkInvalidSerializedListException { string JavaStringException ; } ; exception JdmkPropertyNotFoundException { string JavaStringException ; } ; exception JdmkInvocationTargetException { SerializedObjectType JavaObjectException ; string JavaStringException ; } ; exception JdmkInvalidPropertyValueException { string JavaStringException ; } ; exception JdmkNoSuchMethodException { string JavaStringException ; } ; exception JdmkCommunicationException { string JavaStringException ; } ; // =================================================================== // // INTERFACE DEFINITION // // =================================================================== interface EvtRcvClient { void handleEvent( in SerializedObjectType event, in string source, in string method, in string listener) raises ( JdmkInvalidSerializedListException, JdmkCommunicationException ); } ; interface AdaptorIIOP { // ---------------------------\chapter{Die CORBA - Schnittstelle} \label{IDL-Anhang} \section{AdaptorServer.idl} \begin{verbatim} // Copyright (c) 09/29/98, by Sun Microsystems, Inc. // All rights reserved. // "@(#)AdaptorServer.idl 3.1 98/09/29 SMI" // ___________________________________________________________________ // // JAVA PACKAGE // // ___________________________________________________________________ #pragma javaPackage "com.sun.jaw.impl.adaptor.iiop.internal" // ___________________________________________________________________ // // MODULE DEFINITION // // ___________________________________________________________________ module CorbaServer { // --------------------------------------------------------------- // typedef declaration // --------------------------------------------------------------- // // String list // typedef sequence <string> StringListType; // // object serialization // typedef sequence <octet> SerializedObjectType ; // // serialized object list // typedef sequence <SerializedObjectType> SerializedObjectListType ; // --------------------------------------------------------------- // Exception declaration // --------------------------------------------------------------- exception JdmkServerRuntimeException { SerializedObjectType JavaObjectException ; } ; exception JdmkIllegalAccessException { string JavaStringException ; } ; exception JdmkInstantiationException { string JavaStringException ; } ; exception JdmkClassNotFoundException { string JavaStringException ; } ; exception JdmkServiceNotFoundException { string JavaStringException ; } ; exception JdmkInstanceAlreadyExistException { string JavaStringException ; } ; exception JdmkInstanceNotFoundException { string JavaStringException ; } ; exception JdmkInvalidSerializedListException { string JavaStringException ; } ; exception JdmkPropertyNotFoundException { string JavaStringException ; } ; exception JdmkInvocationTargetException { SerializedObjectType JavaObjectException ; string JavaStringException ; } ; exception JdmkInvalidPropertyValueException { string JavaStringException ; } ; exception JdmkNoSuchMethodException { string JavaStringException ; } ; exception JdmkCommunicationException { string JavaStringException ; } ; // =================================================================== // // INTERFACE DEFINITION // // =================================================================== interface EvtRcvClient { void handleEvent( in SerializedObjectType event, in string source, in string method, in string listener) raises ( JdmkInvalidSerializedListException, JdmkCommunicationException ); } ; interface AdaptorIIOP { // --------------------------------------------------------------- // DESCRIPTION // Gets handles on managed objects controlled by the remote // managed object // server. The method enables any of the following be to obtained: // - All the managed objects // - A subset specified through a query // - A specific instance // When the class name and the instance name are empty, it means // that all the // objects are to be selected (and filered if a query is specified). // // PARAMETERS // - name: The instance name of the object to be retrieved. // - query: The query to be applied for selecting managed objects. // It's a serialized java object. // Its class is com.sun.jaw.reference.query.QueryExp // // RETURN // A list containing the selected managed objects. // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkServiceNotFoundException // - JdmkInvalidSerializedListException // // For more information, see 'getObject' in 'Interface // com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- StringListType getObject( in string name, in SerializedObjectType query) raises ( JdmkInstanceNotFoundException, JdmkServiceNotFoundException, JdmkServerRuntimeException, JdmkInvalidSerializedListException); // --------------------------------------------------------------- // DESCRIPTION // Allows the value of a specific property within a managed object // to be obtained. // // PARAMETERS // - name: The names of the managed objects from within which // the property // is to be retrieved. // - property: The name of the property to be retrieved. // // RETURN // The value of the retrieved property. // It's a serialized java object. // Its class is java.lang.Object // // EXCEPTIONS // - InstanceNotFoundException, // - JdmkPropertyNotFoundException, // - JdmkServiceNotFoundException, // - JdmkInvocationTargetException, // - JdmkInvalidSerializedListException // // For more information, see 'getValue' in //'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType getValue( in string name, in string property) raises ( JdmkInstanceNotFoundException, JdmkPropertyNotFoundException, JdmkServiceNotFoundException, JdmkInvocationTargetException, JdmkServerRuntimeException, JdmkInvalidSerializedListException ); // --------------------------------------------------------------- // DESCRIPTION // Allows the value of a specific indexed property within a managed // object to be obtained. // // PARAMETERS // - name: The names of the objects from within which the property is // to be retrieved. // - property: The name of the property to be retrieved. // - pos: The position in the index of the value to be retrieved. // // RETURN // The value of the retrieved property. // It's a serialized java object. // Its class is java.lang.Object // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkPropertyNotFoundException // - JdmkServiceNotFoundException // - JdmkInvocationTargetException // - JdmkInvalidSerializedListException // // For more information, see 'getIndexedValue' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType getIndexedValue( in string name, in string property, in long pos) raises ( JdmkInstanceNotFoundException, JdmkPropertyNotFoundException, JdmkServiceNotFoundException, JdmkInvocationTargetException, JdmkServerRuntimeException, JdmkInvalidSerializedListException); // --------------------------------------------------------------- // DESCRIPTION // Allows the values of several properties within a managed object // to be obtained. // // PARAMETERS // - name: The names of the objects from within which the properties // are to be retrieved. // - propertyIdList: A list of the properties to be retrieved. // // RETURN // The values of the retrieved properties. // It's a serialized java object. // Its class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkServiceNotFoundException // - JdmkInvalidSerializedListException // // For more information, see 'getValues' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType getValues( in string name, in SerializedObjectListType propertyIdList) raises ( JdmkInstanceNotFoundException, JdmkServiceNotFoundException, JdmkServerRuntimeException, JdmkInvalidSerializedListException ); // --------------------------------------------------------------- // DESCRIPTION // Sets the value of a specific property of a managed object. // The value must support the Serializable interface. // // PARAMETERS // - name: The name of the m-bean within which the // property is to be set. // - id: The name of the property to be set. // - value: The value that the property is to be set to. // It's a serialized java object. // It's class is java.lang.Object // - op: The Java class name of the operator to be applied // to the property. // The class must implement the OperatorSrvIf interface. // // RETURN // The value that the property has been set to. // It's a serialized java object. // It's class is java.lang.Object // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkInvocationTargetException // - JdmkIllegalAccessException // - JdmkServiceNotFoundException // - JdmkPropertyNotFoundException // - JdmkInvalidPropertyValueException // - JdmkClassNotFoundException // - JdmkInstantiationException // - JdmkInvalidSerializedListException // // For more information, see 'SetValue' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType SetValue( in string name, in string id, in SerializedObjectType value, in string op) raises ( JdmkInstanceNotFoundException, JdmkInvocationTargetException, JdmkIllegalAccessException, JdmkServiceNotFoundException, JdmkPropertyNotFoundException, JdmkInvalidPropertyValueException, JdmkClassNotFoundException, JdmkInstantiationException , JdmkServerRuntimeException, JdmkInvalidSerializedListException); // --------------------------------------------------------------- // DESCRIPTION // Sets the value of a specific indexed property of a managed object. // The value must support the Serializable interface. // // PARAMETERS // - name: The name of the m-bean within which the // property is to be set. // - id: The name of the property to be set. // - value: The value that the property is to be set to. // It's a serialized java object. // It's class is java.lang.Object // - op: The Java class name of the operator to be applied // to the property. // The class must implement the OperatorSrvIf interface. // - pos: The position in the index of the value to be set. // // RETURN // The value that the property has been set to. // It's a serialized java object. // It's class is java.lang.Object // // EXCEPTIONS // - InstanceNotFoundException // - JdmkInvocationTargetException // - JdmkIllegalAccessException // - JdmkServiceNotFoundException // - JdmkPropertyNotFoundException // - JdmkInvalidPropertyValueException // - JdmkClassNotFoundException // - JdmkInstantiationException // - JdmkInvalidSerializedListException // // For more information, see 'setIndexedValue' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType SetIndexedValue( in string name, in string id, in SerializedObjectType value, in string op, in long pos) raises ( JdmkInstanceNotFoundException, JdmkInvocationTargetException, JdmkIllegalAccessException, JdmkServiceNotFoundException, JdmkPropertyNotFoundException, JdmkInvalidPropertyValueException, JdmkClassNotFoundException, JdmkInstantiationException, JdmkServerRuntimeException, JdmkInvalidSerializedListException) ; // --------------------------------------------------------------- // DESCRIPTION // Sets the value of several properties within a managed object. // The value must support the Serializable interface. // // PARAMETERS // - name: The name of the object within which the properties are to be set. // - modif: A list of the properties to be set and the values to which they are to be set. // It's a serialized java object. // It's class is com.sun.jaw.reference.common.ModificationList // // RETURN // The values of the properties that were set. // It's a serialized java object. // It's class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkServiceNotFoundException // - JdmkInvalidSerializedListException // // For more information, see 'setValues' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType setValues( in string name, in SerializedObjectType modif) raises ( JdmkInstanceNotFoundException, JdmkServiceNotFoundException, JdmkServerRuntimeException, JdmkInvalidSerializedListException); // --------------------------------------------------------------- // DESCRIPTION // Returns the name of the domain controlled // by the managed object server. // // PARAMETERS // No parameter // // RETURN // Returns the name of the domain controlled // by the managed object server // // EXCEPTIONS // No exception // // For more information, see 'getDomain' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string getDomain() raises ( JdmkServerRuntimeException); // --------------------------------------------------------------- // DESCRIPTION // Allows a Java object of a particular class to be instantiated in a // remote managed object server. // // PARAMETERS // - className: The Java class name of the object to be created. // // RETURN // No return parameter // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkInstantiationException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // - JdmkInvocationTargetException // // For more information, see 'newObj' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- void newObj ( in string className) raises ( JdmkIllegalAccessException, JdmkInstantiationException, JdmkClassNotFoundException, JdmkInvocationTargetException, JdmkServerRuntimeException, JdmkServiceNotFoundException) ; // --------------------------------------------------------------- // DESCRIPTION // Creates a persistent instance of a managed // object in the remote object // server. When calling the method, you can optionally // provide the class name of // the Java implementation to be used for instantiating // the new object. // // PARAMETERS // - impl: The name of the Java implementation to be // used on the server. // - name: The name of the managed object to be created. // - plist: The list of initial values of the properties of the // new managed object. // It's a serialized java object. // It's class com.sun.jaw.reference.common.ModificationList // // RETURN // The newly created managed object. // It's an Object name and a serialized java object. // It's class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // - JdmkInstanceAlreadyExistException // - JdmkInstantiationException // - JdmkInvocationTargetException // - JdmkInvalidSerializedListException // // For more information, see 'newDBMO' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string newDBMO( in string impl, in string name, in SerializedObjectType plist ) raises ( JdmkIllegalAccessException, JdmkClassNotFoundException, JdmkServiceNotFoundException, JdmkInstanceAlreadyExistException, JdmkInstantiationException, JdmkInvocationTargetException, JdmkServerRuntimeException, JdmkInvalidSerializedListException ) ; // --------------------------------------------------------------- // DESCRIPTION // Creates an instance of a managed object in the remote // object server. // When calling the method, you can optionally provide // the class name of // the Java implementation to be used for instantiating // the new object. // // PARAMETERS // - impl: The name of the Java implementation to be // used on the server. // - name: The name of the managed object to be created. // - plist: The list of initial values of the properties of the // new managed object. // It's a serialized java object. // It's class is com.sun.jaw.reference.common.ModificationList // // RETURN // The newly created managed object. It's an Object // name and a serialized java object. // It's class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // - JdmkInstanceAlreadyExistException // - JdmkInstantiationException // - JdmkInvocationTargetException // - JdmkInvalidSerializedListException // // For more information, see 'newMO' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string newMO( in string impl, in string name, in SerializedObjectType plist ) raises ( JdmkIllegalAccessException, JdmkClassNotFoundException, JdmkServiceNotFoundException, JdmkInstanceAlreadyExistException, JdmkInstantiationException, JdmkInvocationTargetException, JdmkServerRuntimeException, JdmkInvalidSerializedListException) ; // --------------------------------------------------------------- // DESCRIPTION // Allows a Java object of a particular class to be instantiated in a // remote managed object server. // // PARAMETERS // - className: The Java class name of the object to be created. // - aLoader: The name of a class loader to be used. // // RETURN // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkInstantiationException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // // For more information, see 'newObj' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- void newNamedObj( in string className, in string aLoader) raises ( JdmkIllegalAccessException, JdmkInstantiationException, JdmkClassNotFoundException, JdmkServerRuntimeException, JdmkServiceNotFoundException) ; // --------------------------------------------------------------- // DESCRIPTION // Creates an instance of a managed object in the remote // object server. // When calling the method, you can optionally provide // the class name of // the Java implementation to be used for instantiating // the new object. // // PARAMETERS // - impl: The name of the Java implementation to be used // on the server. // - name: The name of the managed object to be created. // - plist: The list of initial values of the properties of the // new managed object. // It's a serialized java object. // It's class com.sun.jaw.reference.common.ModificationList // - aLoader: The name of a class loader to be used. // // RETURN // The newly created managed object. It's an Object name // and a serialized java object. // It's class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // - JdmkInstanceAlreadyExistException // - JdmkInstantiationException // - JdmkInvocationTargetException // - JdmkInvalidSerializedListException // // For more information, see 'newMO' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string newMOAndLoader( in string impl, in string name, in SerializedObjectType plist, in string aLoader) raises ( JdmkIllegalAccessException, JdmkClassNotFoundException , JdmkServiceNotFoundException , JdmkInstanceAlreadyExistException , JdmkInstantiationException , JdmkInvocationTargetException , JdmkServerRuntimeException, JdmkInvalidSerializedListException) ; // --------------------------------------------------------------- // DESCRIPTION // Creates a persistent instance of a managed object in the // remote object // server. When calling the method, you can optionally // provide the class // name of the Java implementation to be used for instantiating // the new // object. // // PARAMETERS // - impl: The name of the Java implementation to be used // on the server. // - name: The name of the managed object to be created. // - plist: The list of initial values of the properties of the // new managed object. // It's a serialized java object. // It's class com.sun.jaw.reference.common.ModificationList // - aLoader: The name of a class loader to be used. // // RETURN // The newly created managed object. It's an Object name // and a serialized java object. // It's class is com.sun.jaw.reference.common.PropertyList // // EXCEPTIONS // - JdmkIllegalAccessException // - JdmkClassNotFoundException // - JdmkServiceNotFoundException // - JdmkInstanceAlreadyExistException // - JdmkInstantiationException // - JdmkInvocationTargetException // - JdmkInvalidSerializedListException // // For more information, see 'newDBMO' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string newDBMOAndLoader( in string impl, in string name, in SerializedObjectType plist, in string aLoader) raises ( JdmkIllegalAccessException , JdmkClassNotFoundException , JdmkServiceNotFoundException , JdmkInstanceAlreadyExistException , JdmkInstantiationException , JdmkInvocationTargetException , JdmkServerRuntimeException, JdmkInvalidSerializedListException) ; // --------------------------------------------------------------- // DESCRIPTION // Adds a named object under the control of the remote CMF. // Use this method with care, because it moves an instance // remotely. All methods of this instance are executed locally on // the remote agent. // // PARAMETERS // - object: The object to be added to the remote repository. // It's a serialized java object. // It's class is java.lang.Object // - logicalName: The logical name of the object. // // RETURN // // EXCEPTIONS // - JdmkServiceNotFoundException // - JdmkInstanceAlreadyExistException // - JdmkInvalidSerializedListException // // For more information, see 'addObject' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- void addObject( in SerializedObjectType object, in string logicalName) raises ( JdmkServiceNotFoundException, JdmkInstanceAlreadyExistException, JdmkServerRuntimeException, JdmkInvalidSerializedListException ); // --------------------------------------------------------------- // DESCRIPTION // Deletes an instance of a managed object in the remote object server. // // PARAMETERS // - name: The name of the managed object to be deleted. // // RETURN // // EXCEPTIONS // - JdmkInvocationTargetException // - JdmkServiceNotFoundException // - JdmkInstanceNotFoundException // // For more information, see 'deleteMO' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- void deleteMO( in string name) raises ( JdmkInvocationTargetException, JdmkServiceNotFoundException, JdmkServerRuntimeException, JdmkInstanceNotFoundException ); // --------------------------------------------------------------- // DESCRIPTION // Allows a listener for a managed object to be added. // Transparently to // the caller, the adaptor creates and registers a listener // for the object // within the managed object server. The managed object // to be listened to // is specified by the <VAR>mo</VAR> parameter. // When the remote object fires an event by calling a method /// of the remote listener, the corresponding method in the // local listener // is called. // // PARAMETERS // mo: The managed object to be listened to. // listen: The listener to be created in the agent. // receiver: The name of the receiver to be called for // forwarding the event. // // RETURN // A reference to the created listener. // // EXCEPTIONS // - JdmkInstanceNotFoundException // - JdmkIllegalAccessException // - JdmkServiceNotFoundException // - JdmkClassNotFoundException // - JdmkInstantiationException // // --------------------------------------------------------------- string addListener( in string mo, in string listen, in string receiver) raises ( JdmkInstanceNotFoundException, JdmkIllegalAccessException, JdmkServiceNotFoundException, JdmkClassNotFoundException, JdmkServerRuntimeException, JdmkInstantiationException ); // --------------------------------------------------------------- // DESCRIPTION // Allows a listener for a managed object to be removed. // // PARAMETERS // ref: A reference of the listener to be removed. // // RETURN // No return parameter // // EXCEPTIONS // No exception // // --------------------------------------------------------------- void removeListener(in string ref) raises ( JdmkServerRuntimeException) ; // --------------------------------------------------------------- // DESCRIPTION // Allows any method to be applied to a remote object. // // PARAMETERS // - objName: The name of the remote object. // - pfName: The name of the method to be applied. // - params: An array containing the parameters to be // passed to the method. // It's a serialized java object // It's class is java.lang.Object // - signature: The signature of the method to be called. // // RETURN // The value of the method applied. // It's a serialized java object. // It's class is java.lang.Object // // EXCEPTIONS // - Jdmk InstanceNotFoundException, // - JdmkInvocationTargetException, // - JdmkServiceNotFoundException, // - JdmkNoSuchMethodException, // - JdmkIllegalAccessException // - JdmkInvalidSerializedListException // // For more information, see 'invokePerform' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- SerializedObjectType invokePerform( in string name, in string pfName, in SerializedObjectListType params, in StringListType signature) raises ( JdmkInstanceNotFoundException, JdmkInvocationTargetException, JdmkServiceNotFoundException, JdmkNoSuchMethodException, JdmkIllegalAccessException, JdmkServerRuntimeException, JdmkInvalidSerializedListException); // --------------------------------------------------------------- // DESCRIPTION // Returns the version of this class. // // PARAMETERS // None // // RETURN // Returns the version of this class. // // For more information, see 'getClassVersion' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string getClassVersion() ; // --------------------------------------------------------------- // DESCRIPTION // Returns the service name of this IIOP object // // PARAMETERS // None // // RETURN // Returns the service name of this IIOP object // // For more information, see 'getServiceName' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string getServiceName() ; // --------------------------------------------------------------- // DESCRIPTION // Returns the name of the protocol (iiop) // // PARAMETERS // None // // RETURN // Returns the name of the protocol (iiop) // // For more information, see 'getProtocol' in // 'Interface com.sun.jaw.impl.adaptor.rmi.AdaptorServer' // // --------------------------------------------------------------- string getProtocol() ; } ; // END OF interface AdaptorIIOP } ; // END OF module CorbaServer