Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=26701
authormarkt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Sun, 6 Mar 2011 22:12:10 +0000 (22:12 +0000)
committermarkt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Sun, 6 Mar 2011 22:12:10 +0000 (22:12 +0000)
Provide a mechanism for users to register their own URLStreamHandlerFactory objects.

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1078601 13f79535-47bb-0310-9956-ffa450edef68

java/org/apache/catalina/loader/WebappLoader.java
java/org/apache/naming/resources/Constants.java
java/org/apache/naming/resources/DirContextURLStreamHandlerFactory.java
test/org/apache/naming/resources/TestDirContextURLStreamHandlerFactory.java [new file with mode: 0644]
webapps/docs/changelog.xml

index 446c1dc..9bd5a7f 100644 (file)
@@ -559,7 +559,7 @@ public class WebappLoader extends LifecycleMBeanBase
         
         // Register a stream handler factory for the JNDI protocol
         URLStreamHandlerFactory streamHandlerFactory =
-            new DirContextURLStreamHandlerFactory();
+                DirContextURLStreamHandlerFactory.getInstance();
         if (first) {
             first = false;
             try {
index dd004e4..48d21a3 100644 (file)
@@ -24,13 +24,5 @@ package org.apache.naming.resources;
  */
 
 public final class Constants {
-
-    public static final String PROTOCOL_HANDLER_VARIABLE = 
-        "java.protocol.handler.pkgs";
-
     public static final String Package = "org.apache.naming.resources";
-
-    // Default namespace name
-    public static final String DEFAULT_NAMESPACE = "DAV:";
-
 }
index 54f9da8..8886a8e 100644 (file)
@@ -19,32 +19,38 @@ package org.apache.naming.resources;
 
 import java.net.URLStreamHandler;
 import java.net.URLStreamHandlerFactory;
+import java.util.List;
+import java.util.concurrent.CopyOnWriteArrayList;
 
 /**
- * Factory for Stream handlers to a JNDI directory context.
+ * Factory for Stream handlers to a JNDI directory context that also supports
+ * users specifying additional stream handler.
  * 
  * @author <a href="mailto:remm@apache.org">Remy Maucherat</a>
  * @version $Revision$
  */
-public class DirContextURLStreamHandlerFactory 
-    implements URLStreamHandlerFactory {
+public class DirContextURLStreamHandlerFactory
+        implements URLStreamHandlerFactory {
     
-    
-    // ----------------------------------------------------------- Constructors
-    
-    
-    public DirContextURLStreamHandlerFactory() {
-        // NOOP
+    // Singleton
+    private static DirContextURLStreamHandlerFactory instance =
+        new DirContextURLStreamHandlerFactory();
+
+    public static DirContextURLStreamHandlerFactory getInstance() {
+        return instance;
+    }
+
+    public static void addUserFactory(URLStreamHandlerFactory factory) {
+        instance.userFactories.add(factory);
+    }
+
+
+    private List<URLStreamHandlerFactory> userFactories =
+        new CopyOnWriteArrayList<URLStreamHandlerFactory>();
+
+    private DirContextURLStreamHandlerFactory() {
+        // Hide the default constructor
     }
-    
-    
-    // ----------------------------------------------------- Instance Variables
-    
-    
-    // ------------------------------------------------------------- Properties
-    
-    
-    // ---------------------------------------- URLStreamHandlerFactory Methods
     
     
     /**
@@ -60,6 +66,13 @@ public class DirContextURLStreamHandlerFactory
         if (protocol.equals("jndi")) {
             return new DirContextURLStreamHandler();
         } else {
+            for (URLStreamHandlerFactory factory : userFactories) {
+                URLStreamHandler handler =
+                    factory.createURLStreamHandler(protocol);
+                if (handler != null) {
+                    return handler;
+                }
+            }
             return null;
         }
     }
diff --git a/test/org/apache/naming/resources/TestDirContextURLStreamHandlerFactory.java b/test/org/apache/naming/resources/TestDirContextURLStreamHandlerFactory.java
new file mode 100644 (file)
index 0000000..eda3f96
--- /dev/null
@@ -0,0 +1,78 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.naming.resources;
+
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.net.URLStreamHandler;
+import java.net.URLStreamHandlerFactory;
+
+import junit.framework.TestCase;
+
+public class TestDirContextURLStreamHandlerFactory extends TestCase {
+
+    public void testUserSuppliedFactory() throws Exception {
+        
+        URL url = null;
+        
+        // Initially unknown
+        try {
+            url = new URL("foo://www.apache.org");
+        } catch (MalformedURLException ignore) {
+            // Ignore
+        }
+        assertNull(url);
+        
+        // Set the factory
+        URL.setURLStreamHandlerFactory(
+                DirContextURLStreamHandlerFactory.getInstance());
+
+        // Still unknown
+        try {
+            url = new URL("foo://www.apache.org");
+        } catch (MalformedURLException ignore) {
+            // Ignore
+        }
+        assertNull(url);
+
+        // Register a user factory
+        DirContextURLStreamHandlerFactory.addUserFactory(
+                new FooURLStreamHandlerFactory());
+        
+        // Now it works
+        try {
+            url = new URL("foo://www.apache.org");
+        } catch (MalformedURLException ignore) {
+            // Ignore
+        }
+        assertNotNull(url);
+    }
+    
+    public static class FooURLStreamHandlerFactory
+            implements URLStreamHandlerFactory {
+
+        @Override
+        public URLStreamHandler createURLStreamHandler(String protocol) {
+            if ("foo".equals(protocol)) {
+                // This is good enough for this test but not for actual use
+                return new DirContextURLStreamHandler();
+            } else {
+                return null;
+            }
+        }
+    }
+}
index d5641f8..1f58b10 100644 (file)
   <subsection name="Catalina">
     <changelog>
       <fix>
+        <bug>26701</bug>: Provide a mechanism for users to register their own
+        <code>URLStreamHandlerFactory</code> objects. (markt)
+      </fix>
+      <fix>
         <bug>50855</bug>: Fix NPE on HttpServletRequest.logout() when debug
         logging is enabled. (markt)
       </fix>