Apache Struts API Documentation: Class ModuleUtils

Apache Struts API


org.apache.struts.util Class ModuleUtils

java.lang.Object
  |
  +--org.apache.struts.util.ModuleUtils

public class ModuleUtils
extends java.lang.Object

General purpose utility methods related to module processing.

Since:
Struts 1.2
Version:
$Rev: 54929 $

Field Summary
private static ModuleUtils instance
          The Singleton instance.
private static org.apache.commons.logging.Log log
          Commons logging instance.
 
Constructor Summary
protected ModuleUtils()
          Constructor for ModuleUtils.
 
Method Summary
static ModuleUtils getInstance()
          Returns the Singleton instance of TagUtils.
 ModuleConfig getModuleConfig(javax.servlet.http.HttpServletRequest request)
          Return the current ModuleConfig object stored in request, if it exists, null otherwise.
 ModuleConfig getModuleConfig(javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext context)
          Return the ModuleConfig object is it exists, null otherwise.
 ModuleConfig getModuleConfig(java.lang.String prefix, javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext context)
          Return the desired ModuleConfig object stored in context, if it exists, otherwise return the current ModuleConfig
 ModuleConfig getModuleConfig(java.lang.String prefix, javax.servlet.ServletContext context)
          Return the desired ModuleConfig object stored in context, if it exists, null otherwise.
 java.lang.String getModuleName(javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext context)
          Get the module name to which the specified request belong.
 java.lang.String getModuleName(java.lang.String matchPath, javax.servlet.ServletContext context)
          Get the module name to which the specified uri belong.
 java.lang.String[] getModulePrefixes(javax.servlet.ServletContext context)
          Return the list of module prefixes that are defined for this web application.
 void selectModule(javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext context)
          Select the module to which the specified request belongs, and add corresponding request attributes to this request.
 void selectModule(java.lang.String prefix, javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext context)
          Select the module to which the specified request belongs, and add corresponding request attributes to this request.
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Field Detail

instance

private static final ModuleUtils instance
The Singleton instance.

log

private static final org.apache.commons.logging.Log log
Commons logging instance.
Constructor Detail

ModuleUtils

protected ModuleUtils()
Constructor for ModuleUtils.
Method Detail

getInstance

public static ModuleUtils getInstance()
Returns the Singleton instance of TagUtils.

getModuleConfig

public ModuleConfig getModuleConfig(javax.servlet.http.HttpServletRequest request)
Return the current ModuleConfig object stored in request, if it exists, null otherwise. This method can be used by plugin to retrieve the current module config object. If no moduleConfig is found, this means that the request haven't hit the server throught the struts servlet. The appropriate module config can be set and found with RequestUtils.selectModule(HttpServletRequest, ServletContext) .
Parameters:
request - The servlet request we are processing
Returns:
the ModuleConfig object from request, or null if none is set in the request.

getModuleConfig

public ModuleConfig getModuleConfig(java.lang.String prefix,
                                    javax.servlet.ServletContext context)
Return the desired ModuleConfig object stored in context, if it exists, null otherwise.
Parameters:
prefix - The module prefix of the desired module
context - The ServletContext for this web application
Returns:
the ModuleConfig object specified, or null if not found in the context.

getModuleConfig

public ModuleConfig getModuleConfig(java.lang.String prefix,
                                    javax.servlet.http.HttpServletRequest request,
                                    javax.servlet.ServletContext context)
Return the desired ModuleConfig object stored in context, if it exists, otherwise return the current ModuleConfig
Parameters:
prefix - The module prefix of the desired module
request - The servlet request we are processing
context - The ServletContext for this web application
Returns:
the ModuleConfig object specified, or null if not found in the context.

getModuleConfig

public ModuleConfig getModuleConfig(javax.servlet.http.HttpServletRequest request,
                                    javax.servlet.ServletContext context)
Return the ModuleConfig object is it exists, null otherwise.
Parameters:
request - The servlet request we are processing
context - The ServletContext for this web application
Returns:
the ModuleConfig object

getModuleName

public java.lang.String getModuleName(javax.servlet.http.HttpServletRequest request,
                                      javax.servlet.ServletContext context)
Get the module name to which the specified request belong.
Parameters:
request - The servlet request we are processing
context - The ServletContext for this web application
Returns:
The module prefix or ""

getModuleName

public java.lang.String getModuleName(java.lang.String matchPath,
                                      javax.servlet.ServletContext context)
Get the module name to which the specified uri belong.
Parameters:
matchPath - The uri from which we want the module name.
context - The ServletContext for this web application
Returns:
The module prefix or ""

getModulePrefixes

public java.lang.String[] getModulePrefixes(javax.servlet.ServletContext context)
Return the list of module prefixes that are defined for this web application. NOTE - the "" prefix for the default module is not included in this list.
Parameters:
context - The ServletContext for this web application.
Returns:
An array of module prefixes.

selectModule

public void selectModule(javax.servlet.http.HttpServletRequest request,
                         javax.servlet.ServletContext context)
Select the module to which the specified request belongs, and add corresponding request attributes to this request.
Parameters:
request - The servlet request we are processing
context - The ServletContext for this web application

selectModule

public void selectModule(java.lang.String prefix,
                         javax.servlet.http.HttpServletRequest request,
                         javax.servlet.ServletContext context)
Select the module to which the specified request belongs, and add corresponding request attributes to this request.
Parameters:
prefix - The module prefix of the desired module
request - The servlet request we are processing
context - The ServletContext for this web application


Copyright © 2000-2005 - The Apache Software Foundation