container/catalina/src/share/org/apache/catalina/ssi/SSIServletExternalResolver.java - tomcat55 - Git at Google

 /*
  * Copyright 1999,2004 The Apache Software Foundation.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 package org.apache.catalina.ssi;

 import java.io.IOException;
 import java.net.URL;
 import java.net.URLConnection;
 import java.net.URLDecoder;
 import java.util.Collection;
 import java.util.Date;
 import java.util.Enumeration;

 import javax.servlet.RequestDispatcher;
 import javax.servlet.ServletContext;
 import javax.servlet.ServletException;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

 /**
  * An implementation of SSIExternalResolver that is used with servlets.
  *
  * @author Dan Sandberg
  * @version $Revision$, $Date$
  */
 public class SSIServletExternalResolver implements SSIExternalResolver {
     protected final String VARIABLE_NAMES[] = {
 	"AUTH_TYPE","CONTENT_LENGTH","CONTENT_TYPE","DOCUMENT_NAME",
 	"DOCUMENT_URI","GATEWAY_INTERFACE","PATH_INFO", "PATH_TRANSLATED",
 	"QUERY_STRING","QUERY_STRING_UNESCAPED","REMOTE_ADDR","REMOTE_HOST",
 	"REMOTE_USER","REQUEST_METHOD","SCRIPT_NAME","SERVER_NAME","SERVER_PORT",
 	"SERVER_PROTOCOL","SERVER_SOFTWARE" };

     protected HttpServlet servlet;
     protected HttpServletRequest req;
     protected HttpServletResponse res;
     protected boolean isVirtualWebappRelative;
     protected int debug;

     public SSIServletExternalResolver( HttpServlet servlet, HttpServletRequest req, HttpServletResponse res,
 				       boolean isVirtualWebappRelative,
 				       int debug ) {
 	this.servlet = servlet;
 	this.req = req;
 	this.res = res;
 	this.isVirtualWebappRelative = isVirtualWebappRelative;
 	this.debug = debug;
     }

     public void log( String message, Throwable throwable ) {
 	//We can't assume that Servlet.log( message, null )
 	//is the same as Servlet.log( message ), since API
 	//doesn't seem to say so.
 	if ( throwable != null ) {
 	    servlet.log( message, throwable );
 	} else {
 	    servlet.log( message );
 	}
     }

     public void addVariableNames( Collection variableNames ) {
 	for ( int i=0; i < VARIABLE_NAMES.length; i++ ) {
 	    String variableName = VARIABLE_NAMES[ i ];
 	    String variableValue = getVariableValue( variableName );
 	    if ( variableValue != null ) {
 		variableNames.add( variableName );
 	    }
 	}
 	Enumeration e = req.getAttributeNames();
 	while ( e.hasMoreElements() ) {
 	    String name = (String) e.nextElement();
 	    if ( !isNameReserved( name ) ) {
 		variableNames.add( name );
 	    }
 	}
     }

     protected Object getReqAttributeIgnoreCase( String targetName ) {
 	Object object = null;

 	if ( !isNameReserved( targetName ) ) {
 	    object = req.getAttribute( targetName );
 	    if ( object == null ) {
 		Enumeration e = req.getAttributeNames();
 		while ( e.hasMoreElements() ) {
 		    String name = (String) e.nextElement();
 		    if ( targetName.equalsIgnoreCase( name ) &&
 			 !isNameReserved( name ) ) {

 			object = req.getAttribute( name );
 			if ( object != null ) {
 			    break;
 			}
 		    }
 		}
 	    }
 	}
 	return object;
     }

     protected boolean isNameReserved( String name ) {
 	return
 	    name.startsWith("java.") ||
 	    name.startsWith("javax.") ||
 	    name.startsWith("sun.");
     }

     public void setVariableValue( String name, String value ) {
 	if ( !isNameReserved( name ) ) {
 	    req.setAttribute( name, value );
 	}
     }

     public String getVariableValue( String name ) {
 	String retVal = null;

 	Object object = getReqAttributeIgnoreCase( name );
 	if ( object != null ) {
 	    retVal = object.toString();
 	} else {
 	    retVal = getCGIVariable( name );
 	}
 	return retVal;
     }

     protected String getCGIVariable( String name ) {
 	String retVal = null;

 	if ( name.equalsIgnoreCase( "AUTH_TYPE" ) ) {
 	    retVal = req.getAuthType();
 	} else if ( name.equalsIgnoreCase( "CONTENT_LENGTH" ) ) {
 	    int contentLength = req.getContentLength();
 	    if ( contentLength >= 0 ) {
 		retVal = Integer.toString( contentLength );
 	    }
 	} else if ( name.equalsIgnoreCase( "CONTENT_TYPE" ) ) {
 	    retVal = req.getContentType();
 	} else if ( name.equalsIgnoreCase( "DOCUMENT_NAME" ) ) {
 	    String requestURI = req.getRequestURI();
 	    retVal = requestURI.substring( requestURI.lastIndexOf('/') + 1 );
 	} else if ( name.equalsIgnoreCase( "DOCUMENT_URI" ) ) {
 	    retVal = req.getRequestURI();
 	} else if ( name.equalsIgnoreCase( "GATEWAY_INTERFACE" ) ) {
 	    retVal = "CGI/1.1";
 	} else if ( name.equalsIgnoreCase( "PATH_INFO" ) ) {
 	    retVal = req.getPathInfo();
 	} else if ( name.equalsIgnoreCase( "PATH_TRANSLATED" ) ) {
 	    retVal = req.getPathTranslated();
 	} else if ( name.equalsIgnoreCase( "QUERY_STRING" ) ) {
 	    //apache displays this as an empty string rather than (none)
 	    retVal = nullToEmptyString( req.getQueryString() );
 	} else if ( name.equalsIgnoreCase( "QUERY_STRING_UNESCAPED" ) ) {
 	    String queryString = req.getQueryString();
 	    if ( queryString != null ) {
 		retVal = URLDecoder.decode( queryString );
 	    }
 	} else if ( name.equalsIgnoreCase( "REMOTE_ADDR" ) ) {
 	    retVal = req.getRemoteAddr();
 	} else if ( name.equalsIgnoreCase( "REMOTE_HOST" ) ) {
 	    retVal = req.getRemoteHost();
 	} else if ( name.equalsIgnoreCase( "REMOTE_USER" ) ) {
 	    retVal = req.getRemoteUser();
 	} else if ( name.equalsIgnoreCase( "REQUEST_METHOD" ) ) {
 	    retVal = req.getMethod();
 	} else if ( name.equalsIgnoreCase( "SCRIPT_NAME" ) ) {
 	    retVal = req.getServletPath();
 	} else if ( name.equalsIgnoreCase( "SERVER_NAME" ) ) {
 	    retVal = req.getServerName();
 	} else if ( name.equalsIgnoreCase( "SERVER_PORT" ) ) {
 	    retVal = Integer.toString( req.getServerPort() );
 	} else if ( name.equalsIgnoreCase( "SERVER_PROTOCOL" ) ) {
 	    retVal = req.getProtocol();
 	} else if ( name.equalsIgnoreCase( "SERVER_SOFTWARE" ) ) {
 	    ServletContext servletContext = servlet.getServletContext();
 	    retVal = servletContext.getServerInfo();
 	}
 	return retVal;
     }

     public Date getCurrentDate() {
 	return new Date();
     }

     protected String nullToEmptyString( String string ) {
 	String retVal = string;

 	if ( retVal == null ) {
 	    retVal="";
 	}
 	return retVal;
     }


     protected String getPathWithoutFileName( String servletPath ) {
 	String retVal = null;

 	int lastSlash = servletPath.lastIndexOf('/');
 	if ( lastSlash >= 0 ) {
 	    //cut off file namee
 	    retVal = servletPath.substring( 0, lastSlash + 1 );
 	}
 	return retVal;
     }

     protected String getPathWithoutContext( String servletPath ) {
 	String retVal = null;

 	int secondSlash = servletPath.indexOf('/', 1 );
 	if ( secondSlash >= 0 ) {
 	    //cut off context
 	    retVal = servletPath.substring( secondSlash );
 	}
 	return retVal;
     }

     protected String getAbsolutePath( String path ) throws IOException {
 	String pathWithoutContext = SSIServletRequestUtil.getRelativePath( req );
 	String prefix = getPathWithoutFileName( pathWithoutContext );
 	if ( prefix == null ) {
 	    throw new IOException("Couldn't remove filename from path: " + pathWithoutContext );
 	}
 	String fullPath = prefix + path;
 	String retVal = SSIServletRequestUtil.normalize( fullPath );

 	if ( retVal == null ) {
 	    throw new IOException("Normalization yielded null on path: " + fullPath );
 	}
 	return retVal;
     }

     protected ServletContextAndPath getServletContextAndPathFromNonVirtualPath( String nonVirtualPath ) throws IOException {
 	if ( nonVirtualPath.startsWith("/") || nonVirtualPath.startsWith("\\") ) {
 	    throw new IOException("A non-virtual path can't be absolute: " + nonVirtualPath );
 	}

 	if ( nonVirtualPath.indexOf("../") >= 0 ) {
 	    throw new IOException("A non-virtual path can't contain '../' : " + nonVirtualPath );
 	}

 	String path = getAbsolutePath( nonVirtualPath );

 	ServletContext servletContext = servlet.getServletContext();
 	ServletContextAndPath csAndP = new ServletContextAndPath( servletContext, path );
 	return csAndP;
     }


     protected ServletContextAndPath getServletContextAndPathFromVirtualPath( String virtualPath ) throws IOException {
 	ServletContext servletContext = servlet.getServletContext();
 	String path = null;

 	if ( !virtualPath.startsWith("/") &&  !virtualPath.startsWith("\\") ) {
 	    path = getAbsolutePath( virtualPath );
 	} else {
 	    String normalized = SSIServletRequestUtil.normalize( virtualPath );
 	    if ( isVirtualWebappRelative ) {
 		path = normalized;
 	    } else {
 		servletContext = servletContext.getContext( normalized );
 		if ( servletContext == null ) {
 		    throw new IOException("Couldn't get context for path: " + normalized );
 		}

 		//If it's the root context, then there is no context element to remove, ie:
 		// '/file1.shtml' vs '/appName1/file1.shtml'
 		if ( !isRootContext( servletContext ) ) {
 		    path = getPathWithoutContext( normalized );
 		    if ( path == null ) {
 			throw new IOException("Couldn't remove context from path: " + normalized );
 		    }
 		} else {
 		    path = normalized;
 		}
 	    }
 	}
 	return new ServletContextAndPath( servletContext, path );
     }

     //Assumes servletContext is not-null
     //Assumes that identity comparison will be true for the same context
     //Assuming the above, getContext("/") will be non-null as long as the root context is accessible.
     //If it isn't, then servletContext can't be the root context anyway, hence they will not match.
     protected boolean isRootContext( ServletContext servletContext ) {
 	return servletContext == servletContext.getContext( "/" );
     }

     protected ServletContextAndPath getServletContextAndPath( String originalPath, boolean virtual ) throws IOException {
 	ServletContextAndPath csAndP = null;

 	if ( debug > 0 ) {
 	    log("SSIServletExternalResolver.getServletContextAndPath( " + originalPath + ", " + virtual + ")" , null);
 	}
 	if ( virtual ) {
 	    csAndP = getServletContextAndPathFromVirtualPath( originalPath );
 	} else {
 	    csAndP = getServletContextAndPathFromNonVirtualPath( originalPath );
 	}
 	return csAndP;
     }

     protected URLConnection getURLConnection( String originalPath, boolean virtual ) throws IOException {
 	ServletContextAndPath csAndP = getServletContextAndPath( originalPath, virtual );
 	ServletContext context = csAndP.getServletContext();
 	String path = csAndP.getPath();

 	URL url = context.getResource( path );
 	if ( url == null ) {
 	    throw new IOException("Context did not contain resource: " + path );
 	}
 	URLConnection urlConnection = url.openConnection();
 	return urlConnection;
     }

     public long getFileLastModified( String path, boolean virtual ) throws IOException {
 	long lastModified = 0;

 	URLConnection urlConnection = getURLConnection( path, virtual );
 	lastModified = urlConnection.getLastModified();
 	return lastModified;
     }

     public long getFileSize( String path, boolean virtual ) throws IOException {
 	long fileSize = -1;

 	URLConnection urlConnection = getURLConnection( path, virtual );
 	fileSize = urlConnection.getContentLength();
 	return fileSize;
     }

     //We are making lots of unnecessary copies of the included data here.  If someone ever complains that this
     //is slow, we should connect the included stream to the print writer that SSICommand uses.
     public String getFileText( String originalPath, boolean virtual ) throws IOException {
 	try {
 	    ServletContextAndPath csAndP = getServletContextAndPath( originalPath, virtual );
 	    ServletContext context = csAndP.getServletContext();
 	    String path = csAndP.getPath();

 	    RequestDispatcher rd =
 		context.getRequestDispatcher( path );
 	    if ( rd == null ) {
 		throw new IOException("Couldn't get request dispatcher for path: " + path );
 	    }
 	    ByteArrayServletOutputStream basos = new ByteArrayServletOutputStream();
 	    ResponseIncludeWrapper responseIncludeWrapper =
 		new ResponseIncludeWrapper(res, basos );
 	    rd.include(req, responseIncludeWrapper );

 	    //We can't assume the included servlet flushed its output
 	    responseIncludeWrapper.flushOutputStreamOrWriter();
 	    byte[] bytes = basos.toByteArray();

 	    //Assume that the default encoding is what was used to encode the bytes. Questionable.
 	    String retVal = new String( bytes );

 	    //make an assumption that an empty response is a failure.  This is a problem if a truly empty file
 	    //were included, but not sure how else to tell.
 	    if ( retVal.equals("") ) {
 		throw new IOException("Couldn't find file: " + path );
 	    }
 	    return retVal;
 	} catch (ServletException e) {
 	    throw new IOException("Couldn't include file: " + originalPath + " because of ServletException: " + e.getMessage() );
 	}
     }

     protected class ServletContextAndPath {
 	protected ServletContext servletContext;
 	protected String path;

 	public ServletContextAndPath( ServletContext servletContext, String path ) {
 	    this.servletContext = servletContext;
 	    this.path = path;
 	}

 	public ServletContext getServletContext() {
 	    return servletContext;
 	}

 	public String getPath() {
 	    return path;
 	}
     }
 }
	/*
	* Copyright 1999,2004 The Apache Software Foundation.
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package org.apache.catalina.ssi;

	import java.io.IOException;
	import java.net.URL;
	import java.net.URLConnection;
	import java.net.URLDecoder;
	import java.util.Collection;
	import java.util.Date;
	import java.util.Enumeration;

	import javax.servlet.RequestDispatcher;
	import javax.servlet.ServletContext;
	import javax.servlet.ServletException;
	import javax.servlet.http.HttpServlet;
	import javax.servlet.http.HttpServletRequest;
	import javax.servlet.http.HttpServletResponse;

	/**
	* An implementation of SSIExternalResolver that is used with servlets.
	*
	* @author Dan Sandberg
	* @version $Revision$, $Date$
	*/
	public class SSIServletExternalResolver implements SSIExternalResolver {
	protected final String VARIABLE_NAMES[] = {
	"AUTH_TYPE","CONTENT_LENGTH","CONTENT_TYPE","DOCUMENT_NAME",
	"DOCUMENT_URI","GATEWAY_INTERFACE","PATH_INFO", "PATH_TRANSLATED",
	"QUERY_STRING","QUERY_STRING_UNESCAPED","REMOTE_ADDR","REMOTE_HOST",
	"REMOTE_USER","REQUEST_METHOD","SCRIPT_NAME","SERVER_NAME","SERVER_PORT",
	"SERVER_PROTOCOL","SERVER_SOFTWARE" };

	protected HttpServlet servlet;
	protected HttpServletRequest req;
	protected HttpServletResponse res;
	protected boolean isVirtualWebappRelative;
	protected int debug;

	public SSIServletExternalResolver( HttpServlet servlet, HttpServletRequest req, HttpServletResponse res,
	boolean isVirtualWebappRelative,
	int debug ) {
	this.servlet = servlet;
	this.req = req;
	this.res = res;
	this.isVirtualWebappRelative = isVirtualWebappRelative;
	this.debug = debug;
	}

	public void log( String message, Throwable throwable ) {
	//We can't assume that Servlet.log( message, null )
	//is the same as Servlet.log( message ), since API
	//doesn't seem to say so.
	if ( throwable != null ) {
	servlet.log( message, throwable );
	} else {
	servlet.log( message );
	}
	}

	public void addVariableNames( Collection variableNames ) {
	for ( int i=0; i < VARIABLE_NAMES.length; i++ ) {
	String variableName = VARIABLE_NAMES[ i ];
	String variableValue = getVariableValue( variableName );
	if ( variableValue != null ) {
	variableNames.add( variableName );
	}
	}
	Enumeration e = req.getAttributeNames();
	while ( e.hasMoreElements() ) {
	String name = (String) e.nextElement();
	if ( !isNameReserved( name ) ) {
	variableNames.add( name );
	}
	}
	}

	protected Object getReqAttributeIgnoreCase( String targetName ) {
	Object object = null;

	if ( !isNameReserved( targetName ) ) {
	object = req.getAttribute( targetName );
	if ( object == null ) {
	Enumeration e = req.getAttributeNames();
	while ( e.hasMoreElements() ) {
	String name = (String) e.nextElement();
	if ( targetName.equalsIgnoreCase( name ) &&
	!isNameReserved( name ) ) {

	object = req.getAttribute( name );
	if ( object != null ) {
	break;
	}
	}
	}
	}
	}
	return object;
	}

	protected boolean isNameReserved( String name ) {
	return
	name.startsWith("java.") \|\|
	name.startsWith("javax.") \|\|
	name.startsWith("sun.");
	}

	public void setVariableValue( String name, String value ) {
	if ( !isNameReserved( name ) ) {
	req.setAttribute( name, value );
	}
	}

	public String getVariableValue( String name ) {
	String retVal = null;

	Object object = getReqAttributeIgnoreCase( name );
	if ( object != null ) {
	retVal = object.toString();
	} else {
	retVal = getCGIVariable( name );
	}
	return retVal;
	}

	protected String getCGIVariable( String name ) {
	String retVal = null;

	if ( name.equalsIgnoreCase( "AUTH_TYPE" ) ) {
	retVal = req.getAuthType();
	} else if ( name.equalsIgnoreCase( "CONTENT_LENGTH" ) ) {
	int contentLength = req.getContentLength();
	if ( contentLength >= 0 ) {
	retVal = Integer.toString( contentLength );
	}
	} else if ( name.equalsIgnoreCase( "CONTENT_TYPE" ) ) {
	retVal = req.getContentType();
	} else if ( name.equalsIgnoreCase( "DOCUMENT_NAME" ) ) {
	String requestURI = req.getRequestURI();
	retVal = requestURI.substring( requestURI.lastIndexOf('/') + 1 );
	} else if ( name.equalsIgnoreCase( "DOCUMENT_URI" ) ) {
	retVal = req.getRequestURI();
	} else if ( name.equalsIgnoreCase( "GATEWAY_INTERFACE" ) ) {
	retVal = "CGI/1.1";
	} else if ( name.equalsIgnoreCase( "PATH_INFO" ) ) {
	retVal = req.getPathInfo();
	} else if ( name.equalsIgnoreCase( "PATH_TRANSLATED" ) ) {
	retVal = req.getPathTranslated();
	} else if ( name.equalsIgnoreCase( "QUERY_STRING" ) ) {
	//apache displays this as an empty string rather than (none)
	retVal = nullToEmptyString( req.getQueryString() );
	} else if ( name.equalsIgnoreCase( "QUERY_STRING_UNESCAPED" ) ) {
	String queryString = req.getQueryString();
	if ( queryString != null ) {
	retVal = URLDecoder.decode( queryString );
	}
	} else if ( name.equalsIgnoreCase( "REMOTE_ADDR" ) ) {
	retVal = req.getRemoteAddr();
	} else if ( name.equalsIgnoreCase( "REMOTE_HOST" ) ) {
	retVal = req.getRemoteHost();
	} else if ( name.equalsIgnoreCase( "REMOTE_USER" ) ) {
	retVal = req.getRemoteUser();
	} else if ( name.equalsIgnoreCase( "REQUEST_METHOD" ) ) {
	retVal = req.getMethod();
	} else if ( name.equalsIgnoreCase( "SCRIPT_NAME" ) ) {
	retVal = req.getServletPath();
	} else if ( name.equalsIgnoreCase( "SERVER_NAME" ) ) {
	retVal = req.getServerName();
	} else if ( name.equalsIgnoreCase( "SERVER_PORT" ) ) {
	retVal = Integer.toString( req.getServerPort() );
	} else if ( name.equalsIgnoreCase( "SERVER_PROTOCOL" ) ) {
	retVal = req.getProtocol();
	} else if ( name.equalsIgnoreCase( "SERVER_SOFTWARE" ) ) {
	ServletContext servletContext = servlet.getServletContext();
	retVal = servletContext.getServerInfo();
	}
	return retVal;
	}

	public Date getCurrentDate() {
	return new Date();
	}

	protected String nullToEmptyString( String string ) {
	String retVal = string;

	if ( retVal == null ) {
	retVal="";
	}
	return retVal;
	}


	protected String getPathWithoutFileName( String servletPath ) {
	String retVal = null;

	int lastSlash = servletPath.lastIndexOf('/');
	if ( lastSlash >= 0 ) {
	//cut off file namee
	retVal = servletPath.substring( 0, lastSlash + 1 );
	}
	return retVal;
	}

	protected String getPathWithoutContext( String servletPath ) {
	String retVal = null;

	int secondSlash = servletPath.indexOf('/', 1 );
	if ( secondSlash >= 0 ) {
	//cut off context
	retVal = servletPath.substring( secondSlash );
	}
	return retVal;
	}

	protected String getAbsolutePath( String path ) throws IOException {
	String pathWithoutContext = SSIServletRequestUtil.getRelativePath( req );
	String prefix = getPathWithoutFileName( pathWithoutContext );
	if ( prefix == null ) {
	throw new IOException("Couldn't remove filename from path: " + pathWithoutContext );
	}
	String fullPath = prefix + path;
	String retVal = SSIServletRequestUtil.normalize( fullPath );

	if ( retVal == null ) {
	throw new IOException("Normalization yielded null on path: " + fullPath );
	}
	return retVal;
	}

	protected ServletContextAndPath getServletContextAndPathFromNonVirtualPath( String nonVirtualPath ) throws IOException {
	if ( nonVirtualPath.startsWith("/") \|\| nonVirtualPath.startsWith("\\") ) {
	throw new IOException("A non-virtual path can't be absolute: " + nonVirtualPath );
	}

	if ( nonVirtualPath.indexOf("../") >= 0 ) {
	throw new IOException("A non-virtual path can't contain '../' : " + nonVirtualPath );
	}

	String path = getAbsolutePath( nonVirtualPath );

	ServletContext servletContext = servlet.getServletContext();
	ServletContextAndPath csAndP = new ServletContextAndPath( servletContext, path );
	return csAndP;
	}


	protected ServletContextAndPath getServletContextAndPathFromVirtualPath( String virtualPath ) throws IOException {
	ServletContext servletContext = servlet.getServletContext();
	String path = null;

	if ( !virtualPath.startsWith("/") && !virtualPath.startsWith("\\") ) {
	path = getAbsolutePath( virtualPath );
	} else {
	String normalized = SSIServletRequestUtil.normalize( virtualPath );
	if ( isVirtualWebappRelative ) {
	path = normalized;
	} else {
	servletContext = servletContext.getContext( normalized );
	if ( servletContext == null ) {
	throw new IOException("Couldn't get context for path: " + normalized );
	}

	//If it's the root context, then there is no context element to remove, ie:
	// '/file1.shtml' vs '/appName1/file1.shtml'
	if ( !isRootContext( servletContext ) ) {
	path = getPathWithoutContext( normalized );
	if ( path == null ) {
	throw new IOException("Couldn't remove context from path: " + normalized );
	}
	} else {
	path = normalized;
	}
	}
	}
	return new ServletContextAndPath( servletContext, path );
	}

	//Assumes servletContext is not-null
	//Assumes that identity comparison will be true for the same context
	//Assuming the above, getContext("/") will be non-null as long as the root context is accessible.
	//If it isn't, then servletContext can't be the root context anyway, hence they will not match.
	protected boolean isRootContext( ServletContext servletContext ) {
	return servletContext == servletContext.getContext( "/" );
	}

	protected ServletContextAndPath getServletContextAndPath( String originalPath, boolean virtual ) throws IOException {
	ServletContextAndPath csAndP = null;

	if ( debug > 0 ) {
	log("SSIServletExternalResolver.getServletContextAndPath( " + originalPath + ", " + virtual + ")" , null);
	}
	if ( virtual ) {
	csAndP = getServletContextAndPathFromVirtualPath( originalPath );
	} else {
	csAndP = getServletContextAndPathFromNonVirtualPath( originalPath );
	}
	return csAndP;
	}

	protected URLConnection getURLConnection( String originalPath, boolean virtual ) throws IOException {
	ServletContextAndPath csAndP = getServletContextAndPath( originalPath, virtual );
	ServletContext context = csAndP.getServletContext();
	String path = csAndP.getPath();

	URL url = context.getResource( path );
	if ( url == null ) {
	throw new IOException("Context did not contain resource: " + path );
	}
	URLConnection urlConnection = url.openConnection();
	return urlConnection;
	}

	public long getFileLastModified( String path, boolean virtual ) throws IOException {
	long lastModified = 0;

	URLConnection urlConnection = getURLConnection( path, virtual );
	lastModified = urlConnection.getLastModified();
	return lastModified;
	}

	public long getFileSize( String path, boolean virtual ) throws IOException {
	long fileSize = -1;

	URLConnection urlConnection = getURLConnection( path, virtual );
	fileSize = urlConnection.getContentLength();
	return fileSize;
	}

	//We are making lots of unnecessary copies of the included data here. If someone ever complains that this
	//is slow, we should connect the included stream to the print writer that SSICommand uses.
	public String getFileText( String originalPath, boolean virtual ) throws IOException {
	try {
	ServletContextAndPath csAndP = getServletContextAndPath( originalPath, virtual );
	ServletContext context = csAndP.getServletContext();
	String path = csAndP.getPath();

	RequestDispatcher rd =
	context.getRequestDispatcher( path );
	if ( rd == null ) {
	throw new IOException("Couldn't get request dispatcher for path: " + path );
	}
	ByteArrayServletOutputStream basos = new ByteArrayServletOutputStream();
	ResponseIncludeWrapper responseIncludeWrapper =
	new ResponseIncludeWrapper(res, basos );
	rd.include(req, responseIncludeWrapper );

	//We can't assume the included servlet flushed its output
	responseIncludeWrapper.flushOutputStreamOrWriter();
	byte[] bytes = basos.toByteArray();

	//Assume that the default encoding is what was used to encode the bytes. Questionable.
	String retVal = new String( bytes );

	//make an assumption that an empty response is a failure. This is a problem if a truly empty file
	//were included, but not sure how else to tell.
	if ( retVal.equals("") ) {
	throw new IOException("Couldn't find file: " + path );
	}
	return retVal;
	} catch (ServletException e) {
	throw new IOException("Couldn't include file: " + originalPath + " because of ServletException: " + e.getMessage() );
	}
	}

	protected class ServletContextAndPath {
	protected ServletContext servletContext;
	protected String path;

	public ServletContextAndPath( ServletContext servletContext, String path ) {
	this.servletContext = servletContext;
	this.path = path;
	}

	public ServletContext getServletContext() {
	return servletContext;
	}

	public String getPath() {
	return path;
	}
	}
	}