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
26package java.rmi.server;
27
28import 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
39public 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}
69