summaryrefslogtreecommitdiff
path: root/org/omg/CORBA/Object.java
diff options
context:
space:
mode:
Diffstat (limited to 'org/omg/CORBA/Object.java')
-rw-r--r--org/omg/CORBA/Object.java151
1 files changed, 147 insertions, 4 deletions
diff --git a/org/omg/CORBA/Object.java b/org/omg/CORBA/Object.java
index e50da51c0..2e73a9373 100644
--- a/org/omg/CORBA/Object.java
+++ b/org/omg/CORBA/Object.java
@@ -38,11 +38,154 @@ exception statement from your version. */
package org.omg.CORBA;
-
/**
- * FIXME
- * Not implemented, defined to keep the code compilable.
+ * The CORBA object reference. The object can be either local or remote.
+ * For the local object, the methods of the derived object are called
+ * like on any other java object. For the remote object, the reference
+ * points to the stup (proxy), responsible for the remote invocation.
+ *
+ * @author Audrius Meskauskas (AudriusA@Bioinformatics.org)
*/
-public class Object
+public interface Object
{
+ /**
+ * Create a request to invoke the method of this object.
+ *
+ * @param context a list of additional properties.
+ * @param operation the name of method to be invoked.
+ * @param parameters the method parameters.
+ * @param returns the container for tge method returned value.
+ *
+ * @return the created reaquest.
+ */
+ Request _create_request(Context context, String operation, NVList parameters,
+ NamedValue returns
+ );
+
+ /**
+ * Create a request to invoke the method of this object, specifying
+ * context list and the list of the expected exception.
+ *
+ * @param context a list of additional properties.
+ * @param operation the name of method to be invoked.
+ * @param parameters the method parameters.
+ * @param returns the container for tge method returned value.
+ * @param exceptions the list of the possible exceptions that the method
+ * can throw.
+ * @param ctx_list the list of the context strings that need to be
+ * resolved and send as a context instance.
+ *
+ * @return the created reaquest.
+ */
+ Request _create_request(Context context, String operation, NVList parameters,
+ NamedValue returns, ExceptionList exceptions,
+ ContextList ctx_list
+ );
+
+ /**
+ * Duplicate the object reference. This does not make much sense for
+ * java platform and is just included for the sake of compliance with
+ * CORBA APIs.
+ *
+ * The method may return the object reference itself.
+ *
+ * @return as a rule, <code>this</code>.
+ */
+ org.omg.CORBA.Object _duplicate();
+
+ /**
+ * Retrieve the domain managers for this object.
+ *
+ * @return the domain managers.
+ */
+ DomainManager[] _get_domain_managers();
+
+ /**
+ * Get the <code>InterfaceDef</code> for this Object.
+ */
+ org.omg.CORBA.Object _get_interface_def();
+
+ /**
+ * Returns the {@link Policy}, applying to this object.
+ *
+ * @param a_policy_type a type of policy to be obtained.
+ * @return a corresponding Policy object.
+ *
+ * @throws BAD_PARAM if the policy of the given type is not
+ * associated with this object, or if it is not supported by this ORB.
+ */
+ Policy _get_policy(int a_policy_type)
+ throws BAD_PARAM;
+
+ /**
+ * Get the hashcode this object reference. The same hashcode still
+ * does not means that the references are the same. From the other
+ * side, two different references may still refer to the same CORBA
+ * object. The returned value must not change during the object
+ * lifetime.
+ *
+ * @param maximum the maximal value to return.
+ *
+ * @return the hashcode.
+ */
+ int _hash(int maximum);
+
+ /**
+ * Check if this object can be referenced by the given repository id.
+ *
+ * @param repositoryIdentifer the repository id.
+ *
+ * @return true if the passed parameter is a repository id of this
+ * CORBA object.
+ */
+ boolean _is_a(String repositoryIdentifer);
+
+ /**
+ * Return true if the other object references are equivalent, so far as
+ * it is possible to determine this easily.
+ *
+ * @param other the other object reference.
+ *
+ * @return true if both references refer the same object, false
+ * if they probably can refer different objects.
+ */
+ boolean _is_equivalent(org.omg.CORBA.Object other);
+
+ /**
+ * Determines if the server object for this reference has already
+ * been destroyed.
+ *
+ * @return true if the object has been destroyed, false otherwise.
+ */
+ boolean _non_existent();
+
+ /**
+ * Free resoureces, occupied by this reference. The object implementation
+ * is not notified, and the other references to the same object are not
+ * affected.
+ */
+ void _release();
+
+ /**
+ * Create a request to invoke the method of this CORBA object.
+ *
+ * @param operation the name of the method to invoke.
+ *
+ * @return the request.
+ */
+ Request _request(String operation);
+
+ /**
+ * Returns a new object with the new policies either replacing or
+ * extending the current policies, depending on the second parameter.
+ *
+ * @param policies the policy additions or replacements.
+ *
+ * @param how either {@link SetOverrideType#SET_OVERRIDE} to override the
+ * current policies of {@link SetOverrideType#ADD_OVERRIDE} to replace
+ * them.
+ *
+ * @return the new reference with the changed policies.
+ */
+ Object _set_policy_override(Policy[] policies, SetOverrideType how);
}