getUpdateableBean

Returns a JAXB bean representing a view of the settings document, on which updates can be made.

Any subsequent call to this method on the same updateable-settings instance will continue to return the same bean instance, preserving any updates that have been made on it so far.

Updates made on the bean returned by this method will not persisted to the backend until save() is called.

Typically one would typecast the bean returned by this method to the appropriate JAXB class associated with the XSD on which the settings document is based, and call getters and setters on it to read and update the settings info.

Returns:

JAXB bean representing a view of the settings document, on which updates can be made

Throws:

SettingsException - If any error occurs while reading the document or preparing an updateable JAXB bean for it