org.jboss.net.protocol

Class URLStreamHandlerFactory

java.lang.Object

org.jboss.net.protocol.URLStreamHandlerFactory

All Implemented Interfaces:

URLStreamHandlerFactory

public class URLStreamHandlerFactory
extends Object
implements URLStreamHandlerFactory

A factory for loading URL protocol handlers. This is based on Sun's URL mechanism, in that Handler classes will be searched for in the packages specified by the java.protocol.handler.pkgs property are searched for classes matching the protocol + ".Handler" classname. The default JBoss package "org.jboss.net.protocol" is searched even if not specified in the java.protocol.handler.pkgs property.

This factory is installed by the default server implementaion to ensure that protocol handlers not in the system classpath are located. The thread context class is used first followed by the Class.forName method.

Version:

$Revision$

Author:

Jason Dillon, Scott.Stark@jboss.org

Field Summary

Fields

Modifier and Type	Field and Description
static String	PACKAGE_PREFIX The package prefix where JBoss protocol handlers live.
static String[]	PROTOCOLS A list of JBoss specific protocols for preloading.

Constructor Summary

Constructors

Constructor and Description
URLStreamHandlerFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static void	clear() Clear the current protocol to handler map.
URLStreamHandler	createURLStreamHandler(String protocol) Search the handlerPkgs for URLStreamHandler classes matching the pkg + protocol + ".Handler" naming convention.
static void	preload() Preload the JBoss specific protocol handlers, so that URL knows about them even if the handler factory is changed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PACKAGE_PREFIX

public static final String PACKAGE_PREFIX

The package prefix where JBoss protocol handlers live.

See Also:

Constant Field Values

PROTOCOLS

public static final String[] PROTOCOLS

A list of JBoss specific protocols for preloading.

Constructor Detail

URLStreamHandlerFactory

public URLStreamHandlerFactory()

Method Detail

preload

public static void preload()

Preload the JBoss specific protocol handlers, so that URL knows about them even if the handler factory is changed.

clear

public static void clear()

Clear the current protocol to handler map. The map will be rebuilt as protocol handlers are requested.

createURLStreamHandler

public URLStreamHandler createURLStreamHandler(String protocol)

Search the handlerPkgs for URLStreamHandler classes matching the pkg + protocol + ".Handler" naming convention.

Specified by:

createURLStreamHandler in interface URLStreamHandlerFactory

Parameters:

protocol - The protocol to create a stream handler for

Returns:

The protocol handler or null if not found