Package org.eclipse.jetty.osgi.boot.internal.webapp

Class OSGiWebappClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.eclipse.jetty.webapp.WebAppClassLoader

org.eclipse.jetty.osgi.boot.internal.webapp.OSGiWebappClassLoader

All Implemented Interfaces:

org.osgi.framework.BundleReference

public class OSGiWebappClassLoader
extends WebAppClassLoader
implements org.osgi.framework.BundleReference

OSGiWebappClassLoader Extends the webapp classloader to also use the classloader of the Bundle defining the webapp.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.webapp.WebAppClassLoader

WebAppClassLoader.Context

Field Summary

Fields

Modifier and Type	Field	Description
static java.util.Set<java.lang.String>	JAR_WITH_SUCH_CLASS_MUST_BE_EXCLUDED	when a logging framework is setup in the osgi classloaders, it can access this and register the classes that must not be found in the jar.

Constructor Summary

Constructors

Constructor	Description
OSGiWebappClassLoader(java.lang.ClassLoader parent, WebAppContext context, org.osgi.framework.Bundle contributor)

Method Summary

Modifier and Type	Method	Description
void	addClassPath(java.lang.String classPath)	Parse the classpath ourselves to be able to filter things.
static void	addClassThatIdentifiesAJarThatMustBeRejected(java.lang.Class<?> zclass)
static void	addClassThatIdentifiesAJarThatMustBeRejected(java.lang.String zclassName)
org.osgi.framework.Bundle	getBundle()	Returns the Bundle that defined this web-application.
java.net.URL	getResource(java.lang.String name)	Get a resource from the classloader NOTE: this method provides a convenience of hacking off a leading / should one be present.
java.util.Enumeration<java.net.URL>	getResources(java.lang.String name)
java.lang.Class<?>	loadClass(java.lang.String name)
void	setWebappContext(WebAppContext webappContext)	In the case of the generation of a webapp via a jetty context file we need a proper classloader to setup the app before we have the WebappContext So we place a fake one there to start with.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getPackage, getPackages, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findResource, findResources, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class org.eclipse.jetty.webapp.WebAppClassLoader

addClassFileTransformer, addClassPath, addJars, addTransformer, close, findClass, foundClass, getContext, getName, getPermissions, loadClass, removeClassFileTransformer, removeTransformer, runWithServerClassAccess, setName, toString

Field Detail

JAR_WITH_SUCH_CLASS_MUST_BE_EXCLUDED

public static final java.util.Set<java.lang.String> JAR_WITH_SUCH_CLASS_MUST_BE_EXCLUDED

when a logging framework is setup in the osgi classloaders, it can access this and register the classes that must not be found in the jar.

Constructor Detail

OSGiWebappClassLoader

public OSGiWebappClassLoader(java.lang.ClassLoader parent,
                             WebAppContext context,
                             org.osgi.framework.Bundle contributor)
                      throws java.io.IOException

Parameters:

parent - The parent classloader.

context - The WebAppContext

contributor - The bundle that defines this web-application.

Throws:

java.io.IOException - if unable to cerate the OSGiWebappClassLoader

Method Detail

addClassThatIdentifiesAJarThatMustBeRejected

public static void addClassThatIdentifiesAJarThatMustBeRejected(java.lang.Class<?> zclass)

addClassThatIdentifiesAJarThatMustBeRejected

public static void addClassThatIdentifiesAJarThatMustBeRejected(java.lang.String zclassName)

loadClass

public java.lang.Class<?> loadClass(java.lang.String name)
                             throws java.lang.ClassNotFoundException

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

getBundle

public org.osgi.framework.Bundle getBundle()

Returns the Bundle that defined this web-application.

Specified by:

getBundle in interface org.osgi.framework.BundleReference

Returns:

The Bundle object associated with this BundleReference.

getResources

public java.util.Enumeration<java.net.URL> getResources(java.lang.String name)
                                                 throws java.io.IOException

Overrides:

getResources in class WebAppClassLoader

Throws:

java.io.IOException

getResource

public java.net.URL getResource(java.lang.String name)

Description copied from class: WebAppClassLoader

Get a resource from the classloader NOTE: this method provides a convenience of hacking off a leading / should one be present. This is non-standard and it is recommended to not rely on this behavior

Overrides:

getResource in class WebAppClassLoader

addClassPath

public void addClassPath(java.lang.String classPath)
                  throws java.io.IOException

Parse the classpath ourselves to be able to filter things. This is a derivative work of the super class

Overrides:

addClassPath in class WebAppClassLoader

Parameters:

classPath - Comma or semicolon separated path of filenames or URLs pointing to directories or jar files. Directories should end with '/'.

Throws:

java.io.IOException - if unable to add classpath

setWebappContext

public void setWebappContext(WebAppContext webappContext)

In the case of the generation of a webapp via a jetty context file we need a proper classloader to setup the app before we have the WebappContext So we place a fake one there to start with. We replace it with the actual webapp context with this method. We also apply the extraclasspath there at the same time.

Parameters:

webappContext - the web app context