...
- A module is packaged java code that can be installed into a running OpenMRS instance and is able to modify almost all aspects of OpenMRS. It can provide web pages, add tables, change how service calls work, and add new functionality (like report options, person attribute types, etc)
Types of Modules
- Core Modules: We want to take some functionality in core and iterate on it more rapidly than the OpenMRS release cycle. This is the case for the logic module.
- Bundled Modules
- We have functionality needed by core, but can have multiple implementations or benefits may benefit from the ability to swap in an alternative (eg, faster or better suited for a particular site) implementation. This is the case with the XStream module, which implements the serialization API on which core OpenMRS code depends.
- Some modules are just generally/widely useful, so get shipped with OpenMRS. We call these "bundled" modules. Examples are FormEntry and HTML Form Entry.
In general, we would prefer to move toward a world where more & more functionality is done in modules and the core is getting leaner over time – ie, a framework.
Quick Overview
- Modules can modify with the service layer methods via Aspect Oriented Programming (AOP). All core services and all module services are able to be wrapped and manipulated.
- If in a web context, modules can add their own jsp web pages in their /web/module folder. They link these pages to controllers and to OpenMRS via the Spring context /metadata/moduleApplicationContext.xml
- Modules can add to and current jsp page in the web layer via extension points. A module registers an extension in the /metadata/config.xml for each extension point in the system to which it wants to add content.
- Modules are able add and modify tables in the database. The sqldiff.xml and/or liquibase.xml file in the metadata folder holds the diffs.
- The file extension for modules is ".omod". However, a module is simply a jar underneath. This different extension was chosen for two reasons: First, its just a short form of "OpenMRS Module". Second, its a unique extension and there aren't any other programs known to be using it.
...