在Weblogic环境下调试Turbine Servlet实例

在Weblogic环境下调试Turbine Servlet实例

Turbine是Jetspeed1.x使用的Servlet引擎，本文的目的不在于告诉读者如何调试本文中讲述的Bug，而是让大家通过本例的Bug的追踪调试过程，来了解一下Turbine的工作机理。
（由于本文讲述的Turbine对Java初学者可能比较陌生，专业性比较强，所以点击率如果很低也是意料之中的事情）

一、异常描述

我们公司的门户平台产品是基于Jetspeed1.4的，使用Turbine2.2作为Servlet引擎，将产品部署到Weblogic上，启动后打开首页，出现下面的错误：
'weblogic.kernel.Default'> < > <> <[ServletContext(id=6718343,name=portal,context-path=/portal)] getRealPath() called with unsafe path: ".".
weblogic.utils.io.FilenameEncoder$UnsafeFilenameException: D:/bea/user_projects/domains/webapps/portal/. ends with illegal character
at weblogic.utils.io.FilenameEncoder.getSafeFile(FilenameEncoder.java:210)
at weblogic.servlet.internal.WebAppServletContext.getRealPath(WebAppServletContext.java:916)
at org.apache.turbine.services.servlet.TurbineServletService.getRealPath(TurbineServletService.java:218)
at org.apache.turbine.services.servlet.TurbineServlet.getRealPath(TurbineServlet.java:134)

二、解决方法

打开WEB-INF/conf/TurbineResources.properties找到下面一句：

services.UploadService.repository=.

将此句等号右边的.改为/或/后加一个目录名,Weblogic控制台不再报异常。

三、异常分析

从Weblogic控制台输出的信息来看，.是一个不安全的路径，这个异常的产生过程是这样的：
1、 Turbine Servlet启动。
2、 在org.apache.Turbine的doGet方法中有data.setScreen(data.getParameters().getString("screen"))的代码。
3、 RunData的实例是DefaultJetspeedRunData,此类继承了org.apache.turbine.services.DefaultTurbineRunData,所以在Turbine类的doGet方法中的data.getParameters实际是调用了DefaultTurbineRunData方法，此方法返回ParameterParser类型，ParameterParser是一个接口，实际的类是org.apache.turbine.util.parser.DefaultParameterParser。在getParameters方法中有一行代码this.parameters.setRequest(this.req)，异常是调用setRequest方法产生的。
4、 再看DefaultParameterParser的setRequest方法,经调试，异常是从此方法中的语句TurbineUpload.getAutomatic()产生的，然后再看TurbineUpload(org.apache.turbine.services.upload.TurbineUpload),此类是一个抽象类，在getAutomatic方法中调用了upload = getService();
5、 再看一下TurbineUpload的getService()方法：
public static UploadService getService()
{
return (UploadService)TurbineServices.getInstance().
getService(UploadService.SERVICE_NAME); //SERVICE_NAME=UploadService
}

TurbineServices.getInstance().getService(UploadService.SERVICE_NAME)返回的类实例是org.apache.turbine.services.upload.TurbineUploadService,而TurbineServices类的getService方法实际是调用了其父类的方法，在其父类的getService方法中有service.init()的语句，实际上是调用了TurbineUploadService父类BaseUploadService的init()方法，看一下此方法内部的代码：
String path = getProperties()
.getProperty(UploadService.REPOSITORY_KEY,
UploadService.REPOSITORY_DEFAULT.toString()); //REPOSITORY_KEY=repository
//REPOSITORY_DEFAULT = "."
if(!path.startsWith("/"))
{
String realPath = TurbineServlet.getRealPath(path);
if(realPath != null)
{
path = realPath;
}
}
getProperties().setProperty(UploadService.REPOSITORY_KEY, path);
setInit(true);

从以上代码分析，path的值是从TurbineResources.properties文件中读取的,从此文件中找到下面一行：
services.UploadService.repository=.
path读取的等号右面的值，从上面代码中看出，如果路径不是以”/”开头，就调用TurbineServlet.getRealPath(path)得到实际的路径，而此方法实际是调用了TurbineServletService的getRealPath,看TurbineServletService中的getRealPath,有这样一行代码：
path = getServletContext().getRealPath( uri )；

uri的值是从TurbineServlet.getRealPath传递进来的，也就是从TurbineResources.properties读取services.UploadService.repository的值，目前是.

getServletContext().getRealPath(“.”)在Weblogic环境下抛出了异常,所以需要修改TurbineResources.properties,将services.UploadService.repository=.改为
services.UploadService.repository=/ ,等号右面也可以写绝对路径或以”/”开头的相对路径