Thu, 17 Jun 2010 16:27:56 -0700
Added tag jdk7-b98 for changeset 3b99409057e4
duke@1 | 1 | /* |
ohair@158 | 2 | * Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved. |
duke@1 | 3 | * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
duke@1 | 4 | * |
duke@1 | 5 | * This code is free software; you can redistribute it and/or modify it |
duke@1 | 6 | * under the terms of the GNU General Public License version 2 only, as |
ohair@158 | 7 | * published by the Free Software Foundation. Oracle designates this |
duke@1 | 8 | * particular file as subject to the "Classpath" exception as provided |
ohair@158 | 9 | * by Oracle in the LICENSE file that accompanied this code. |
duke@1 | 10 | * |
duke@1 | 11 | * This code is distributed in the hope that it will be useful, but WITHOUT |
duke@1 | 12 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
duke@1 | 13 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
duke@1 | 14 | * version 2 for more details (a copy is included in the LICENSE file that |
duke@1 | 15 | * accompanied this code). |
duke@1 | 16 | * |
duke@1 | 17 | * You should have received a copy of the GNU General Public License version |
duke@1 | 18 | * 2 along with this work; if not, write to the Free Software Foundation, |
duke@1 | 19 | * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
duke@1 | 20 | * |
ohair@158 | 21 | * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
ohair@158 | 22 | * or visit www.oracle.com if you need additional information or have any |
ohair@158 | 23 | * questions. |
duke@1 | 24 | */ |
duke@1 | 25 | /* |
duke@1 | 26 | * Licensed Materials - Property of IBM |
duke@1 | 27 | * RMI-IIOP v1.0 |
duke@1 | 28 | * Copyright IBM Corp. 1998 1999 All Rights Reserved |
duke@1 | 29 | * |
duke@1 | 30 | */ |
duke@1 | 31 | |
duke@1 | 32 | package javax.rmi.CORBA; |
duke@1 | 33 | |
duke@1 | 34 | /** |
duke@1 | 35 | * Defines methods which allow serialization of Java objects |
duke@1 | 36 | * to and from GIOP streams. |
duke@1 | 37 | **/ |
duke@1 | 38 | public interface ValueHandler { |
duke@1 | 39 | |
duke@1 | 40 | /** |
duke@1 | 41 | * Writes a value to the stream using Java semantics. |
duke@1 | 42 | * @param out the stream to write the value to. |
duke@1 | 43 | * @param value the value to be written to the stream. |
duke@1 | 44 | **/ |
duke@1 | 45 | void writeValue(org.omg.CORBA.portable.OutputStream out, |
duke@1 | 46 | java.io.Serializable value); |
duke@1 | 47 | |
duke@1 | 48 | /** |
duke@1 | 49 | * Reads a value from the stream using Java semantics. |
duke@1 | 50 | * @param in the stream to read the value from. |
duke@1 | 51 | * @param offset the current position in the input stream. |
duke@1 | 52 | * @param clz the type of the value to be read in. |
duke@1 | 53 | * @param repositoryID the RepositoryId of the value to be read in. |
duke@1 | 54 | * @param sender the sending context runtime codebase. |
duke@1 | 55 | * @return the value read from the stream. |
duke@1 | 56 | **/ |
duke@1 | 57 | java.io.Serializable readValue(org.omg.CORBA.portable.InputStream in, |
duke@1 | 58 | int offset, |
duke@1 | 59 | java.lang.Class clz, |
duke@1 | 60 | String repositoryID, |
duke@1 | 61 | org.omg.SendingContext.RunTime sender); |
duke@1 | 62 | |
duke@1 | 63 | /** |
duke@1 | 64 | * Returns the CORBA RepositoryId for the given Java class. |
duke@1 | 65 | * @param clz a Java class. |
duke@1 | 66 | * @return the CORBA RepositoryId for the class. |
duke@1 | 67 | **/ |
duke@1 | 68 | java.lang.String getRMIRepositoryID(java.lang.Class clz); |
duke@1 | 69 | |
duke@1 | 70 | /** |
duke@1 | 71 | * Indicates whether the given class performs custom or |
duke@1 | 72 | * default marshaling. |
duke@1 | 73 | * @param clz the class to test for custom marshaling. |
duke@1 | 74 | * @return <code>true</code> if the class performs custom marshaling, <code>false</code> |
duke@1 | 75 | * if it does not. |
duke@1 | 76 | **/ |
duke@1 | 77 | boolean isCustomMarshaled(java.lang.Class clz); |
duke@1 | 78 | |
duke@1 | 79 | /** |
duke@1 | 80 | * Returns the CodeBase for this ValueHandler. This is used by |
duke@1 | 81 | * the ORB runtime. The server sends the service context containing |
duke@1 | 82 | * the IOR for this CodeBase on the first GIOP reply. The client |
duke@1 | 83 | * does the same on the first GIOP request. |
duke@1 | 84 | * @return the SendingContext.CodeBase of this ValueHandler. |
duke@1 | 85 | **/ |
duke@1 | 86 | org.omg.SendingContext.RunTime getRunTimeCodeBase(); |
duke@1 | 87 | |
duke@1 | 88 | /** |
duke@1 | 89 | * If the value contains a <code>writeReplace</code> method then the result |
duke@1 | 90 | * is returned. Otherwise, the value itself is returned. |
duke@1 | 91 | * @param value the value to be marshaled. |
duke@1 | 92 | * @return the true value to marshal on the wire. |
duke@1 | 93 | **/ |
duke@1 | 94 | java.io.Serializable writeReplace(java.io.Serializable value); |
duke@1 | 95 | |
duke@1 | 96 | } |