001/* RemoteServer.java --
002   Copyright (c) 1996, 1997, 1998, 1999, 2004, 2006
003   Free Software Foundation, Inc.
004
005This file is part of GNU Classpath.
006
007GNU Classpath is free software; you can redistribute it and/or modify
008it under the terms of the GNU General Public License as published by
009the Free Software Foundation; either version 2, or (at your option)
010any later version.
011
012GNU Classpath is distributed in the hope that it will be useful, but
013WITHOUT ANY WARRANTY; without even the implied warranty of
014MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
015General Public License for more details.
016
017You should have received a copy of the GNU General Public License
018along with GNU Classpath; see the file COPYING.  If not, write to the
019Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02002110-1301 USA.
021
022Linking this library statically or dynamically with other modules is
023making a combined work based on this library.  Thus, the terms and
024conditions of the GNU General Public License cover the whole
025combination.
026
027As a special exception, the copyright holders of this library give you
028permission to link this library with independent modules to produce an
029executable, regardless of the license terms of these independent
030modules, and to copy and distribute the resulting executable under
031terms of your choice, provided that you also meet, for each linked
032independent module, the terms and conditions of the license of that
033module.  An independent module is a module which is not derived from
034or based on this library.  If you modify this library, you may extend
035this exception to your version of the library, but you are not
036obligated to do so.  If you do not wish to do so, delete this
037exception statement from your version. */
038
039
040package java.rmi.server;
041
042import gnu.java.rmi.server.RMIIncomingThread;
043
044import java.io.OutputStream;
045import java.io.PrintStream;
046
047/**
048 * A common superclass for the server implementations.
049 */
050public abstract class RemoteServer
051    extends RemoteObject
052{
053  private static final long serialVersionUID = - 4100238210092549637L;
054
055  /**
056   * Does nothing, delegates to super().
057   */
058  protected RemoteServer()
059  {
060    super();
061  }
062
063  /**
064   * Does nothing, delegates to super(ref).
065   */
066  protected RemoteServer(RemoteRef ref)
067  {
068    super(ref);
069  }
070
071  /**
072   * Get the host of the calling client. The current thread must be an instance
073   * of the {@link RMIIncomingThread}.
074   *
075   * @return the client host address
076   *
077   * @throws ServerNotActiveException if the current thread is not an instance
078   * of the RMIIncomingThread.
079   */
080  public static String getClientHost() throws ServerNotActiveException
081  {
082    Thread currThread = Thread.currentThread();
083    if (currThread instanceof RMIIncomingThread)
084      {
085        RMIIncomingThread incomingThread = (RMIIncomingThread) currThread;
086        return incomingThread.getClientHost();
087      }
088    else
089      {
090        throw new ServerNotActiveException(
091          "Unknown client host - current thread not instance of 'RMIIncomingThread'");
092      }
093  }
094
095  /**
096   * Set the stream for logging RMI calls.
097   *
098   * @param out the stream to set or null to turn the logging off.
099   */
100  public static void setLog(OutputStream out)
101  {
102    throw new Error("Not implemented");
103  }
104
105  /**
106   * Get the stream for logging RMI calls.
107   *
108   * @return the associated stream.
109   */
110  public static PrintStream getLog()
111  {
112    throw new Error("Not implemented");
113  }
114
115}