在Weblogic环境下调试Turbine Servlet实例

<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script> 在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=/ ,等号右面也可以写绝对路径或以”/”开头的相对路径。