Package org.zeroturnaround.javarebel

Interface ServletIntegration

public interface ServletIntegration

Provides hooks for integrating JRebel with custom Servlet containers. To use it acquire an instance from ServletIntegrationFactory

A typical (Servlet context) integration will look like this:

 class MyServletContext implements ServletContext, RebelServletContext {

   ServletIntegration integration;

   public MyServletContext() {
     ...
     integration = ServletIntegrationFactory.getInstance();
     integration.registerServletContext(this);
   }
   ...
   public String getRealPath(String path) {
     if (integration.isResourceReplaced(this, path))
       return integration.getRealPath(this, path);
     ...
   }

   public URL getResource(String path) throws MalformedURLException {
     if (integration.isResourceReplaced(this, path))
       return integration.getResource(this, path);
     ...
   }

   public InputStream getResourceAsStream(String path) {
     if (integration.isResourceReplaced(this, path))
       return integration.getResourceAsStream(this, path);
     ...
   }

   public Set getResourcePaths(String path) {
     if (integration.isResourceReplaced(this, path))
       return integration.getResourcePaths(this, path);
     ...
   }
 }
 

Author:

Rein Raudjärv

See Also:

• ServletIntegrationFactory
• RebelServletContext
• Integration
• Reloader
• Logger
• Plugin

Method Summary

