Module (OpenMRS 1.8.5-SNAPSHOT API)

java.lang.Object
- org.openmrs.module.Module

```
public final class Module
extends Object
```
Generic module class that openmrs manipulates

Version:

1.0

Constructor Summary

Constructors
Constructor and Description
`Module(String name)` Simple constructor
`Module(String name, String moduleId, String packageName, String author, String description, String version)` Main constructor

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`clearStartupError()`
`void`	`disposeAdvicePointsClassInstance()`
`boolean`	`equals(Object obj)`
`Activator`	`getActivator()` Deprecated. replaced by `getModuleActivator()`
`String`	`getActivatorName()`
`List<AdvicePoint>`	`getAdvicePoints()`
`String`	`getAuthor()`
`List<ModuleConditionalResource>`	`getConditionalResources()`
`Document`	`getConfig()`
`String`	`getDescription()`
`String`	`getDownloadURL()`
`List<Extension>`	`getExtensions()`
`File`	`getFile()`
`List<GlobalProperty>`	`getGlobalProperties()`
`Document`	`getLog4j()`
`List<String>`	`getMappingFiles()`
`Map<String,Properties>`	`getMessages()` Gets a mapping from locale to properties used by this module.
`ModuleActivator`	`getModuleActivator()`
`String`	`getModuleId()`
`String`	`getModuleIdAsPath()`
`String`	`getName()`
`String`	`getPackageName()`
`List<Privilege>`	`getPrivileges()`
`String`	`getRequireDatabaseVersion()`
`List<String>`	`getRequiredModules()` This list of strings is just what is included in the config.xml file, the full package names: e.g.
`String`	`getRequiredModuleVersion(String moduleName)` Convenience method to get the version of this given module that is required
`String`	`getRequireOpenmrsVersion()`
`Document`	`getSqldiff()`
`String`	`getStartupErrorMessage()`
`String`	`getUpdateURL()`
`String`	`getUpdateVersion()`
`String`	`getVersion()`
`Boolean`	`hasStartupError()`
`boolean`	`isCoreModule()` This is a convenience method to know whether this module is core to OpenMRS.
`boolean`	`isMandatory()` This property is set by the module owner to tell OpenMRS that once it is installed, it must always startup.
`boolean`	`isStarted()`
`void`	`setActivator(Activator activator)`
`void`	`setActivatorName(String activatorName)`
`void`	`setAdvicePoints(List<AdvicePoint> advicePoints)`
`void`	`setAuthor(String author)`
`void`	`setConditionalResources(List<ModuleConditionalResource> conditionalResources)`
`void`	`setConfig(Document config)`
`void`	`setDescription(String description)`
`void`	`setDownloadURL(String downloadURL)`
`void`	`setExtensionNames(IdentityHashMap<String,String> map)` A map of pointid to classname.
`void`	`setExtensions(List<Extension> extensions)`
`void`	`setFile(File file)`
`void`	`setGlobalProperties(List<GlobalProperty> globalProperties)`
`void`	`setLog4j(Document log4j)`
`void`	`setMandatory(boolean mandatory)`
`void`	`setMappingFiles(List<String> mappingFiles)`
`void`	`setMessages(Map<String,Properties> messages)` Sets the map from locale to properties used by this module.
`void`	`setModuleActivator(ModuleActivator moduleActivator)`
`void`	`setModuleId(String moduleId)`
`void`	`setName(String name)`
`void`	`setPackageName(String packageName)`
`void`	`setPrivileges(List<Privilege> privileges)`
`void`	`setRequireDatabaseVersion(String requireDatabaseVersion)`
`void`	`setRequiredModules(List<String> requiredModules)` This is a convenience method to set all the required modules without any version requirements
`Map<String,String>`	`setRequiredModulesMap()` Get the modules that are required for this module.
`void`	`setRequiredModulesMap(Map<String,String> requiredModulesMap)`
`void`	`setRequireOpenmrsVersion(String requireOpenmrsVersion)`
`void`	`setSqldiff(Document sqldiff)`
`void`	`setStartupErrorMessage(String e)`
`void`	`setStartupErrorMessage(String exceptionMessage, Throwable t)` Add the given exceptionMessage and throwable as the startup error for this module.
`void`	`setUpdateURL(String updateURL)`
`void`	`setUpdateVersion(String updateVersion)`
`void`	`setVersion(String version)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Module
```
public Module(String name)
```
    Simple constructor
    
    Parameters:
    
    name -
  - Module
```
public Module(String name,
              String moduleId,
              String packageName,
              String author,
              String description,
              String version)
