1 /* MARSHAL.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 import java.io.Serializable; 42 43 /** 44 * Means that some request or reply from the network has a wrong size or is 45 * structurally invalid. In GNU Classpath, this exception may have the following 46 * minor codes (the high 20 bits being Classpath VMCID): 47 * 48 * <table border="1"> 49 * <tr> 50 * <th>Hex</th> 51 * <th>Dec</th> 52 * <th>Minor</th> 53 * <th>Name</th> 54 * <th>Case</th> 55 * </tr> 56 * <tr> 57 * <td>47430001</td> 58 * <td>1195573249</td> 59 * <td>1</td> 60 * <td>Giop</td> 61 * <td>The message being received is not a GIOP message. It does not start from 62 * the expected magic sequence byte[] { 'G', 'I', 'O', 'P' }.</td> 63 * </tr> 64 * <tr> 65 * <td>47430002</td> 66 * <td>1195573250</td> 67 * <td>2</td> 68 * <td>Header</td> 69 * <td>The unexpected IOException while reading or writing the GIOP message 70 * header or the subsequent request or response header</td> 71 * </tr> 72 * <tr> 73 * <td>47430003</td> 74 * <td>1195573251</td> 75 * <td>3</td> 76 * <td>EOF</td> 77 * <td>The data stream ended before reading all expected values from it. This 78 * usually means that the CORBA message is corrupted, but may also indicate that 79 * the server expects the remote method being invoked to have more or different 80 * parameters</td> 81 * </tr> 82 * <tr> 83 * <td>47430005</td> 84 * <td>1195573253</td> 85 * <td>5</td> 86 * <td>CDR</td> 87 * <td>The unexpected IOException while reading or writing the data via Commond 88 * Data Representation stream</td> 89 * </tr> 90 * <tr> 91 * <td>47430006</td> 92 * <td>1195573254 </td> 93 * <td>6</td> 94 * <td>Value</td> 95 * <td>The unexpected IOException while reading or writing the Value type. 96 * </td> 97 * </tr> 98 * <tr> 99 * <td>47430007 </td> 100 * <td>1195573255</td> 101 * <td>7</td> 102 * <td>Forwarding</td> 103 * <td>The unexpected IOException while handling request forwarding.</td> 104 * </tr> 105 * <tr> 106 * <td>47430008</td> 107 * <td>1195573256</td> 108 * <td>8</td> 109 * <td>Encapsulation </td> 110 * <td>The unexpected IOException while handling data encapsulation, tagged 111 * components, tagged profiles, etc.</td> 112 * </tr> 113 * <tr> 114 * <td>47430009</td> 115 * <td>1195573257</td> 116 * <td>9 </td> 117 * <td>Any</td> 118 * <td>The unexpected IOException while inserting or extracting data to/from 119 * the Any.</td> 120 * </tr> 121 * <tr> 122 * <td>4743000a</td> 123 * <td>1195573258 </td> 124 * <td>10</td> 125 * <td>UserException</td> 126 * <td>The unexpected UserException in the context where it cannot be handled 127 * as such and must be converted to the SystemException. </td> 128 * </tr> 129 * <tr> 130 * <td>4743000b</td> 131 * <td>1195573259</td> 132 * <td>11</td> 133 * <td>Inappropriate</td> 134 * <td>While the operation could formally be applied to the target, the OMG 135 * standard states that it is actually not applicable. For example, some CORBA 136 * objects like POA are always local and should not be passed to or returned 137 * from the remote side.</td> 138 * </tr> 139 * <tr> 140 * <td>4743000c</td> 141 * <td>1195573260</td> 142 * <td>12</td> 143 * <td>Negative</td> 144 * <td>When reading data, it was discovered that size of the data structure 145 * like string, sequence or character is written as the negative number.</td> 146 * </tr> 147 * <tr> 148 * <td>4743000e</td> 149 * <td>1195573262 </td> 150 * <td>14</td> 151 * <td>Graph</td> 152 * <td>Reference to non-existing node in the data grapth while reading the 153 * value types.</td> 154 * </tr> 155 * <tr> 156 * <td>4743000f</td> 157 * <td>1195573263</td> 158 * <td>15</td> 159 * <td>Boxed</td> 160 * <td>Unexpected exception was thrown from the IDL type helper while handling 161 * the object of this type as a boxed value.</td> 162 * </tr> 163 * <tr> 164 * <td>47430010</td> 165 * <td>1195573264</td> 166 * <td>16</td> 167 * <td>Instantiation</td> 168 * <td>Unable to instantiate an value type object while reading it from the 169 * stream.</td> 170 * </tr> 171 * <tr> 172 * <td>47430011</td> 173 * <td>1195573265</td> 174 * <td>17</td> 175 * <td>ValueHeaderTag</td> 176 * <td>The header tag of the value type being read from the CDR stream contains 177 * an unexpected value outside 0x7fffff00 .. 0x7fffffff and also not null and 178 * not an indirection.</td> 179 * </tr> 180 * <tr> 181 * <td>47430012</td> 182 * <td>1195573266</td> 183 * <td>18</td> 184 * <td>ValueHeaderFlags</td> 185 * <td>The header tag flags of the value type being read from the CDR stream 186 * make the invalid combination (for instance, 0x7fffff04).</td> 187 * </tr> 188 * <tr> 189 * <td>47430013</td> 190 * <td>1195573267</td> 191 * <td>19</td> 192 * <td>ClassCast</td> 193 * <td>The value type class, written on the wire, is not compatible with the 194 * expected class, passed as a parameter to the InputStream.read_value.</td> 195 * </tr> 196 * <tr> 197 * <td>47430014</td> 198 * <td>1195573268</td> 199 * <td>20</td> 200 * <td>Offset</td> 201 * <td>Positive or otherwise invalid indirection offset when reading the data 202 * graph of the value type.</td> 203 * </tr> 204 * <tr> 205 * <td>47430015</td> 206 * <td>1195573269</td> 207 * <td>21</td> 208 * <td>Chunks</td> 209 * <td>Errors while reading the chunked value type.</td> 210 * </tr> 211 * <tr> 212 * <td>47430016</td> 213 * <td>1195573270</td> 214 * <td>22</td> 215 * <td>UnsupportedValue</td> 216 * <td>No means are provided to read or write this value type (not Streamable, 217 * not CustomMarshal, not Serializable, no factory, no helper.</td> 218 * </tr> 219 * <tr> 220 * <td>47430017</td> 221 * <td>1195573271</td> 222 * <td>23</td> 223 * <td>Factory</td> 224 * <td>The value factory, required for the operation being invoked, is not 225 * registered with this ORB.</td> 226 * </tr> 227 * <tr> 228 * <td>47430018</td> 229 * <td>1195573272</td> 230 * <td>24</td> 231 * 232 * <td>UnsupportedAddressing</td> 233 * <td>Unsupported object addressing method in GIOP request header.</td> 234 * </tr> 235 * <tr> 236 * <td>47430019</td> 237 * <td>1195573273</td> 238 * <td>25</td> 239 * <td>IOR</td> 240 * <td>Invalid object reference (IOR).</td> 241 * </tr> 242 * <tr> 243 * <td>4743001a</td> 244 * <td>1195573274</td> 245 * <td>26</td> 246 * <td>TargetConversion</td> 247 * <td>Problems with converting between stubs, ties, interfaces and 248 * implementations.</td> 249 * 250 * </tr> 251 * <tr> 252 * <td>4743001b</td> 253 * <td>1195573275</td> 254 * <td>27</td> 255 * <td>ValueFields</td> 256 * <td>Problems with reading or writing the fields of the value type object 257 * </td> 258 * </tr> 259 * <tr> 260 * <td>4743001c</td> 261 * <td>1195573276</td> 262 * <td>28</td> 263 * <td>NonSerializable</td> 264 * <td>The instance of the value type, passed using RMI over IIOP, is not 265 * serializable</td> 266 * </tr> 267 * </table> 268 * 269 * @author Audrius Meskauskas (AudriusA@Bioinformatics.org) 270 */ 271 public class MARSHAL 272 extends SystemException 273 implements Serializable 274 { 275 /** 276 * Use serialVersionUID for interoperability. 277 */ 278 private static final long serialVersionUID = 7416408250336395546L; 279 280 /** 281 * Creates a MARSHAL with the default minor code of 0, completion state 282 * COMPLETED_NO and the given explaining message. 283 * 284 * @param reasom the explaining message. 285 */ MARSHAL(String message)286 public MARSHAL(String message) 287 { 288 super(message, 0, CompletionStatus.COMPLETED_NO); 289 } 290 291 /** 292 * Creates MARSHAL with the default minor code of 0 and a completion state 293 * COMPLETED_NO. 294 */ MARSHAL()295 public MARSHAL() 296 { 297 super("", 0, CompletionStatus.COMPLETED_NO); 298 } 299 300 /** 301 * Creates a MARSHAL exception with the specified minor code and completion 302 * status. 303 * 304 * @param minor_code additional error code. 305 * @param is_completed the method completion status. 306 */ MARSHAL(int minor_code, CompletionStatus is_completed)307 public MARSHAL(int minor_code, CompletionStatus is_completed) 308 { 309 super("", minor_code, is_completed); 310 } 311 312 /** 313 * Created MARSHAL exception, providing full information. 314 * 315 * @param reason explaining message. 316 * @param minor_code additional error code (the "minor"). 317 * @param is_completed the method completion status. 318 */ MARSHAL(String reason, int minor_code, CompletionStatus is_completed)319 public MARSHAL(String reason, int minor_code, CompletionStatus is_completed) 320 { 321 super(reason, minor_code, is_completed); 322 } 323 } 324