Package org.apache.maven.settings.io
Interface SettingsReader
- All Known Implementing Classes:
DefaultSettingsReader
public interface SettingsReader
Handles deserialization of settings from some kind of textual format like XML.
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionReads the settings from the specified file.read
(InputStream input, Map<String, ?> options) Reads the settings from the specified byte stream.Reads the settings from the specified character reader.
-
Field Details
-
IS_STRICT
The key for the option to enable strict parsing. This option is of typeBoolean
and defaults totrue
. Iffalse
, unknown elements will be ignored instead of causing a failure.- See Also:
-
-
Method Details
-
read
Reads the settings from the specified file.- Parameters:
input
- The file to deserialize the settings from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized settings, never
null
. - Throws:
IOException
- If the settings could not be deserialized.SettingsParseException
- If the input format could not be parsed.
-
read
Reads the settings from the specified character reader. The reader will be automatically closed before the method returns.- Parameters:
input
- The reader to deserialize the settings from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized settings, never
null
. - Throws:
IOException
- If the settings could not be deserialized.SettingsParseException
- If the input format could not be parsed.
-
read
Reads the settings from the specified byte stream. The stream will be automatically closed before the method returns.- Parameters:
input
- The stream to deserialize the settings from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized settings, never
null
. - Throws:
IOException
- If the settings could not be deserialized.SettingsParseException
- If the input format could not be parsed.
-