```
    Main constructor
    
    Parameters:
    
    name -
    
    moduleId -
    
    packageName -
    
    author -
    
    description -
    
    version -
- Method Detail
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - getActivator
```
@Deprecated
public Activator getActivator()
```
    Deprecated. replaced by getModuleActivator()
    
    Returns:
    
    the activator
  - setActivator
```
public void setActivator(Activator activator)
```
    Parameters:
    
    activator - the activator to set
  - getModuleActivator
```
public ModuleActivator getModuleActivator()
```
    Returns:
    
    the moduleActivator
  - setModuleActivator
```
public void setModuleActivator(ModuleActivator moduleActivator)
```
    Parameters:
    
    moduleActivator - the moduleActivator to set
  - getActivatorName
```
public String getActivatorName()
```
    Returns:
    
    the activatorName
  - setActivatorName
```
public void setActivatorName(String activatorName)
```
    Parameters:
    
    activatorName - the activatorName to set
  - getAuthor
```
public String getAuthor()
```
    Returns:
    
    the author
  - setAuthor
```
public void setAuthor(String author)
```
    Parameters:
    
    author - the author to set
  - getDescription
```
public String getDescription()
```
    Returns:
    
    the description
  - setDescription
```
public void setDescription(String description)
```
    Parameters:
    
    description - the description to set
  - getName
```
public String getName()
```
    Returns:
    
    the name
  - setName
```
public void setName(String name)
```
    Parameters:
    
    name - the name to set
  - getRequireDatabaseVersion
```
public String getRequireDatabaseVersion()
```
    Returns:
    
    the requireDatabaseVersion
  - setRequireDatabaseVersion
```
public void setRequireDatabaseVersion(String requireDatabaseVersion)
```
    Parameters:
    
    requireDatabaseVersion - the requireDatabaseVersion to set
  - getRequiredModules
```
public List<String> getRequiredModules()
```
    This list of strings is just what is included in the config.xml file, the full package names: e.g. org.openmrs.module.formentry
    
    Returns:
    
    the list of requiredModules
  - getRequiredModuleVersion
```
public String getRequiredModuleVersion(String moduleName)
```
    Convenience method to get the version of this given module that is required
    
    Returns:
    
    the version of the given required module, or null if there are no version constraints
    
    Since:
    
    1.5
    
    Should:
    
    return null if no required modules exist, return null if no required module by given name exists
  - setRequiredModules
```
public void setRequiredModules(List<String> requiredModules)
```
    This is a convenience method to set all the required modules without any version requirements
    
    Parameters:
    
    requiredModules - the requiredModules to set for this module
    
    Should:
    
    set modules when there is a null required modules map
  - setRequiredModulesMap
```
public void setRequiredModulesMap(Map<String,String> requiredModulesMap)
```
    Parameters:
    
    requiredModulesMap - Map of the requiredModules to set
    
    Since:
    
    1.5
  - setRequiredModulesMap
```
public Map<String,String> setRequiredModulesMap()
```
    Get the modules that are required for this module. The keys in this map are the module package names. The values in the map are the required version. If no specific version is required, it will be null.
    
    Returns:
    
    a map from required module to the version that is required
  - getRequireOpenmrsVersion
```
public String getRequireOpenmrsVersion()
```
    Returns:
    
    the requireOpenmrsVersion
  - setRequireOpenmrsVersion
```
public void setRequireOpenmrsVersion(String requireOpenmrsVersion)
```
    Parameters:
    
    requireOpenmrsVersion - the requireOpenmrsVersion to set
  - getModuleId
```
public String getModuleId()
```
    Returns:
    
    the module id
  - getModuleIdAsPath
```
public String getModuleIdAsPath()
```
    Returns:
    
    the module id, with all . replaced with /
  - setModuleId
```
public void setModuleId(String moduleId)
```
    Parameters:
    
    moduleId - the module id to set
  - getPackageName
```
public String getPackageName()
```
    Returns:
    
    the packageName
  - setPackageName
```
public void setPackageName(String packageName)
```
    Parameters:
    
    packageName - the packageName to set
  - getVersion
```
public String getVersion()
```
    Returns:
    
    the version
  - setVersion
```
public void setVersion(String version)
```
    Parameters:
    
    version - the version to set
  - getUpdateURL
```
public String getUpdateURL()
```
    Returns:
    
    the updateURL
  - setUpdateURL
```
public void setUpdateURL(String updateURL)
```
    Parameters:
    
    updateURL - the updateURL to set
  - getDownloadURL
```
public String getDownloadURL()
```
    Returns:
    
    the downloadURL
  - setDownloadURL
```
public void setDownloadURL(String downloadURL)
```
    Parameters:
    
    downloadURL - the downloadURL to set
  - getUpdateVersion
```
public String getUpdateVersion()
```
    Returns:
    
    the updateVersion
  - setUpdateVersion
```
public void setUpdateVersion(String updateVersion)
```
    Parameters:
    
    updateVersion - the updateVersion to set
  - getExtensions
```
public List<Extension> getExtensions()
```
    Returns:
    
    the extensions
  - setExtensions
```
public void setExtensions(List<Extension> extensions)
```
    Parameters:
    
    extensions - the extensions to set
  - setExtensionNames
```
public void setExtensionNames(IdentityHashMap<String,String> map)
```
    A map of pointid to classname. The classname is expected to be a class that extends the Extension object.
    
    This map will be expanded into full Extension objects the first time getExtensions() is called
    
    Parameters:
    
    map - from pointid to classname
    
    See Also:
    
    ModuleFileParser
  - getAdvicePoints
```
public List<AdvicePoint> getAdvicePoints()
```
    Returns:
    
    the advicePoints
  - setAdvicePoints
```
public void setAdvicePoints(List<AdvicePoint> advicePoints)
```
    Parameters:
    
    advicePoints - the advicePoints to set
  - getFile
```
public File getFile()
```
  - setFile
```
public void setFile(File file)
```
  - getMessages
```
public Map<String,Properties> getMessages()
```
    Gets a mapping from locale to properties used by this module. The locales are represented as a string containing language and country codes.
    
    Returns:
    
    mapping from locales to properties
  - setMessages
```
public void setMessages(Map<String,Properties> messages)
```
    Sets the map from locale to properties used by this module.
    
    Parameters:
    
    messages - map of locale to properties for that locale
  - getGlobalProperties
```
public List<GlobalProperty> getGlobalProperties()
```
  - setGlobalProperties
```
public void setGlobalProperties(List<GlobalProperty> globalProperties)
```
  - getPrivileges
```
public List<Privilege> getPrivileges()
```
  - setPrivileges
```
public void setPrivileges(List<Privilege> privileges)
```
  - getConfig
```
public Document getConfig()
```
  - setConfig
```
public void setConfig(Document config)
```
  - getLog4j
```
public Document getLog4j()
```
  - setLog4j
```
public void setLog4j(Document log4j)
```
  - getSqldiff
```
public Document getSqldiff()
```
  - setSqldiff
```
public void setSqldiff(Document sqldiff)
```
  - getMappingFiles
```
public List<String> getMappingFiles()
```
  - setMappingFiles
```
public void setMappingFiles(List<String> mappingFiles)
```
  - isMandatory
```
public boolean isMandatory()
```
    This property is set by the module owner to tell OpenMRS that once it is installed, it must always startup. This is intended for modules with system-critical monitoring or security checks that should always be in place.
    
    Returns:
    
    true if this module has said that it should always start up
  - setMandatory
```
public void setMandatory(boolean mandatory)
```
  - isCoreModule
```
public boolean isCoreModule()
```
    This is a convenience method to know whether this module is core to OpenMRS. A module is 'core' when this module is essentially part of the core code and must exist at all times
    
    Returns:
    
    true if this is an OpenMRS core module
    
    See Also:
    
    ModuleConstants#CORE_MODULES}
  - isStarted
```
public boolean isStarted()
```
  - setStartupErrorMessage
```
public void setStartupErrorMessage(String e)
```
  - setStartupErrorMessage
```
public void setStartupErrorMessage(String exceptionMessage,
                                   Throwable t)
