001: /*
002: * $Header: /home/cvs/jakarta-tomcat-4.0/catalina/src/share/org/apache/naming/resources/DirContextURLStreamHandler.java,v 1.6 2002/02/11 22:24:28 remm Exp $
003: * $Revision: 1.6 $
004: * $Date: 2002/02/11 22:24:28 $
005: *
006: * ====================================================================
007: *
008: * The Apache Software License, Version 1.1
009: *
010: * Copyright (c) 1999 The Apache Software Foundation. All rights
011: * reserved.
012: *
013: * Redistribution and use in source and binary forms, with or without
014: * modification, are permitted provided that the following conditions
015: * are met:
016: *
017: * 1. Redistributions of source code must retain the above copyright
018: * notice, this list of conditions and the following disclaimer.
019: *
020: * 2. Redistributions in binary form must reproduce the above copyright
021: * notice, this list of conditions and the following disclaimer in
022: * the documentation and/or other materials provided with the
023: * distribution.
024: *
025: * 3. The end-user documentation included with the redistribution, if
026: * any, must include the following acknowlegement:
027: * "This product includes software developed by the
028: * Apache Software Foundation (http://www.apache.org/)."
029: * Alternately, this acknowlegement may appear in the software itself,
030: * if and wherever such third-party acknowlegements normally appear.
031: *
032: * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
033: * Foundation" must not be used to endorse or promote products derived
034: * from this software without prior written permission. For written
035: * permission, please contact apache@apache.org.
036: *
037: * 5. Products derived from this software may not be called "Apache"
038: * nor may "Apache" appear in their names without prior written
039: * permission of the Apache Group.
040: *
041: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
042: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
043: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
044: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
045: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
046: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
047: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
048: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
049: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
050: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
051: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
052: * SUCH DAMAGE.
053: * ====================================================================
054: *
055: * This software consists of voluntary contributions made by many
056: * individuals on behalf of the Apache Software Foundation. For more
057: * information on the Apache Software Foundation, please see
058: * <http://www.apache.org/>.
059: *
060: * [Additional notices, if required by prior licensing conditions]
061: *
062: */
063:
064: package org.apache.naming.resources;
065:
066: import java.net.URL;
067: import java.net.URLConnection;
068: import java.net.URLStreamHandler;
069: import java.io.IOException;
070: import java.util.Hashtable;
071: import javax.naming.NamingException;
072: import javax.naming.directory.DirContext;
073:
074: /**
075: * Stream handler to a JNDI directory context.
076: *
077: * @author <a href="mailto:remm@apache.org">Remy Maucherat</a>
078: * @version $Revision: 1.6 $
079: */
080: public class DirContextURLStreamHandler extends URLStreamHandler {
081:
082: // ----------------------------------------------------------- Constructors
083:
084: public DirContextURLStreamHandler() {
085: }
086:
087: public DirContextURLStreamHandler(DirContext context) {
088: this .context = context;
089: }
090:
091: // -------------------------------------------------------------- Variables
092:
093: /**
094: * Bindings class loader - directory context. Keyed by CL id.
095: */
096: private static Hashtable clBindings = new Hashtable();
097:
098: /**
099: * Bindings thread - directory context. Keyed by thread id.
100: */
101: private static Hashtable threadBindings = new Hashtable();
102:
103: // ----------------------------------------------------- Instance Variables
104:
105: /**
106: * Directory context.
107: */
108: protected DirContext context = null;
109:
110: // ------------------------------------------------------------- Properties
111:
112: // ----------------------------------------------- URLStreamHandler Methods
113:
114: /**
115: * Opens a connection to the object referenced by the <code>URL</code>
116: * argument.
117: */
118: protected URLConnection openConnection(URL u) throws IOException {
119: DirContext currentContext = this .context;
120: if (currentContext == null)
121: currentContext = get();
122: return new DirContextURLConnection(currentContext, u);
123: }
124:
125: // --------------------------------------------------------- Public Methods
126:
127: /**
128: * Set the java.protocol.handler.pkgs system property.
129: */
130: public static void setProtocolHandler() {
131: String value = System
132: .getProperty(Constants.PROTOCOL_HANDLER_VARIABLE);
133: if (value == null) {
134: value = Constants.Package;
135: System.setProperty(Constants.PROTOCOL_HANDLER_VARIABLE,
136: value);
137: } else if (value.indexOf(Constants.Package) == -1) {
138: value += "|" + Constants.Package;
139: System.setProperty(Constants.PROTOCOL_HANDLER_VARIABLE,
140: value);
141: }
142: }
143:
144: /**
145: * Returns true if the thread or the context class loader of the current
146: * thread is bound.
147: */
148: public static boolean isBound() {
149: return (clBindings.containsKey(Thread.currentThread()
150: .getContextClassLoader()))
151: || (threadBindings.containsKey(Thread.currentThread()));
152: }
153:
154: /**
155: * Binds a directory context to a class loader.
156: */
157: public static void bind(DirContext dirContext) {
158: ClassLoader currentCL = Thread.currentThread()
159: .getContextClassLoader();
160: if (currentCL != null)
161: clBindings.put(currentCL, dirContext);
162: }
163:
164: /**
165: * Unbinds a directory context to a class loader.
166: */
167: public static void unbind() {
168: ClassLoader currentCL = Thread.currentThread()
169: .getContextClassLoader();
170: if (currentCL != null)
171: clBindings.remove(currentCL);
172: }
173:
174: /**
175: * Binds a directory context to a thread.
176: */
177: public static void bindThread(DirContext dirContext) {
178: threadBindings.put(Thread.currentThread(), dirContext);
179: }
180:
181: /**
182: * Unbinds a directory context to a thread.
183: */
184: public static void unbindThread() {
185: threadBindings.remove(Thread.currentThread());
186: }
187:
188: /**
189: * Get the bound context.
190: */
191: public static DirContext get() {
192:
193: DirContext result = null;
194:
195: Thread currentThread = Thread.currentThread();
196: ClassLoader currentCL = currentThread.getContextClassLoader();
197:
198: // Checking CL binding
199: result = (DirContext) clBindings.get(currentCL);
200: if (result != null)
201: return result;
202:
203: // Checking thread biding
204: result = (DirContext) threadBindings.get(currentThread);
205:
206: // Checking parent CL binding
207: currentCL = currentCL.getParent();
208: while (currentCL != null) {
209: result = (DirContext) clBindings.get(currentCL);
210: if (result != null)
211: return result;
212: currentCL = currentCL.getParent();
213: }
214:
215: if (result == null)
216: throw new IllegalStateException(
217: "Illegal class loader binding");
218:
219: return result;
220:
221: }
222:
223: /**
224: * Binds a directory context to a class loader.
225: */
226: public static void bind(ClassLoader cl, DirContext dirContext) {
227: clBindings.put(cl, dirContext);
228: }
229:
230: /**
231: * Unbinds a directory context to a class loader.
232: */
233: public static void unbind(ClassLoader cl) {
234: clBindings.remove(cl);
235: }
236:
237: /**
238: * Get the bound context.
239: */
240: public static DirContext get(ClassLoader cl) {
241: return (DirContext) clBindings.get(cl);
242: }
243:
244: /**
245: * Get the bound context.
246: */
247: public static DirContext get(Thread thread) {
248: return (DirContext) threadBindings.get(thread);
249: }
250:
251: }
|