/[classpath]/classpath/org/omg/CORBA/Object.java
ViewVC logotype

Diff of /classpath/org/omg/CORBA/Object.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.2 by mkoch, Wed Mar 9 09:56:54 2005 UTC revision 1.3 by audriusa, Sun May 15 01:09:29 2005 UTC
# Line 38  exception statement from your version. * Line 38  exception statement from your version. *
38    
39  package org.omg.CORBA;  package org.omg.CORBA;
40    
   
41  /**  /**
42   * FIXME   * The CORBA object reference. The object can be either local or remote.
43   * Not implemented, defined to keep the code compilable.   * For the local object, the methods of the derived object are called
44     * like on any other java object. For the remote object, the reference
45     * points to the stup (proxy), responsible for the remote invocation.
46     *
47     * @author Audrius Meskauskas (AudriusA@Bioinformatics.org)
48   */   */
49  public class Object  public interface Object
50  {  {
51      /**
52       * Create a request to invoke the method of this object.
53       *
54       * @param context a list of additional properties.
55       * @param operation the name of method to be invoked.
56       * @param parameters the method parameters.
57       * @param returns the container for tge method returned value.
58       *
59       * @return the created reaquest.
60       */
61      Request _create_request(Context context, String operation, NVList parameters,
62                              NamedValue returns
63                             );
64    
65      /**
66       * Create a request to invoke the method of this object, specifying
67       * context list and the list of the expected exception.
68       *
69       * @param context a list of additional properties.
70       * @param operation the name of method to be invoked.
71       * @param parameters the method parameters.
72       * @param returns the container for tge method returned value.
73       * @param exceptions the list of the possible exceptions that the method
74       * can throw.
75       * @param ctx_list the list of the context strings that need to be
76       * resolved and send as a context instance.
77       *
78       * @return the created reaquest.
79       */
80      Request _create_request(Context context, String operation, NVList parameters,
81                              NamedValue returns, ExceptionList exceptions,
82                              ContextList ctx_list
83                             );
84    
85      /**
86       * Duplicate the object reference. This does not make much sense for
87       * java platform and is just included for the sake of compliance with
88       * CORBA APIs.
89       *
90       * The method may return the object reference itself.
91       *
92       * @return as a rule, <code>this</code>.
93       */
94      org.omg.CORBA.Object _duplicate();
95    
96      /**
97       * Retrieve the domain managers for this object.
98       *
99       * @return the domain managers.
100       */
101      DomainManager[] _get_domain_managers();
102    
103      /**
104       * Get the <code>InterfaceDef</code> for this Object.
105       */
106      org.omg.CORBA.Object _get_interface_def();
107    
108      /**
109       * Returns the {@link Policy}, applying to this object.
110       *
111       * @param a_policy_type a type of policy to be obtained.
112       * @return a corresponding Policy object.
113       *
114       * @throws BAD_PARAM if the policy of the given type is not
115       * associated with this object, or if it is not supported by this ORB.
116       */
117      Policy _get_policy(int a_policy_type)
118                  throws BAD_PARAM;
119    
120      /**
121       * Get the hashcode this object reference. The same hashcode still
122       * does not means that the references are the same. From the other
123       * side, two different references may still refer to the same CORBA
124       * object. The returned value must not change during the object
125       * lifetime.
126       *
127       * @param maximum the maximal value to return.
128       *
129       * @return the hashcode.
130       */
131      int _hash(int maximum);
132    
133      /**
134       * Check if this object can be referenced by the given repository id.
135       *
136       * @param repositoryIdentifer the repository id.
137       *
138       * @return true if the passed parameter is a repository id of this
139       * CORBA object.
140       */
141      boolean _is_a(String repositoryIdentifer);
142    
143      /**
144       * Return true if the other object references are equivalent, so far as
145       * it is possible to determine this easily.
146       *
147       * @param other the other object reference.
148       *
149       * @return true if both references refer the same object, false
150       * if they probably can refer different objects.
151       */
152      boolean _is_equivalent(org.omg.CORBA.Object other);
153    
154      /**
155       * Determines if the server object for this reference has already
156       * been destroyed.
157       *
158       * @return true if the object has been destroyed, false otherwise.
159       */
160      boolean _non_existent();
161    
162      /**
163       * Free resoureces, occupied by this reference. The object implementation
164       * is not notified, and the other references to the same object are not
165       * affected.
166       */
167      void _release();
168    
169      /**
170       * Create a request to invoke the method of this CORBA object.
171       *
172       * @param operation the name of the method to invoke.
173       *
174       * @return the request.
175       */
176      Request _request(String operation);
177    
178      /**
179       * Returns a new object with the new policies either replacing or
180       * extending the current policies, depending on the second parameter.
181       *
182       * @param policies the policy additions or replacements.
183       *
184       * @param how either {@link SetOverrideType#SET_OVERRIDE} to override the
185       * current policies of {@link SetOverrideType#ADD_OVERRIDE} to replace
186       * them.
187       *
188       * @return the new reference with the changed policies.
189       */
190      Object _set_policy_override(Policy[] policies, SetOverrideType how);
191  }  }

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26