| ScreenFlowManager.java |
/* Copyright 2003 Sun Microsystems, Inc. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
- Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
- Redistribution in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
Neither the name of Sun Microsystems, Inc. or the names of
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
This software is provided "AS IS," without a warranty of any
kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES
SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN
OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR
FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF
LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE,
EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
You acknowledge that Software is not designed, licensed or intended
for use in the design, construction, operation or maintenance of
any nuclear facility.
$Id: ScreenFlowManager.java,v 1.3 2003/03/10 23:06:30 gmurray Exp $ */
package com.sun.j2ee.blueprints.waf.controller.web;
import javax.servlet.http.*;
import javax.servlet.*;
import java.util.*;
// waf imports
import com.sun.j2ee.blueprints.waf.controller.web.util.WebKeys;
import com.sun.j2ee.blueprints.util.tracer.Debug;
/**
* This file looks at the Request URL and maps the request
* to the page for the web-templating mechanism.
*/
public class ScreenFlowManager implements java.io.Serializable {
private HashMap screens;
private HashMap urlMappings;
private ArrayList exceptionMappings;
private HashMap screenDefinitionMappings;
private String defaultScreen = "";
private ServletContext context;
public ScreenFlowManager() {
screens = new HashMap();
}
public void init(ServletContext context) {
this.context = context;
String requestMappingsURL = null;
try {
requestMappingsURL = context.getResource("/WEB-INF/mappings.xml").toString();
} catch (java.net.MalformedURLException ex) {
System.err.println("ScreenFlowManager: initializing ScreenFlowManager malformed URL exception: " + ex);
}
urlMappings = (HashMap)context.getAttribute(WebKeys.URL_MAPPINGS);
ScreenFlowData screenFlowData = URLMappingsXmlDAO.loadScreenFlowData(requestMappingsURL);
defaultScreen = screenFlowData.getDefaultScreen();
exceptionMappings = screenFlowData.getExceptionMappings();
}
/**
* The UrlMapping object contains information that will match
* a url to a mapping object that contains information about
* the current screen, the WebAction that is needed to
* process a request, and the WebAction that is needed
* to insure that the propper screen is displayed.
*/
private URLMapping getURLMapping(String urlPattern) {
if ((urlMappings != null) && urlMappings.containsKey(urlPattern)) {
return (URLMapping)urlMappings.get(urlPattern);
} else {
return null;
}
}
/**
* Using the information we have in the request along with
* The url map for the current url we will insure that the
* propper current screen is selected based on the settings
* in both the screendefinitions.xml file and requestmappings.xml
* files.
*/
public void forwardToNextScreen(HttpServletRequest request, HttpServletResponse response)
throws java.io.IOException, FlowHandlerException, javax.servlet.ServletException {
// set the presious screen
String fullURL = request.getRequestURI();
// get the screen name
String selectedURL = defaultScreen;
int lastPathSeparator = fullURL.lastIndexOf("/") + 1;
if (lastPathSeparator != -1) {
selectedURL = fullURL.substring(lastPathSeparator, fullURL.length());
}
String currentScreen = "";
URLMapping urlMapping = getURLMapping(selectedURL);
if (urlMapping != null) {
if (!urlMapping.useFlowHandler()) {
currentScreen = urlMapping.getScreen();
} else {
// load the flow handler
FlowHandler handler = null;
String flowHandlerString = urlMapping.getFlowHandler();
try {
handler = (FlowHandler)getClass().getClassLoader().loadClass(flowHandlerString).newInstance();
// invoke the processFlow(HttpServletRequest)
handler.doStart(request);
String flowResult = handler.processFlow(request);
handler.doEnd(request);
currentScreen = urlMapping.getResultScreen(flowResult);
// if there were no screens by the id then assume that the result was
//the screen itself
if (currentScreen == null) currentScreen = flowResult;
} catch (Exception ex) {
System.err.println("ScreenFlowManager caught loading handler: " + ex);
}
}
}
if (currentScreen == null) {
throw new RuntimeException("Screen not found for " + selectedURL);
}
context.getRequestDispatcher("/" + currentScreen).forward(request, response);
}
/**
go through the list and use the Class.isAssignableFrom(Class method)
to see it is a subclass of one of the exceptions
*/
public String getExceptionScreen(Throwable e) {
Iterator it = exceptionMappings.iterator();
while (it.hasNext()) {
ErrorMapping em = (ErrorMapping)it.next();
String exceptionName = em.getExceptionClassName();
// check if the exception is a sub class of matches the exception
if (exceptionName.equals(e.getClass().getName())) {
return "/" + (em.getScreenName());
}
}
return null;
}
public void setDefaultScreen(String defaultScreen) {
this.defaultScreen = defaultScreen;
}
/**
* Returs the current screen
*/
public String getCurrentScreen(HttpSession session) {
return (String)session.getAttribute(WebKeys.CURRENT_SCREEN);
}
}
| ScreenFlowManager.java |