1 /* Object.java -- 2 Copyright (C) 2005 Free Software Foundation, Inc. 3 4 This file is part of GNU Classpath. 5 6 GNU Classpath is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 2, or (at your option) 9 any later version. 10 11 GNU Classpath is distributed in the hope that it will be useful, but 12 WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14 General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with GNU Classpath; see the file COPYING. If not, write to the 18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 19 02110-1301 USA. 20 21 Linking this library statically or dynamically with other modules is 22 making a combined work based on this library. Thus, the terms and 23 conditions of the GNU General Public License cover the whole 24 combination. 25 26 As a special exception, the copyright holders of this library give you 27 permission to link this library with independent modules to produce an 28 executable, regardless of the license terms of these independent 29 modules, and to copy and distribute the resulting executable under 30 terms of your choice, provided that you also meet, for each linked 31 independent module, the terms and conditions of the license of that 32 module. An independent module is a module which is not derived from 33 or based on this library. If you modify this library, you may extend 34 this exception to your version of the library, but you are not 35 obligated to do so. If you do not wish to do so, delete this 36 exception statement from your version. */ 37 38 39 package org.omg.CORBA; 40 41 /** 42 * The CORBA object reference. The object can be either local or remote. 43 * 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 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 */ _create_request(Context context, String operation, NVList parameters, NamedValue returns )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 */ _create_request(Context context, String operation, NVList parameters, NamedValue returns, ExceptionList exceptions, ContextList ctx_list )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 */ _duplicate()94 org.omg.CORBA.Object _duplicate(); 95 96 /** 97 * Retrieve the domain managers for this object. 98 * 99 * @return the domain managers. 100 */ _get_domain_managers()101 DomainManager[] _get_domain_managers(); 102 103 /** 104 * Get the <code>InterfaceDef</code> for this Object. 105 */ _get_interface_def()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 */ _get_policy(int a_policy_type)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 */ _hash(int maximum)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 */ _is_a(String repositoryIdentifer)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 */ _is_equivalent(org.omg.CORBA.Object other)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 */ _non_existent()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 */ _release()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 */ _request(String operation)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 */ _set_policy_override(Policy[] policies, SetOverrideType how)190 Object _set_policy_override(Policy[] policies, SetOverrideType how); 191 } 192