Marker interface for various
beans holding configuration information.
Conventions:
- The fields' meaning is described in the Javadoc for the getter, not for the field; for
example, to find out what foo field in configuration means, look at documentation for
getFoo().
- The default meaning of a field is defined in the corresponding constant named with
DEFAULT_ prefix and further using of upper-case-underscore-delimited convention (not
camel case). It is recommended that the setter is written to substitute this value for null or
empty string, and to log it.
- When a value is effectively an enum, it is suggested that possible values are enumerated, for
example, as
Partly these conventions are done so that we may write a simple tool to generate config file with
all possible values.