Modifier and Type	Method	Description
void	disableResourcePathsAssumption()	Assert that ServletContext#getResourcePaths is not able to find all resources that can be found by ServletContext#getResource
String	getRealPath(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a String containing the managed real path for a given virtual path.
RebelSource[]	getRebelSources(org.zeroturnaround.javarebel.RebelServletContext sc)	Returns the additional root paths of the given ServletContext managed by JRebel.
URL[]	getRebelURLs(org.zeroturnaround.javarebel.RebelServletContext sc)	Returns the additional root paths of the given ServletContext managed by JRebel.
URL	getResource(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a URL to the managed resource that is mapped to a specified path.
InputStream	getResourceAsStream(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns the managed resource located at the named path as an InputStream object.
Set<String>	getResourcePaths(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a directory-like listing of all the paths to managed resources within the web application whose longest sub-path matches the supplied path argument.
String	getTransparentRealPath(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a String containing the original real path for a given virtual path.
URL	getTransparentResource(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a URL to the original resource that is mapped to a specified path.
InputStream	getTransparentResourceAsStream(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns the original resource located at the named path as an InputStream object.
Set<String>	getTransparentResourcePaths(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns a directory-like listing of all the paths to resources within the web application whose longest sub-path matches the supplied path argument.
boolean	hasReplacedResources(org.zeroturnaround.javarebel.RebelServletContext sc)	Returns true if all resources of the given Servlet Context are managed by JRebel.
boolean	isResourceReplaced(org.zeroturnaround.javarebel.RebelServletContext sc, String path)	Returns true if the given resource is managed by JRebel.
void	registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc, File explodedWar)	Register additional resources with target ServletContext.
void	registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc, URL url)	Register additional resources with target ServletContext.
void	registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc, org.zeroturnaround.javarebel.RebelServletContext additionalWebSc, String filter)	Registers additional ServletContext-s rebel web resources with target ServletContext After adding some reinitialisation of some plugins may be required to get the new rebel sources
void	registerAdditionalWebResourcesWithPrefix(org.zeroturnaround.javarebel.RebelServletContext sc, org.zeroturnaround.javarebel.RebelServletContext additionalWebSc, String prefix)	Registers additional ServletContext-s rebel web resources with target ServletContext After adding some reinitialisation of some plugins may be required to get the new rebel sources
void	registerServletContext(org.zeroturnaround.javarebel.RebelServletContext sc)	Registers a ServletContext with JRebel.
void	unregisterAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc, org.zeroturnaround.javarebel.RebelServletContext additionalWebSc)	Unregisters additional ServletContext-s rebel web resources from target ServletContext After removing some reinitialisation of some plugins may be required to change rebel sources
void	unregisterServletContext(org.zeroturnaround.javarebel.RebelServletContext sc)	Unregisters a ServletContext from JRebel.

Method Details

registerServletContext

void registerServletContext(org.zeroturnaround.javarebel.RebelServletContext sc)

Registers a ServletContext with JRebel. It is necessary to do this before any calls to the rest of the methods of ServletIntegration, the best place is usually the constructor. The custom ServletContext must implement the RebelServletContext, The latter can be easily added by the corresponding ClassBytecodeProcessor.

Parameters:

sc - The custom Servlet context being integrated.

unregisterServletContext

void unregisterServletContext(org.zeroturnaround.javarebel.RebelServletContext sc)

Unregisters a ServletContext from JRebel. It is recommended to do this in case the corresponding ServletContext is destroyed (e.g. the web application is undeployed).

Parameters:

sc - The custom Servlet context being integrated.

registerAdditionalWebResources

void registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc,
 org.zeroturnaround.javarebel.RebelServletContext additionalWebSc,
 String filter)

Registers additional ServletContext-s rebel web resources with target ServletContext After adding some reinitialisation of some plugins may be required to get the new rebel sources

Parameters:

sc - The target Servlet context where new resources are being added

additionalWebSc - The source Servlet context which rebel.xml web tags source is also used for resources

filter - Adds only paths that match the filter. Can be null.

registerAdditionalWebResourcesWithPrefix

void registerAdditionalWebResourcesWithPrefix(org.zeroturnaround.javarebel.RebelServletContext sc,
 org.zeroturnaround.javarebel.RebelServletContext additionalWebSc,
 String prefix)

Registers additional ServletContext-s rebel web resources with target ServletContext After adding some reinitialisation of some plugins may be required to get the new rebel sources

Parameters:

sc - The target Servlet context where new resources are being added

additionalWebSc - The source Servlet context which rebel.xml web tags source is also used for resources

prefix - Attach prefix before every patch

registerAdditionalWebResources

void registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc,
 URL url)

Register additional resources with target ServletContext.

Parameters:

sc - The custom Servlet context being integrated.

url - URL to a jar with additional web resources.

registerAdditionalWebResources

void registerAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc,
 File explodedWar)

Register additional resources with target ServletContext.

Parameters:

sc - The custom Servlet context being integrated.

explodedWar - File pointing to exploded WAR directory.

unregisterAdditionalWebResources

void unregisterAdditionalWebResources(org.zeroturnaround.javarebel.RebelServletContext sc,
 org.zeroturnaround.javarebel.RebelServletContext additionalWebSc)

Unregisters additional ServletContext-s rebel web resources from target ServletContext After removing some reinitialisation of some plugins may be required to change rebel sources

Parameters:

sc - The target Servlet context where new resources are being added

additionalWebSc - The source Servlet context which rebel.xml web tags source is also used for resources

getRebelURLs

URL[] getRebelURLs(org.zeroturnaround.javarebel.RebelServletContext sc)

Returns the additional root paths of the given ServletContext managed by JRebel.

Parameters:

sc - The custom Servlet context being integrated.

Returns:

additional paths of the given ServletContext or null if nothing found.

getRebelSources

RebelSource[] getRebelSources(org.zeroturnaround.javarebel.RebelServletContext sc)

Returns the additional root paths of the given ServletContext managed by JRebel.

Parameters:

sc - The custom Servlet context being integrated.

Returns:

additional paths of the given ServletContext or null if nothing found.

hasReplacedResources

boolean hasReplacedResources(org.zeroturnaround.javarebel.RebelServletContext sc)

Returns true if all resources of the given Servlet Context are managed by JRebel.

All Servlet Context resources are managed by JRebel if the Servlet Context has been registered and a valid rebel.xml has been found which defines the new resource locations.

Parameters:

sc - The custom Servlet context being integrated.

Returns:

true if all resources of the given Servlet Context are managed by JRebel.

isResourceReplaced

boolean isResourceReplaced(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns true if the given resource is managed by JRebel.

In that case resources can be resolved using the corresponding methods of the ServletIntegration. If any of these methods returns a null it must be returned by the ServletContext as well.

Parameters:

sc - The custom Servlet context being integrated.

path - path of the resource.

Returns:

true if the given resource is managed by JRebel.

getResourceAsStream

InputStream getResourceAsStream(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns the managed resource located at the named path as an InputStream object.

A typical usage will look like this:

 class MyServletContext implements ServletContext, RebelServletContext {
   ...
   public InputStream getResourceAsStream(String path) throws MalformedURLException {
     ServletIntegration integration = ServletIntegrationFactory.getInstance();
     if (integration.isResourceReplaced(this, path))
       return integration.getResourceAsStream(this, path);
     ...
   }
   ...
 }
 

The Servlet context instance must be first registered with JRebel.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

the resource located at the named path as an InputStream object, or null if there is no resource at that path

See Also:

• registerServletContext(RebelServletContext)

getResource

URL getResource(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)
         throws MalformedURLException

Returns a URL to the managed resource that is mapped to a specified path.

A typical usage will look like this:

 class MyServletContext implements ServletContext, RebelServletContext {
   ...
   public URL getResource(String path) throws MalformedURLException {
     ServletIntegration integration = ServletIntegrationFactory.getInstance();
     if (integration.isResourceReplaced(this, path))
       return integration.getResource(this, path);
     ...
   }
   ...
 }
 

The Servlet context instance must be first registered with JRebel.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

the resource located at the named path, or null if there is no resource at that path

Throws:

MalformedURLException - if the pathname is not given in the correct form

See Also:

• registerServletContext(RebelServletContext)

getRealPath

String getRealPath(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns a String containing the managed real path for a given virtual path.

A typical usage will look like this:

 class MyServletContext implements ServletContext, RebelServletContext {
   ...
   public String getRealPath(String path) throws MalformedURLException {
     ServletIntegration integration = ServletIntegrationFactory.getInstance();
     if (integration.isResourceReplaced(this, path))
       return integration.getRealPath(this, path);
     ...
   }
   ...
 }
 

The Servlet context instance must be first registered with JRebel.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

a String specifying the real path, or null if the translation cannot be performed

See Also:

• registerServletContext(RebelServletContext)

getResourcePaths

Set<String> getResourcePaths(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns a directory-like listing of all the paths to managed resources within the web application whose longest sub-path matches the supplied path argument.

 class MyServletContext implements ServletContext, RebelServletContext {
   ...
   public Set getResourcePaths(String path) throws MalformedURLException {
     ServletIntegration integration = ServletIntegrationFactory.getInstance();
     if (integration.isResourceReplaced(this, path))
       return integration.getResourcePaths(this, path);
     ...
   }
   ...
 }
 

The Servlet context instance must be first registered with JRebel.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

a Set containing the directory listing, or null if there are no resources in the web application whose path begins with the supplied path.

See Also:

• registerServletContext(RebelServletContext)

getTransparentResourceAsStream

InputStream getTransparentResourceAsStream(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns the original resource located at the named path as an InputStream object.

This is used to get the original result unaltered by JRebel.

The corresponding Servlet context method will be invoked such that isResourceReplaced(RebelServletContext, String) returns false.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

the resource located at the named path as an InputStream object, or null if there is no resource at that path

getTransparentResource

URL getTransparentResource(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)
                    throws MalformedURLException

Returns a URL to the original resource that is mapped to a specified path.

This is used to get the original result unaltered by JRebel.

The corresponding Servlet context method will be invoked such that isResourceReplaced(RebelServletContext, String) returns false.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

the resource located at the named path, or null if there is no resource at that path

Throws:

MalformedURLException - if the pathname is not given in the correct form

getTransparentRealPath

String getTransparentRealPath(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns a String containing the original real path for a given virtual path.

This is used to get the original result unaltered by JRebel.

The corresponding Servlet context method will be invoked such that isResourceReplaced(RebelServletContext, String) returns false.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

a String specifying the real path, or null if the translation cannot be performed

getTransparentResourcePaths

Set<String> getTransparentResourcePaths(org.zeroturnaround.javarebel.RebelServletContext sc,
 String path)

Returns a directory-like listing of all the paths to resources within the web application whose longest sub-path matches the supplied path argument.

This is used to get the original result unaltered by JRebel.

The corresponding Servlet context method will be invoked such that isResourceReplaced(RebelServletContext, String) returns false.

Parameters:

sc - The custom Servlet context being integrated.

path - a String specifying the path to the resource

Returns:

a Set containing the directory listing, or null if there are no resources in the web application whose path begins with the supplied path.

disableResourcePathsAssumption

void disableResourcePathsAssumption()

Assert that ServletContext#getResourcePaths is not able to find all resources that can be found by ServletContext#getResource