Home > Guides > Core Developers Guide > Application Servers > WebLogic |

Apache Struts 2 Documentation
WebLogic
Edit Page Browse Space Add Page Add News
Icon

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.

Icon

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 an `struts-velocity.properties` Configuration File

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

- Create the corresponding Velocity properties file ("struts-velocity.properties"), preferably in the same location as the `struts.properties` file.

- Copy into the Velocity properties file the contents of the `velocity.properties` file that is the the SAF `velocity-dep.jar`.

- In your new `struts-velocity.properties` file, find he section titled "`T E M P L A T E L O A D E R S`", and change this section as so:

- Redeploy a fresh WAR to WebLogic.

## 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 struts.properties 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
    struts.convention.action.includeJars=.*?/yourwebapp.*?jar(!/)?
    struts.convention.action.fileProtocols=jar,zip

Thanks to Amit who the first published solution on his blog