Integrating OpenCms with Maven

OpenCms Solution Provider Comundus has created an integration of OpenCms and Maven. The project is available on SourceForge. Goal of the project is to optimize the OpenCms build process, not only for the OpenCms core but also for OpenCms project development. The project was initially presented to the OpenCms community at OpenCms Days 2008.

In order to use this Maven integration, currently a non-standard OpenCms distribution that contains several patches to the original OpenCms core has to be used. This non-standard OpenCms distribution is based on OpenCms 7.0.3.

In this Sprint, we checked how to modify the code of the OpenCms core and the Maven plugin so that in the future, the Maven plugin can be used with the standard OpenCms core distribution.

Roadmap

  • Some of the changes to the OpenCms core by Comundus are just bug fixes; these have been given to Alkacon during the Sprint as a patch relative to 7.0.5 code (patch available here: bugfixes.patch.txt). These fixes will be integrated in future OpenCms release versions.
  • A requirement with the checking of existing OUs not existing yet when doing a Maven build on group creation has been fixed with a patch to the OpenCms core doing the checks only when the OpenCms runlevel is "servlet mode" (patch available here: ou.maven.patch.txt).
  • One problem with configurable LinkRelations is that the type "defined in content" can't be set via configuration; some API in that area must be extended in the core (patch available here: relationtype.defincontent.patch.txt).
  • The class implementing the OpenCms synchronization method must be made pluggable, since the Maven plugin requires different functionality for this. It was agreed that this should be configured in opencms-importexport.xml with a new "synchronizationhandler". For this handler a simple interface needs to be defined.
  • Code for use by the Maven VFS Plugin will go into a separate JAR file for a beginning; might be integrated to the core later on
  • If there is a way to eliminate the need for the special "CmOpenCmsShell" class of the Maven plugin, it should be done.
  • Besides it would be helpful to include a possibility to actually configure and use custom CommandObject classes with the CmsShell. This functionality should already be available in the core but either it does not work as expected or it has not been used correctly in the Maven Plugin. This needs further investigation.
  • Currently the Maven VFS Plugin code copies quite some code from original OpenCms; this code should go into one or more extra classes that are used by OpenCms core as well as Maven VFS Plugin code; thus eliminating duplicated code; and changes to that code done by Alcacon get integrated into the function of the Maven VFS Plugin automatically.

Latest News

  • OpenCms 12 available

    Oct 12, 2021 - OpenCms 12 features a headless JSON API for REST content access, together with several JavaScript demo applications that show how to use it. The default "Mercury" template has been greatly improved. Template variants allow to completely switch the generated HTML of a website simply by configuration. The updated WebDAV implementation enables mounting the OpenCms virtual file system from any WebDAV client.

  • OpenCms 12 Release Notes

    Oct 12, 2021 - The OpenCms 12 release notes contain detailed information about the new features and fixes in this version.

  • Alkacon OCEE 12.0

    Oct 12, 2021 - Alkacon OCEE 12.0 is the latest OCEE release for OpenCms 12. It adds new functions for managing log files in an OpenCms cluster, as well as improvements for the accelerator and the user synchronization.

  • OpenCms Docker image

    Oct 12, 2021 - Test OpenCms using the official image from the Docker hub registry - the fastest way to evaluate and test OpenCms. The image is well suited for evaluation and test purposes of the latest OpenCms release. We provide a docker-compose file to get OpenCms and the database running with just one command.