Overview  Package   Class  Tree  Serialized  Deprecated  Index  Help 

com.ibm.wps.portlets.struts.plugins
Class ViewCommandFactory

java.lang.Object
  extended bycom.ibm.wps.portlets.struts.plugins.ViewCommandFactory

public class ViewCommandFactory
extends java.lang.Object

The ViewCommandFactory class is the default factory used in the Struts Portlet Framework. The ViewComandFactory will process the URI and determine the correct type of WpsStrutsViewCommand to create. The createCommand method will determine the type of WpsStrutsViewCommand object to create based on the extension. For example, a URI path of "/login.jsp" will result in the creation of a WpsStrutsViewJspCommand. This class can be extended to allow the application to add new extension types that should result in the creation of a new type of WpsStrutsViewCommand. The ViewCommandFactories are registered per Struts module. A Struts plugin can be used to determine which ViewCommandFactory is used for each Struts module.

Since:
5.1

Field Summary
protected static org.apache.commons.logging.Log log
          The commons-logging instance for this class.
 

Constructor Summary
ViewCommandFactory()
          Default constructor for the ViewCommandFactory class.
 

Method Summary
 WpsStrutsViewCommand createCommand(ErrorResponseInfo errorInfo, javax.servlet.http.HttpServletRequest request, ViewCommandExecutionContext executionContext)
          Creates a command based on the given ErrorResponseInfo.
 WpsStrutsViewCommand createCommand(java.lang.String uri, javax.servlet.http.HttpServletRequest request, ViewCommandExecutionContext executionContext)
          Creates a command based on the given URI and request.
protected  java.lang.String getExtensionLowerCase(java.lang.String uri)
          Gets the extension from the given String URI.
protected  java.lang.String getExtensionUpperCase(java.lang.String uri)
          Gets the extension from the given String URI.
static ViewCommandFactory getFactory(com.ibm.wps.struts.common.ModuleContext moduleContext)
          Gets the ViewCommandFactory object for this context.
static ViewCommandFactory getFactory(ViewCommandExecutionContext viewCommandContext)
          Gets the ViewCommandFactory object for the module.
protected  WpsStrutsViewCommand handleUnrecognizedExtension(java.lang.String uri, javax.servlet.http.HttpServletRequest request, ViewCommandExecutionContext executionContext)
          Handles an unrecognized extension.
protected  boolean isDynamicallyIncludedContent(java.lang.String uri)
          Determines whether the given path can be included dynamically (like a JSP).
protected  boolean isDynamicallyIncludedContent(java.lang.String uri, java.lang.String extLowerCase)
          Determines whether the given path can be included dynamically (like a JSP).
protected  boolean isStaticallyIncludedContent(java.lang.String uri)
          Determines whether the given path can be included statically (like HTML).
protected  boolean isStaticallyIncludedContent(java.lang.String uri, java.lang.String extLowerCase)
          Determines whether the given path can be included statically (like HTML).
protected  boolean isTilesIncludedContent(java.lang.String uri, java.lang.String extLowerCase, javax.servlet.http.HttpServletRequest request)
          Determines whether the given path can be included as a Struts Tiles JSP.
static void setFactory(com.ibm.wps.struts.common.ModuleContext moduleContext, ViewCommandFactory factory)
          Sets a new ViewCommandFactory object.
 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

log

protected static org.apache.commons.logging.Log log
The commons-logging instance for this class.

Constructor Detail

ViewCommandFactory

public ViewCommandFactory()
Default constructor for the ViewCommandFactory class.

Method Detail

setFactory

public static void setFactory(com.ibm.wps.struts.common.ModuleContext moduleContext,
                              ViewCommandFactory factory)
Sets a new ViewCommandFactory object.

Parameters:
moduleContext - the module context
factory - the ViewCommandFactory object

getFactory

public static ViewCommandFactory getFactory(com.ibm.wps.struts.common.ModuleContext moduleContext)
Gets the ViewCommandFactory object for this context.

Parameters:
moduleContext - the module context to use to find the factory
Returns:
returns the ViewCommandFactory

