org.apache.catalina.loader
Class VirtualWebappLoader

java.lang.Object
  org.apache.catalina.loader.WebappLoader
      org.apache.catalina.loader.VirtualWebappLoader

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.util.EventListener, javax.management.MBeanRegistration, Lifecycle, Loader

public class VirtualWebappLoader
extends WebappLoader

A WebappLoader that allows a customized classpath to be added through configuration in context xml. Any additional classpath entry will be added to the default webapp classpath, making easy to emulate a standard webapp without the need for assembly all the webapp dependencies as jars in WEB-INF/lib.

 <Context docBase="\webapps\mydocbase">
   <Loader className="org.apache.catalina.loader.VirtualWebappLoader"
              virtualClasspath="/dir/classes;/somedir/somejar.jar;/somedir/*.jar"/>
 </Context>
 

The *.jar suffix can be used to include all JAR files in a certain directory. If a file or a directory does not exist, it will be skipped.

Author:

Fabrizio Giustina

VirtualWebappLoader

public VirtualWebappLoader()

Construct a new WebappLoader with no defined parent class loader (so that the actual parent will be the system class loader).

VirtualWebappLoader

public VirtualWebappLoader(java.lang.ClassLoader parent)

Construct a new WebappLoader with the specified class loader to be defined as the parent of the ClassLoader we ultimately create.

Parameters:

parent - The parent class loader

setVirtualClasspath

public void setVirtualClasspath(java.lang.String path)

virtualClasspath attribute that will be automatically set from the Context virtualClasspath attribute from the context xml file.

Parameters:

path - ; separated list of path elements.

getSearchVirtualFirst

public boolean getSearchVirtualFirst()

Returns:

Returns searchVirtualFirst.

setSearchVirtualFirst

public void setSearchVirtualFirst(boolean searchVirtualFirst)

Parameters:

searchVirtualFirst - Whether the virtual class path should be searched before the webapp

start

public void start()
           throws LifecycleException

Description copied from class: WebappLoader

Start this component, initializing our associated class loader.

Specified by:

start in interface Lifecycle

Overrides:

start in class WebappLoader

Throws:

LifecycleException - if a lifecycle error occurs