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 }