getFactory

public static ViewCommandFactory getFactory(ViewCommandExecutionContext viewCommandContext)
Gets the ViewCommandFactory object for the module.

Parameters:
viewCommandContext - the ViewCommandExecutionContext object
Returns:
returns the ViewCommandFactory

createCommand

public WpsStrutsViewCommand createCommand(java.lang.String uri,
                                          javax.servlet.http.HttpServletRequest request,
                                          ViewCommandExecutionContext executionContext)
Creates a command based on the given URI and request.

Parameters:
uri - path to resource
request - the request object
executionContext - the ViewCommandExecutionContext object
Returns:
returns a WpsStrutsViewCommand or null

createCommand

public WpsStrutsViewCommand createCommand(ErrorResponseInfo errorInfo,
                                          javax.servlet.http.HttpServletRequest request,
                                          ViewCommandExecutionContext executionContext)
Creates a command based on the given ErrorResponseInfo. Creates a WpsStrutsViewErrorCommand object.

Parameters:
errorInfo - ErrorResponseInfo
request - the request
Returns:
returns a WpsStrutsViewCommand object

isStaticallyIncludedContent

protected boolean isStaticallyIncludedContent(java.lang.String uri)
Determines whether the given path can be included statically (like HTML). The analysis is usually based on the extension.

Parameters:
uri - path to resource
Returns:
returns boolean true if the URI is statically included content

isStaticallyIncludedContent

protected boolean isStaticallyIncludedContent(java.lang.String uri,
                                              java.lang.String extLowerCase)
Determines whether the given path can be included statically (like HTML). The analysis is usually based on the extension.

Parameters:
uri - path to resource
extLowerCase - the file extension in lower case
Returns:
returns boolean true if the URI is statically included content

isDynamicallyIncludedContent

protected boolean isDynamicallyIncludedContent(java.lang.String uri)
Determines whether the given path can be included dynamically (like a JSP). The analysis is usually based on the extension.

Parameters:
uri - path to resource
Returns:
returns boolean true if the URI is dynamically included content

isDynamicallyIncludedContent

protected boolean isDynamicallyIncludedContent(java.lang.String uri,
                                               java.lang.String extLowerCase)
Determines whether the given path can be included dynamically (like a JSP). The analysis is usually based on the extension.

Parameters:
uri - path to resource
extLowerCase - file extension from path in lower case
Returns:
returns boolean true if the URI is dynamically included content

isTilesIncludedContent

protected boolean isTilesIncludedContent(java.lang.String uri,
                                         java.lang.String extLowerCase,
                                         javax.servlet.http.HttpServletRequest request)
Determines whether the given path can be included as a Struts Tiles JSP. The analysis is usually based on the extension and presence of the request attribute WpsStrutsConstants.TILES_DEFINITION.

Parameters:
uri - path to resource
extLowerCase - file extension from path in lower case
request - the request object
Returns:
returns boolean true if the URI is Tiles included content

handleUnrecognizedExtension

protected WpsStrutsViewCommand handleUnrecognizedExtension(java.lang.String uri,
                                                           javax.servlet.http.HttpServletRequest request,
                                                           ViewCommandExecutionContext executionContext)
Handles an unrecognized extension. This implementation treats the page as something that is dynamic content, but this can be overridden.

Parameters:
uri - path to resource
request - the request we are processing
executionContext - the ViewCommandExecutionContext object
Returns:
returns the command object to handle the uri

getExtensionLowerCase

protected java.lang.String getExtensionLowerCase(java.lang.String uri)
Gets the extension from the given String URI. Return null if no extension found.

Parameters:
uri - path to resource
Returns:
returns the extension in lower case or null otherwise

getExtensionUpperCase

protected java.lang.String getExtensionUpperCase(java.lang.String uri)
Gets the extension from the given String URI. Return null if no extension found.

Parameters:
uri - path to resource
Returns:
returns the extension in upper case or null otherwise

Overview  Package   Class  Tree  Serialized  Deprecated  Index  Help 

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.