```
    Add the given exceptionMessage and throwable as the startup error for this module. This method loops over the stacktrace and adds the detailed message
    
    Parameters:
    
    exceptionMessage - optional. the default message to show on the first line of the error message
    
    t - throwable stacktrace to include in the error message
  - getStartupErrorMessage
```
public String getStartupErrorMessage()
```
  - hasStartupError
```
public Boolean hasStartupError()
```
  - clearStartupError
```
public void clearStartupError()
```
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - disposeAdvicePointsClassInstance
```
public void disposeAdvicePointsClassInstance()
```
  - getConditionalResources
```
public List<ModuleConditionalResource> getConditionalResources()
```
  - setConditionalResources
```
public void setConditionalResources(List<ModuleConditionalResource> conditionalResources)
```

Class Module

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Module

Module

Method Detail

equals

getActivator

setActivator

getModuleActivator

setModuleActivator

getActivatorName

setActivatorName

getAuthor

setAuthor

getDescription

setDescription

getName

setName

getRequireDatabaseVersion

setRequireDatabaseVersion

getRequiredModules

getRequiredModuleVersion

setRequiredModules

setRequiredModulesMap

setRequiredModulesMap

getRequireOpenmrsVersion

setRequireOpenmrsVersion

getModuleId

getModuleIdAsPath

setModuleId

getPackageName

setPackageName

getVersion

setVersion

getUpdateURL

setUpdateURL

getDownloadURL

setDownloadURL

getUpdateVersion

setUpdateVersion

getExtensions

setExtensions

setExtensionNames

getAdvicePoints

setAdvicePoints

getFile

setFile

getMessages

setMessages

getGlobalProperties

setGlobalProperties

getPrivileges

setPrivileges

getConfig

setConfig

getLog4j

setLog4j

getSqldiff

setSqldiff

getMappingFiles

setMappingFiles

isMandatory

setMandatory

isCoreModule

isStarted

setStartupErrorMessage

setStartupErrorMessage

getStartupErrorMessage

hasStartupError

clearStartupError

toString

disposeAdvicePointsClassInstance

getConditionalResources

setConditionalResources