Interface IDialogSettings

All Known Implementing Classes:
DialogSettings

public interface IDialogSettings
An interface to a storage mechanism for making dialog settings persistent. The store manages a collection of key/value pairs. The keys must be strings and the values can be either, strings or array of strings. Convenience API to convert primitive types to strings is provided.

To load/store/cache dialog settings without the assumption of how they should be stored, clients should implement IDialogSettingsProvider.

See Also:
  • Method Details

    • addNewSection

      IDialogSettings addNewSection(String name)
      Create a new section in the receiver and return it.
      Parameters:
      name - the name of the new section
      Returns:
      the new section
      See Also:
    • addSection

      void addSection(IDialogSettings section)
      Add a section in the receiver.
      Parameters:
      section - the section to be added
    • get

      String get(String key)
      Returns the value of the given key in this dialog settings.
      Parameters:
      key - the key
      Returns:
      the value, or null if none
    • getArray

      String[] getArray(String key)
      Returns the value, an array of strings, of the given key in this dialog settings.
      Parameters:
      key - the key
      Returns:
      the array of string, or null if none
    • getBoolean

      boolean getBoolean(String key)
      Convenience API. Convert the value of the given key in this dialog settings to a boolean and return it.
      Parameters:
      key - the key
      Returns:
      the boolean value, or false if none
    • getDouble

      double getDouble(String key) throws NumberFormatException
      Convenience API. Convert the value of the given key in this dialog settings to a double and return it.
      Parameters:
      key - the key
      Returns:
      the value coverted to double, or throws NumberFormatException if none
      Throws:
      NumberFormatException - if the string value does not contain a parsable number.
      See Also:
    • getFloat

      float getFloat(String key) throws NumberFormatException
      Convenience API. Convert the value of the given key in this dialog settings to a float and return it.
      Parameters:
      key - the key
      Returns:
      the value coverted to float, or throws NumberFormatException if none
      Throws:
      NumberFormatException - if the string value does not contain a parsable number.
      See Also:
    • getInt

      int getInt(String key) throws NumberFormatException
      Convenience API. Convert the value of the given key in this dialog settings to a int and return it.
      Parameters:
      key - the key
      Returns:
      the value coverted to int, or throws NumberFormatException if none
      Throws:
      NumberFormatException - if the string value does not contain a parsable number.
      See Also:
    • getLong

      long getLong(String key) throws NumberFormatException
      Convenience API. Convert the value of the given key in this dialog settings to a long and return it.
      Parameters:
      key - the key
      Returns:
      the value coverted to long, or throws NumberFormatException if none
      Throws:
      NumberFormatException - if the string value does not contain a parsable number.
      See Also:
    • getName

      String getName()
      Returns the IDialogSettings name.
      Returns:
      the name
    • getSection

      IDialogSettings getSection(String sectionName)
      Returns the section with the given name in this dialog settings.
      Parameters:
      sectionName - the key
      Returns:
      IDialogSettings (the section), or null if none
      See Also:
    • getSections

      IDialogSettings[] getSections()
      Returns all the sections in this dialog settings.
      Returns:
      the section, or null if none
    • load

      void load(Reader reader) throws IOException
      Load a dialog settings from a stream and fill the receiver with its content.
      Parameters:
      reader - a Reader specifying the stream where the settings are read from.
      Throws:
      IOException - on IO problem while loading
    • load

      void load(String fileName) throws IOException
      Load a dialog settings from a file and fill the receiver with its content.
      Parameters:
      fileName - the name of the file the settings are read from.
      Throws:
      IOException - on IO problem while loading
    • put

      void put(String key, String[] value)
      Adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, double value)
      Convenience API. Converts the double value to a string and adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, float value)
      Convenience API. Converts the float value to a string and adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, int value)
      Convenience API. Converts the int value to a string and adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, long value)
      Convenience API. Converts the long value to a string and adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, String value)
      Adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • put

      void put(String key, boolean value)
      Convenience API. Converts the boolean value to a string and adds the pair key/value to this dialog settings.
      Parameters:
      key - the key.
      value - the value to be associated with the key
    • save

      void save(Writer writer) throws IOException
      Save a dialog settings to a stream
      Parameters:
      writer - a Writer specifying the stream the settings are written in.
      Throws:
      IOException - on IO problem while saving
    • save

      void save(String fileName) throws IOException
      Save a dialog settings to a file.
      Parameters:
      fileName - the name of the file the settings are written in.
      Throws:
      IOException - on IO problem while saving