OpenCMS integration with Spring MVC--reference

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)
1. aopalliance-1.0.jar
2. ehcache-1.2.3.jar
3. hibernate-3.2.3.ga.jar
4. log4j-1.2.17.jar
5. opencmsspring_c3p0-0.9.1-pre5a.jar
6. opencmsspring_hibernate3.2.jar
7. rapid-web.jar
8. spring-aop-3.0.5.RELEASE.jar
9. spring-asm-3.0.5.RELEASE.jar
10. spring-beans-3.0.5.RELEASE.jar
11. spring-context-3.0.5.RELEASE.jar
12. spring-context-support-3.0.5.RELEASE.jar
13. spring-core-3.0.5.RELEASE.jar
14. spring-expression-3.0.5.RELEASE.jar
15. spring-jdbc-3.0.5.RELEASE.jar
16. spring-orm-3.2.3.RELEASE.jar
17. spring-tx-3.0.5.RELEASE.jar
18. spring-web-3.0.5.RELEASE.jar
19. spring-webmvc-3.0.5.RELEASE.jar
web.xml

Steps to deploy Spring MVC application in openCMS.

Copy all libs to “opencms.warWEB-INFlib” folder.
Copy *.tld, xxxx-servlet.xml, xxxx-service.xml to “opencms.warWEB-INF” folder.
Create .jar of your classes (only classes nothing else) and copy it to “opencms.warWEB-INFlib” folder.

Now the tricky part is web.xml, don’t copy it to ”opencms.warWEB-INF” otherwise it will overwrite openCMS’s web.xml. Follow the following steps.

Open openCMS’s web.xml (opencms.warWEB-INFweb.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-uri>http://www.opencms.org/taglib/cms</taglib-uri>  
    <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?
1. For that create Module from Administrator view (with name “com.ipingale.demo.module”).
2. Add resource folder to that module.
3. Copy all Assets under that folder.
Touch ups.
1. 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" />
2. To support “” you need to add following on the top of each JSP page.
  
  ?
  
  <%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms" %>
3. Rename all .jsp files to .spg (or anything other than known mime types).

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.

https://drive.google.com/file/d/0B3Qu76R8MDYwclFWQV9Da3JqMDQ/edit?usp=sharing

http://www.sendspace.com/file/x2sipm

References:

http://blog.shinetech.com/2013/04/09/integrating-springmvc-with-opencms/

http://opencms.996256.n3.nabble.com/OpenCms-and-Spring-MVC-preview-and-direct-edit-of-resources-td22555.html

Thanks to Mathias Lin !!!