WebClassLoader

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS (src) NEXT CLASS (src)

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jboss.web
Class WebClassLoader

java.lang.Object
  java.lang.ClassLoader
      java.security.SecureClassLoader
          java.net.URLClassLoader
              org.jboss.util.loading.DelegatingClassLoader (src) 
                  org.jboss.mx.loading.LoaderRepositoryClassLoader (src) 
                      org.jboss.web.WebClassLoader

Direct Known Subclasses:: WebCL (src)

public class WebClassLoader
extends LoaderRepositoryClassLoader (src)

A simple subclass of URLClassLoader that is used in conjunction with the the WebService mbean to allow dynamic loading of resources and classes from deployed ears, ejb jars and wars. A WebClassLoader is associated with a Container and must have an UnifiedClassLoader as its parent. It overrides the getURLs() method to return a different set of URLs for remote loading than what is used for local loading.

WebClassLoader has two methods meant to be overriden by subclasses: getKey() and getBytes(). The latter is a no-op in this implementation and should be overriden by subclasses with bytecode generation ability, such as the classloader used by the iiop module.

WebClassLoader subclasses must have a constructor with the same signature as the WebClassLoader constructor.

See Also:: #getUrls(), setWebURLs(URL[])

Field Summary

Fields inherited from class org.jboss.mx.loading.LoaderRepositoryClassLoader (src)

repository

Fields inherited from class org.jboss.util.loading.DelegatingClassLoader (src)

EMPTY_URL_ARRAY, standard

Constructor Summary
`WebClassLoader(ObjectName (src) containerName, RepositoryClassLoader (src) parent)` Creates new WebClassLoader.

Method Summary
`byte[]`	`getBytes(java.lang.Class clz)` Gets the bytecodes for a given class.
`java.lang.String`	`getCodebaseString()`
`ObjectName (src)`	`getContainer()` Gets the JMX ObjectName of the WebClassLoader's container.
`java.lang.String`	`getKey()` Gets a string key used as the key into the WebServer's loaderMap.
`java.net.URL[]`	`getLocalURLs()` Access the URLClassLoader.getURLs() value.
`java.net.URL`	`getURL()` Returns the single URL for my parent, an UnifiedClassLoader.
`java.net.URL[]`	`getURLs()` Get the list of URLs that should be used as the RMI annotated codebase.
`void`	`setWebURLs(java.net.URL[] webURLs)` Set the URLs that should be returned from this classes getURLs() override.

Methods inherited from class org.jboss.mx.loading.LoaderRepositoryClassLoader (src)

loadClass

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findClass, findResource, findResources, getPermissions, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

WebClassLoader

public WebClassLoader(ObjectName (src)  containerName,
                      RepositoryClassLoader (src)  parent)

Creates new WebClassLoader. Subclasses must have a constructor with the same signature.

Method Detail

getKey

public java.lang.String getKey()

Gets a string key used as the key into the WebServer's loaderMap.

getContainer

public ObjectName (src)  getContainer()

Gets the JMX ObjectName of the WebClassLoader's container.

getURL

public java.net.URL getURL()

Returns the single URL for my parent, an UnifiedClassLoader.

getURLs

public java.net.URL[] getURLs()

Get the list of URLs that should be used as the RMI annotated codebase. This is the URLs previously set via setWebURLs. If setWebURLs has not been invoked or was passed in a null value, the super class value of getURLs() is used.

Returns:: the local web URLs if not null, else the value of super.getURLs()

getLocalURLs

public java.net.URL[] getLocalURLs()

Access the URLClassLoader.getURLs() value.

Returns:: the URLs used for local class and resource loading

setWebURLs

public void setWebURLs(java.net.URL[] webURLs)

Set the URLs that should be returned from this classes getURLs() override.

getCodebaseString

public java.lang.String getCodebaseString()

getBytes

public byte[] getBytes(java.lang.Class clz)

Gets the bytecodes for a given class. This implementation always returns null, indicating that it is unable to get bytecodes for any class. Should be overridden by subclasses with bytecode generation capability (such as the classloader used by the iiop module, which generates IIOP stubs on the fly).