--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/share/classes/com/sun/jmx/namespace/RoutingConnectionProxy.java	Thu Sep 04 14:46:36 2008 +0200
@@ -0,0 +1,132 @@
+/*
+ * Copyright 2008 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Sun designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Sun in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ */
+
+package com.sun.jmx.namespace;
+
+
+import com.sun.jmx.defaults.JmxProperties;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+import javax.management.MBeanServerConnection;
+import javax.management.namespace.JMXNamespaces;
+
+
+/**
+ * A RoutingConnectionProxy is an MBeanServerConnection proxy that proxies a
+ * source name space in a source MBeanServerConnection.
+ * It wraps a source MBeanServerConnection, and rewrites routing
+ * ObjectNames. It is used to implement
+ * {@code JMXNamespaces.narrowToNamespace(MBeanServerConnection)}.
+ * <p><b>
+ * This API is a Sun internal API and is subject to changes without notice.
+ * </b></p>
+ * @since 1.7
+ */
+public class RoutingConnectionProxy
+        extends RoutingProxy<MBeanServerConnection> {
+
+    /**
+     * A logger for this class.
+     **/
+    private static final Logger LOG = JmxProperties.NAMESPACE_LOGGER;
+
+
+    /**
+     * Creates a new instance of RoutingConnectionProxy
+     */
+    public RoutingConnectionProxy(MBeanServerConnection source,
+                               String sourceDir) {
+        this(source,sourceDir,"",false);
+    }
+
+    /**
+     * Creates a new instance of RoutingConnectionProxy
+     */
+    public RoutingConnectionProxy(MBeanServerConnection source,
+                               String sourceDir,
+                               String targetDir,
+                               boolean forwardsContext) {
+        super(source,sourceDir,targetDir,forwardsContext);
+
+        if (LOG.isLoggable(Level.FINER))
+            LOG.finer("RoutingConnectionProxy for " + getSourceNamespace() +
+                      " created");
+    }
+
+    @Override
+    public String toString() {
+        final String targetNs = getTargetNamespace();
+        final String sourceNs = getSourceNamespace();
+        String wrapped = String.valueOf(source());
+        if ("".equals(targetNs)) {
+            if (forwardsContext)
+                wrapped = "ClientContext.withDynamicContext("+wrapped+")";
+            return "JMXNamespaces.narrowToNamespace("+
+                    wrapped+", \""+
+                    sourceNs+"\")";
+        }
+        return this.getClass().getSimpleName()+"("+wrapped+", \""+
+               sourceNs+"\", \""+
+               targetNs+"\", "+forwardsContext+")";
+    }
+
+    public static MBeanServerConnection cd(MBeanServerConnection source,
+            String sourcePath) {
+        if (source == null) throw new IllegalArgumentException("null");
+        if (source.getClass().equals(RoutingConnectionProxy.class)) {
+            // cast is OK here, but findbugs complains unless we use class.cast
+            final RoutingConnectionProxy other =
+                    RoutingConnectionProxy.class.cast(source);
+            final String target = other.getTargetNamespace();
+
+            // Avoid multiple layers of serialization.
+            //
+            // We construct a new proxy from the original source instead of
+            // stacking a new proxy on top of the old one.
+            // - that is we replace
+            //      cd ( cd ( x, dir1), dir2);
+            // by
+            //      cd (x, dir1//dir2);
+            //
+            // We can do this only when the source class is exactly
+            //    NamespaceConnectionProxy.
+            //
+            if (target == null || target.equals("")) {
+                final String path =
+                    JMXNamespaces.concat(other.getSourceNamespace(),
+                    sourcePath);
+                return new RoutingConnectionProxy(other.source(),path,"",
+                        other.forwardsContext);
+            }
+            // Note: we could do possibly something here - but it would involve
+            //       removing part of targetDir, and possibly adding
+            //       something to sourcePath.
+            //       Too complex to bother! => simply default to stacking...
+        }
+        return new RoutingConnectionProxy(source,sourcePath);
+    }
+
+}