0N/A/*
2362N/A * Copyright (c) 2002, 2007, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage javax.management.remote.rmi;
0N/A
0N/Aimport java.io.IOException;
0N/Aimport java.rmi.NoSuchObjectException;
0N/Aimport java.rmi.Remote;
0N/Aimport java.rmi.RemoteException;
0N/Aimport java.rmi.server.RMIClientSocketFactory;
0N/Aimport java.rmi.server.RMIServerSocketFactory;
0N/Aimport java.rmi.server.UnicastRemoteObject;
0N/Aimport java.rmi.server.RemoteObject;
0N/Aimport java.util.Map;
0N/Aimport java.util.Collections;
0N/Aimport javax.security.auth.Subject;
0N/A
0N/Aimport com.sun.jmx.remote.internal.RMIExporter;
742N/Aimport com.sun.jmx.remote.util.EnvHelp;
742N/Aimport sun.rmi.server.UnicastServerRef;
742N/Aimport sun.rmi.server.UnicastServerRef2;
0N/A
0N/A/**
0N/A * <p>An {@link RMIServer} object that is exported through JRMP and that
0N/A * creates client connections as RMI objects exported through JRMP.
0N/A * User code does not usually reference this class directly.</p>
0N/A *
0N/A * @see RMIServerImpl
0N/A *
0N/A * @since 1.5
0N/A */
0N/Apublic class RMIJRMPServerImpl extends RMIServerImpl {
0N/A /**
0N/A * <p>Creates a new {@link RMIServer} object that will be exported
0N/A * on the given port using the given socket factories.</p>
0N/A *
0N/A * @param port the port on which this object and the {@link
0N/A * RMIConnectionImpl} objects it creates will be exported. Can be
0N/A * zero, to indicate any available port.
0N/A *
0N/A * @param csf the client socket factory for the created RMI
0N/A * objects. Can be null.
0N/A *
0N/A * @param ssf the server socket factory for the created RMI
0N/A * objects. Can be null.
0N/A *
0N/A * @param env the environment map. Can be null.
0N/A *
0N/A * @exception IOException if the {@link RMIServer} object
0N/A * cannot be created.
0N/A *
0N/A * @exception IllegalArgumentException if <code>port</code> is
0N/A * negative.
0N/A */
0N/A public RMIJRMPServerImpl(int port,
0N/A RMIClientSocketFactory csf,
0N/A RMIServerSocketFactory ssf,
0N/A Map<String,?> env)
0N/A throws IOException {
0N/A
0N/A super(env);
0N/A
0N/A if (port < 0)
0N/A throw new IllegalArgumentException("Negative port: " + port);
0N/A
0N/A this.port = port;
0N/A this.csf = csf;
0N/A this.ssf = ssf;
0N/A this.env = (env == null) ? Collections.<String, Object>emptyMap() : env;
0N/A }
0N/A
0N/A protected void export() throws IOException {
0N/A export(this);
0N/A }
0N/A
0N/A private void export(Remote obj) throws RemoteException {
742N/A final RMIExporter exporter =
0N/A (RMIExporter) env.get(RMIExporter.EXPORTER_ATTRIBUTE);
742N/A final boolean daemon = EnvHelp.isServerDaemon(env);
742N/A
742N/A if (daemon && exporter != null) {
742N/A throw new IllegalArgumentException("If "+EnvHelp.JMX_SERVER_DAEMON+
742N/A " is specified as true, "+RMIExporter.EXPORTER_ATTRIBUTE+
742N/A " cannot be used to specify an exporter!");
742N/A }
742N/A
742N/A if (daemon) {
742N/A if (csf == null && ssf == null) {
742N/A new UnicastServerRef(port).exportObject(obj, null, true);
742N/A } else {
742N/A new UnicastServerRef2(port, csf, ssf).exportObject(obj, null, true);
742N/A }
742N/A } else if (exporter != null) {
742N/A exporter.exportObject(obj, port, csf, ssf);
742N/A } else {
0N/A UnicastRemoteObject.exportObject(obj, port, csf, ssf);
742N/A }
0N/A }
0N/A
0N/A private void unexport(Remote obj, boolean force)
0N/A throws NoSuchObjectException {
0N/A RMIExporter exporter =
0N/A (RMIExporter) env.get(RMIExporter.EXPORTER_ATTRIBUTE);
0N/A if (exporter == null)
0N/A UnicastRemoteObject.unexportObject(obj, force);
0N/A else
0N/A exporter.unexportObject(obj, force);
0N/A }
0N/A
0N/A protected String getProtocol() {
0N/A return "rmi";
0N/A }
0N/A
0N/A /**
0N/A * <p>Returns a serializable stub for this {@link RMIServer} object.</p>
0N/A *
0N/A * @return a serializable stub.
0N/A *
0N/A * @exception IOException if the stub cannot be obtained - e.g the
0N/A * RMIJRMPServerImpl has not been exported yet.
0N/A */
0N/A public Remote toStub() throws IOException {
0N/A return RemoteObject.toStub(this);
0N/A }
0N/A
0N/A /**
0N/A * <p>Creates a new client connection as an RMI object exported
0N/A * through JRMP. The port and socket factories for the new
0N/A * {@link RMIConnection} object are the ones supplied
0N/A * to the <code>RMIJRMPServerImpl</code> constructor.</p>
0N/A *
0N/A * @param connectionId the ID of the new connection. Every
0N/A * connection opened by this connector server will have a
0N/A * different id. The behavior is unspecified if this parameter is
0N/A * null.
0N/A *
0N/A * @param subject the authenticated subject. Can be null.
0N/A *
0N/A * @return the newly-created <code>RMIConnection</code>.
0N/A *
0N/A * @exception IOException if the new {@link RMIConnection}
0N/A * object cannot be created or exported.
0N/A */
0N/A protected RMIConnection makeClient(String connectionId, Subject subject)
0N/A throws IOException {
0N/A
0N/A if (connectionId == null)
0N/A throw new NullPointerException("Null connectionId");
0N/A
0N/A RMIConnection client =
0N/A new RMIConnectionImpl(this, connectionId, getDefaultClassLoader(),
0N/A subject, env);
0N/A export(client);
0N/A return client;
0N/A }
0N/A
0N/A protected void closeClient(RMIConnection client) throws IOException {
0N/A unexport(client, true);
0N/A }
0N/A
0N/A /**
0N/A * <p>Called by {@link #close()} to close the connector server by
0N/A * unexporting this object. After returning from this method, the
0N/A * connector server must not accept any new connections.</p>
0N/A *
0N/A * @exception IOException if the attempt to close the connector
0N/A * server failed.
0N/A */
0N/A protected void closeServer() throws IOException {
0N/A unexport(this, true);
0N/A }
0N/A
0N/A private final int port;
0N/A private final RMIClientSocketFactory csf;
0N/A private final RMIServerSocketFactory ssf;
0N/A private final Map<String, ?> env;
0N/A}