Common

java.lang.Object
- general.common.Common

```
@Singleton
public class Common
extends java.lang.Object
```
This class provides configuration that is common to all modules of JATOS. It mostly takes parameters from application.conf. It is initialized during JATOS start (triggered in GuiceConfig). Since most fields are initialized by the constructor during the JATOS' start (triggered in GuiceConfig), it's save to access them via static getter methods.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static java.lang.String`	`getBasepath()` JATOS' absolute base path without trailing '/.'
`static java.lang.String`	`getBrandingUrl()` URL where some static HTML can be found that can be shown instead of the default welcome message on the home page
`static java.lang.String`	`getDbDefaultDriver()` Database driver as defined in application.conf
`static java.lang.String`	`getDbDefaultUrl()` Database URL as defined in application.conf
`static play.mvc.Http.Cookie.SameSite`	`getIdCookiesSameSite()` Which SameSite attribute the ID cookies should set
`static java.lang.String`	`getJatosHttpAddress()` JATOS HTTP host address without protocol or port (e.g.
`static int`	`getJatosHttpPort()` Port JATOS is running on
`static java.lang.String`	`getJatosUpdateMsg()` If in update happened during last startup a message might be stored here
`static java.lang.String`	`getJatosVersion()` JATOS version (full version e.g.
`static java.lang.String`	`getJpaDefault()` JPA persistence unit as defined in application.conf
`static java.lang.String`	`getLdapAdminDn()` LDAP admin DN (Distinguished Name) - the admin user is used to search for the actual user that wants to log in
`static java.lang.String`	`getLdapAdminPassword()` LDAP admin password
`static java.util.List<java.lang.String>`	`getLdapBaseDn()` LDAP base DNs (Distinguished Name)
`static int`	`getLdapTimeout()` Read timeout for the LDAP server
`static java.lang.String`	`getLdapUrl()` LDAP URL (with port)
`static java.lang.String`	`getMac()` MAC address of the network interface
`static int`	`getMaxResultsDbQuerySize()` Maximal number of results to be fetched from the DB at once
`static java.lang.String`	`getOauthGoogleClientId()` Google Sign-in Client ID for OAuth / OpenId Connect (OIDC)
`static java.lang.String`	`getPlayHttpContext()` HTTP URL base path: will be the prefix for each URL, e.g.
`static long`	`getResultDataMaxSize()` Maximal size of result data of one component result in Byte
`static long`	`getResultUploadsLimitPerStudyRun()` Max size of all files uploaded during a single study run in bytes
`static long`	`getResultUploadsMaxFileSize()` Max file size in bytes for a single uploaded file
`static java.lang.String`	`getResultUploadsPath()` Path in the file system where JATOS stores uploaded result files
`static java.lang.String`	`getStudyAssetsRootPath()` Path in the file system to the study assets root directory.
`static java.lang.String`	`getStudyLogsPath()` Path in the file system where JATOS stores its logs for each study
`static int`	`getUserPasswordMinLength()` Message that will be displayed during user creation that describes password requirements
`static org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.String>`	`getUserPasswordStrengthRegex()` Regex that will be used to check the password during user creation
`static int`	`getUserSessionInactivity()` Time in minutes a user can be inactive before he will be logged-out (defined in application.conf)
`static int`	`getUserSessionTimeout()` Time in minutes when the Play session will timeout (defined in application.conf)
`static boolean`	`isDonationAllowed()` Should the GUI show a donations button
`static boolean`	`isIdCookiesSecure()` If true, the ID cookies' secure attribute will be set
`static boolean`	`isInMemoryDb()` Is true if an in-memory database is used.
`static boolean`	`isLdapAllowed()`
`static boolean`	`isOauthGoogleAllowed()`
`static boolean`	`isResultDataExportUseTmpFile()` If true, result data that are fetched from the database are first stored in a temporary file and only if they are all gathered the file is sent to the browser.
`static boolean`	`isResultUploadsEnabled()` Are file uploads via jatos.js allowed?
`static boolean`	`isStudyLogsEnabled()` Is study logging enabled
`static boolean`	`isStudyMembersAllowedToAddAllUsers()` If true, it's allowed to add all users that exist on this JATOS server to be added at once as members of a study
`static boolean`	`isUserRoleAllowSuperuser()` If true, it is allowed to grant users the Superuser role
`static boolean`	`isUserSessionValidation()` Toggle for user session validation (not the Play session validation which is done by Play).
`static boolean`	`showResultDataSizeInStudyAdmin()` If false, the result data size won't be calculated for the study admin page.
`static boolean`	`showResultFileSizeInStudyAdmin()` If false, the study result file size won't be calculated for the study admin page.
`static boolean`	`showStudyAssetsSizeInStudyAdmin()` If false, the study assets folder size won't be calculated for the study admin page.
`static java.lang.String`	`termsOfUseUrl()` URL to the terms of use that will be shown in a link on the home page
`static boolean`	`usesMysql()` Does JATOS use an MySQL database?

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

- Method Detail
  - getJatosVersion
```
public static java.lang.String getJatosVersion()
```
    JATOS version (full version e.g. v3.5.5-alpha)
  - getBasepath
```
public static java.lang.String getBasepath()
```
    JATOS' absolute base path without trailing '/.'
  - getStudyAssetsRootPath
```
public static java.lang.String getStudyAssetsRootPath()
```
    Path in the file system to the study assets root directory. If the property is defined in the configuration file then use it as the base path. If property isn't defined, try in default study path instead.
  - isStudyLogsEnabled
```
public static boolean isStudyLogsEnabled()
```
    Is study logging enabled
  - getStudyLogsPath
```
public static java.lang.String getStudyLogsPath()
```
    Path in the file system where JATOS stores its logs for each study
  - isResultUploadsEnabled
```
public static boolean isResultUploadsEnabled()
```
    Are file uploads via jatos.js allowed?
  - getResultUploadsPath
```
public static java.lang.String getResultUploadsPath()
```
    Path in the file system where JATOS stores uploaded result files
  - getResultUploadsMaxFileSize
```
public static long getResultUploadsMaxFileSize()
```
    Max file size in bytes for a single uploaded file
  - getResultUploadsLimitPerStudyRun
```
public static long getResultUploadsLimitPerStudyRun()
```
    Max size of all files uploaded during a single study run in bytes
  - getResultDataMaxSize
```
public static long getResultDataMaxSize()
```
    Maximal size of result data of one component result in Byte
  - getMaxResultsDbQuerySize
```
public static int getMaxResultsDbQuerySize()
```
    Maximal number of results to be fetched from the DB at once
  - isInMemoryDb
```
public static boolean isInMemoryDb()
```
    Is true if an in-memory database is used.
  - getUserSessionTimeout
```
public static int getUserSessionTimeout()
```
    Time in minutes when the Play session will timeout (defined in application.conf)
  - getUserSessionInactivity
```
public static int getUserSessionInactivity()
```
    Time in minutes a user can be inactive before he will be logged-out (defined in application.conf)
  - isUserSessionValidation
```
public static boolean isUserSessionValidation()
```
    Toggle for user session validation (not the Play session validation which is done by Play).
  - getDbDefaultUrl
```
public static java.lang.String getDbDefaultUrl()
```
    Database URL as defined in application.conf
  - usesMysql
```
public static boolean usesMysql()
```
    Does JATOS use an MySQL database?
  - getDbDefaultDriver
```
public static java.lang.String getDbDefaultDriver()
```
    Database driver as defined in application.conf
  - getJpaDefault
```
public static java.lang.String getJpaDefault()
```
    JPA persistence unit as defined in application.conf
  - getMac
```
public static java.lang.String getMac()
```
    MAC address of the network interface
  - getUserPasswordMinLength
```
public static int getUserPasswordMinLength()
```
    Message that will be displayed during user creation that describes password requirements
  - getUserPasswordStrengthRegex
```
public static org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.String> getUserPasswordStrengthRegex()
```
    Regex that will be used to check the password during user creation
  - getPlayHttpContext
```
public static java.lang.String getPlayHttpContext()
```
    HTTP URL base path: will be the prefix for each URL, e.g. /jatos/test -> /myBasePath/jatos/test
  - getJatosUpdateMsg
```
public static java.lang.String getJatosUpdateMsg()
```
    If in update happened during last startup a message might be stored here
  - getJatosHttpAddress
```
public static java.lang.String getJatosHttpAddress()
```
    JATOS HTTP host address without protocol or port (e.g. 192.168.0.1)
  - getJatosHttpPort
```
public static int getJatosHttpPort()
```
    Port JATOS is running on
  - getLdapUrl
```
public static java.lang.String getLdapUrl()
```
    LDAP URL (with port)
  - getLdapBaseDn
```
public static java.util.List<java.lang.String> getLdapBaseDn()
```
    LDAP base DNs (Distinguished Name)
  - getLdapAdminDn
```
public static java.lang.String getLdapAdminDn()
```
    LDAP admin DN (Distinguished Name) - the admin user is used to search for the actual user that wants to log in
  - getLdapAdminPassword
```
public static java.lang.String getLdapAdminPassword()
```
    LDAP admin password
  - isLdapAllowed
```
public static boolean isLdapAllowed()
```
  - getLdapTimeout
```
public static int getLdapTimeout()
```
    Read timeout for the LDAP server
  - isOauthGoogleAllowed
```
public static boolean isOauthGoogleAllowed()
```
  - getOauthGoogleClientId
```
public static java.lang.String getOauthGoogleClientId()
```
    Google Sign-in Client ID for OAuth / OpenId Connect (OIDC)
  - isDonationAllowed
```
public static boolean isDonationAllowed()
```
    Should the GUI show a donations button
  - termsOfUseUrl
```
public static java.lang.String termsOfUseUrl()
```
    URL to the terms of use that will be shown in a link on the home page
  - getBrandingUrl
```
public static java.lang.String getBrandingUrl()
```
    URL where some static HTML can be found that can be shown instead of the default welcome message on the home page
  - isStudyMembersAllowedToAddAllUsers
```
public static boolean isStudyMembersAllowedToAddAllUsers()
```
    If true, it's allowed to add all users that exist on this JATOS server to be added at once as members of a study
  - isIdCookiesSecure
```
public static boolean isIdCookiesSecure()
```
    If true, the ID cookies' secure attribute will be set
  - getIdCookiesSameSite
```
public static play.mvc.Http.Cookie.SameSite getIdCookiesSameSite()
```
    Which SameSite attribute the ID cookies should set
  - isResultDataExportUseTmpFile
```
public static boolean isResultDataExportUseTmpFile()
```
    If true, result data that are fetched from the database are first stored in a temporary file and only if they are all gathered the file is sent to the browser. If false the result data are streamed directly from the database to the browser.
  - showStudyAssetsSizeInStudyAdmin
```
public static boolean showStudyAssetsSizeInStudyAdmin()
```
    If false, the study assets folder size won't be calculated for the study admin page. Sometimes the filesystem is too slow to allow this.
  - showResultDataSizeInStudyAdmin
```
public static boolean showResultDataSizeInStudyAdmin()
```
    If false, the result data size won't be calculated for the study admin page. Sometime the database is too slow to allow this.
  - showResultFileSizeInStudyAdmin
```
public static boolean showResultFileSizeInStudyAdmin()
```
    If false, the study result file size won't be calculated for the study admin page. Sometimes the filesystem is too slow to allow this.
  - isUserRoleAllowSuperuser
```
public static boolean isUserRoleAllowSuperuser()
```
    If true, it is allowed to grant users the Superuser role

Class Common

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getJatosVersion

getBasepath

getStudyAssetsRootPath

isStudyLogsEnabled

getStudyLogsPath

isResultUploadsEnabled

getResultUploadsPath

getResultUploadsMaxFileSize

getResultUploadsLimitPerStudyRun

getResultDataMaxSize

getMaxResultsDbQuerySize

isInMemoryDb

getUserSessionTimeout

getUserSessionInactivity

isUserSessionValidation

getDbDefaultUrl

usesMysql

getDbDefaultDriver

getJpaDefault

getMac

getUserPasswordMinLength

getUserPasswordStrengthRegex

getPlayHttpContext

getJatosUpdateMsg

getJatosHttpAddress

getJatosHttpPort

getLdapUrl

getLdapBaseDn

getLdapAdminDn

getLdapAdminPassword

isLdapAllowed

getLdapTimeout

isOauthGoogleAllowed

getOauthGoogleClientId

isDonationAllowed

termsOfUseUrl

getBrandingUrl

isStudyMembersAllowedToAddAllUsers

isIdCookiesSecure

getIdCookiesSameSite

isResultDataExportUseTmpFile

showStudyAssetsSizeInStudyAdmin

showResultDataSizeInStudyAdmin

showResultFileSizeInStudyAdmin

isUserRoleAllowSuperuser