Provides interfaces to store and retrieve data about controls.

Control is done via crates, with a crate being made up of a number of channels. Each channel has a number of parameters associated with it. The {@link mice.cdb.service.control.Control Control} class provides methods to retrieve parameter values and the {@link mice.cdb.service.control.ControlSuperMouse ControlSuperMouse} class extends the Control interface providing additional methods to store parameters values.

The data about controls are made persistent via a relational database. The address of the database is determined from the configuration file cdb.props . The configuration file can be found at MICE_HOME/etc/cdb-server/ , where MICE_HOME is a property passed into the servlet container. By default if MICE_HOME is not set then the value /opt/mice is used. The configuration file should contain the following properties:

db.url
db.name
db.user
db.pwd
db.superUser
db.superPwd

Where db.url is the URL of the database to use, db.name is the name of the database, db.user and db.pwd should point a READ ONLY account for use by the Control class and db.superUser and db.superPwd are used by the ControlSuperMouse class for READ/WRITE access to the database.

@since 1.0