Fork me on GitHub
<< back to Core Developers Guide Edit on GitHub


When deploying to WebLogic, some developers report problems with the framework locating resources, especially with Velocity. For more about WebLogic and Velocity, see the Velocity website.

To deploy to WebLogic, the common approach is to create and deploy an unexpanded WAR to the WebLogic deployment directory. With WL 8.x, the deployment directory is typically at <bea_home>/user_projects/domains/mydomain/.

Adding a Configuration File

In the file (usually kept in the WEB-INF/classes directory), add an entry that specifies a Velocity configuration file.

struts.velocity.configfile =

resource.loader = class

file.resource.loader.description = Velocity File Resource Loader
file.resource.loader.class = org.apache.velocity.runtime.resource.loader.FileResourceLoader
file.resource.loader.path = .
file.resource.loader.cache = false
file.resource.loader.modificationCheckInterval = 2

class.resource.loader.class = org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader
class.resource.loader.cache = true

NPE when using Struts 2 Jasper Reports plugin

When using mentioned plugin in Weblogic 11g you can get NullPointerException within Struts 2. To solve the problem you must enable the “Archived Real Path” global property in Weblogic admin console > configuration > Web Applications. It’s because JasperReportsResult determines the report directory base on servletContext.getRealPath(finalLocation).

Convention based application doesn’t work

When you deployed an application that base on the Convention Plugin and you get an error messages that says:

There is no Action mapped for namespace / and action name xxxxxx

create file in WEB-INF/classes folder (in the expanded application’s folder or in the source code) with below statements:

#struts convention property modifications for Weblogic

Thanks to Amit who the first published solution on his blog.