1 /* 2 * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package java.rmi.server; 27 28 import java.rmi.*; 29 30 /** 31 * A ServerRef represents the server-side handle for a remote object 32 * implementation. 33 * 34 * @author Ann Wollrath 35 * @since 1.1 36 * @deprecated No replacement. This interface is unused and is obsolete. 37 */ 38 @Deprecated 39 public interface ServerRef extends RemoteRef { 40 41 /** indicate compatibility with JDK 1.1.x version of class. */ 42 static final long serialVersionUID = -4557750989390278438L; 43 44 /** 45 * Creates a client stub object for the supplied Remote object. 46 * If the call completes successfully, the remote object should 47 * be able to accept incoming calls from clients. 48 * @param obj the remote object implementation 49 * @param data information necessary to export the object 50 * @return the stub for the remote object 51 * @exception RemoteException if an exception occurs attempting 52 * to export the object (e.g., stub class could not be found) 53 * @since 1.1 54 */ 55 RemoteStub exportObject(Remote obj, Object data) 56 throws RemoteException; 57 58 /** 59 * Returns the hostname of the current client. When called from a 60 * thread actively handling a remote method invocation the 61 * hostname of the client is returned. 62 * @return the client's host name 63 * @exception ServerNotActiveException if called outside of servicing 64 * a remote method invocation 65 * @since 1.1 66 */ 67 String getClientHost() throws ServerNotActiveException; 68 }