在Weblogic环境下调试Turbine Servlet实例

　　一、异常描述

　　我们公司的门户平台产品是基于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找到下面一句:

　　将此句等号右边的.改为/或/后加一个目录名,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()方法:

　　TurbineServices.getInstance().getService(UploadService.SERVICE_NAME)返回的类实例是org.apache.turbine.services.upload.TurbineUploadService,而TurbineServices类的getService方法实际是调用了其父类的方法，在其父类的getService方法中有service.init()的语句，实际上是调用了TurbineUploadService父类BaseUploadService的init()方法，看一下此方法内部的代码:

　　从以上代码分析，path的值是从TurbineResources.properties文件中读取的,从此文件中找到下面一行:

　　path读取的等号右面的值，从上面代码中看出，如果路径不是以”/”开头，就调用TurbineServlet.getRealPath(path)得到实际的路径，而此方法实际是调用了TurbineServletService的getRealPath,看TurbineServletService中的getRealPath,有这样一行代码:

　　uri的值是从TurbineServlet.getRealPath传递进来的，也就是从TurbineResources.properties读取services.UploadService.repository的值，目前是.getServletContext().getRealPath(“.”)在Weblogic环境下抛出了异常,所以需要修改TurbineResources.properties,将services.UploadService.repository=.改为

　　services.UploadService.repository=/ ,等号右面也可以写绝对路径或以”/”开头的相对路径。