ref from:http://blogs.indrajitpingale.com/?p=8
http://blog.shinetech.com/2013/04/09/integrating-springmvc-with-opencms/
It is assumed that you have successfully deploted OpenCMS 8.x on either Tomcat or JBoss (How to deploy OpenCMS on JBoss?). Also, it is assumed that your are hands-on on Spring MVC.
So there are 6 part of Spring MVC application.
- classes (Controllers and other)
- JSP files
- Assets (image, js, css and other files)
- Spring taglibs (spring-form.tld, spring.tld) *** if any ***
- Servlet configuration files (xxxx-servlet.xml)
- libs (your application might need more or less)
- aopalliance-1.0.jar
- ehcache-1.2.3.jar
- hibernate-3.2.3.ga.jar
- log4j-1.2.17.jar
- opencmsspring_c3p0-0.9.1-pre5a.jar
- opencmsspring_hibernate3.2.jar
- rapid-web.jar
- spring-aop-3.0.5.RELEASE.jar
- spring-asm-3.0.5.RELEASE.jar
- spring-beans-3.0.5.RELEASE.jar
- spring-context-3.0.5.RELEASE.jar
- spring-context-support-3.0.5.RELEASE.jar
- spring-core-3.0.5.RELEASE.jar
- spring-expression-3.0.5.RELEASE.jar
- spring-jdbc-3.0.5.RELEASE.jar
- spring-orm-3.2.3.RELEASE.jar
- spring-tx-3.0.5.RELEASE.jar
- spring-web-3.0.5.RELEASE.jar
- spring-webmvc-3.0.5.RELEASE.jar
- web.xml
Steps to deploy Spring MVC application in openCMS.
- Copy all libs to “opencms.war\WEB-INF\lib” folder.
- Copy *.tld, xxxx-servlet.xml, xxxx-service.xml to “opencms.war\WEB-INF” folder.
- Create .jar of your classes (only classes nothing else) and copy it to “opencms.war\WEB-INF\lib” folder.
- Now the tricky part is web.xml, don’t copy it to ”opencms.war\WEB-INF” otherwise it will overwrite openCMS’s web.xml. Follow the following steps.
- Open openCMS’s web.xml (opencms.war\WEB-INF\web.xml) for edit.
- 1st copy following
<!-- Begin: OpenCmsSpring Integration -->
<
context-param
>
<
param-name
>contextConfigLocation</
param-name
>
<
param-value
>/WEB-INF/OpenCmsSpring-service.xml</
param-value
>
</
context-param
>
<
filter
>
<
filter-name
>CharacterEncoding</
filter-name
>
<
filter-class
>
org.springframework.web.filter.CharacterEncodingFilter
</
filter-class
>
<
init-param
>
<
param-name
>encoding</
param-name
>
<
param-value
>UTF-8</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>forceEncoding</
param-name
>
<
param-value
>true</
param-value
>
</
init-param
>
</
filter
>
<!-- End: OpenCmsSpring Integration -->
under following
<
context-param
>
<
param-name
>DefaultWebApplication</
param-name
>
<
param-value
>ROOT</
param-value
>
</
context-param
>
- 2nd copy following
<!-- Begin: OpenCmsSpring Integration -->
<
listener
>
<
listener-class
>org.springframework.web.context.ContextLoaderListener</
listener-class
>
</
listener
>
<
servlet
>
<
servlet-name
>OpenCmsSpring</
servlet-name
>
<
servlet-class
>org.springframework.web.servlet.DispatcherServlet</
servlet-class
>
<
load-on-startup
>1</
load-on-startup
>
</
servlet
>
<!-- End: OpenCmsSpring Integration -->
under following
<
listener
>
<
listener-class
>org.opencms.main.OpenCmsListener</
listener-class
>
</
listener
>
- 3rd copy following to redirect spring request to RewriteFilter.
<!-- Begin: OpenCmsSpring Integration -->
<
servlet-mapping
>
<
servlet-name
>OpenCmsSpring</
servlet-name
>
<
url-pattern
>*.htm</
url-pattern
>
</
servlet-mapping
>
<
filter
>
<
filter-name
>RewriteFilter</
filter-name
>
<
filter-class
>com.ipingale.filter.RewriteFilter</
filter-class
>
</
filter
>
<
filter-mapping
>
<
filter-name
>RewriteFilter</
filter-name
>
<
url-pattern
>/*</
url-pattern
>
</
filter-mapping
>
<
filter-mapping
>
<
filter-name
>CharacterEncoding</
filter-name
>
<
url-pattern
>/*</
url-pattern
>
</
filter-mapping
>
<!-- End: OpenCmsSpring Integration -->
under following
<
servlet-mapping
>
<
servlet-name
>OpenCmsWebDavServlet</
servlet-name
>
<
url-pattern
>/webdav/*</
url-pattern
>
</
servlet-mapping
>
- 4th and last copy following to add support to spring Taglibs
<!-- Begin: Spring Integration -->
<
taglib
>
<
taglib-uri
>/spring</
taglib-uri
>
<
taglib-location
>/WEB-INF/spring.tld</
taglib-location
>
</
taglib
>
<
taglib
>
<
taglib-uri
>/form</
taglib-uri
>
<
taglib-location
>/WEB-INF/spring-form.tld</
taglib-location
>
</
taglib
>
<!-- End: Spring Integration -->
under following
<
taglib
>
<
taglib-location
>/WEB-INF/opencms.tld</
taglib-location
>
</
taglib
>
- Now start Tomcat/JBoss.
- Open openCMS dashboard (http://localhost:8080/opencms/opencms/system/login/).
- Create any site (folder) inside site/default for e.g. “demo1″.
- Upload all JSP files under this folder (site/default/demo1).
- Now about Assets. Where to put those in openCMS?
- For that create Module from Administrator view (with name “com.ipingale.demo.module”).
- Add resource folder to that module.
- Copy all Assets under that folder.
- Touch ups.
- Assets links, e.g. css, js, images, etc. referred in JSP. You need to modify them as follows.
Before:<
link
href
=
"css/style.css"
rel
=
"stylesheet"
type
=
"text/css"
/>
After:
<
link
href="<cms:link>/system/modules/com.ipingale.demo.module/resources/css/style.css</
cms:link
>" rel="stylesheet" type="text/css" />
- To support “” you need to add following on the top of each JSP page.
<%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms" %>
- Rename all .jsp files to .spg (or anything other than known mime types).
- Assets links, e.g. css, js, images, etc. referred in JSP. You need to modify them as follows.
That’s it you are ready now.
Click on your start page (index.spg) and here you go.
You can download working example from below location.
This entry was posted in OpenCMS, Spring-MVC on February 4, 2014.