Package org.apache.maven.toolchain.io
Interface ToolchainsReader
-
- All Known Implementing Classes:
DefaultToolchainsReader
public interface ToolchainsReader
Handles deserialization of toolchains from some kind of textual format like XML.- Since:
- 3.3.0
- Author:
- Robert Scholte
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description PersistedToolchains
read(File input, Map<String,?> options)
Reads the toolchains from the specified file.PersistedToolchains
read(InputStream input, Map<String,?> options)
Reads the toolchains from the specified byte stream.PersistedToolchains
read(Reader input, Map<String,?> options)
Reads the toolchains from the specified character reader.
-
-
-
Field Detail
-
IS_STRICT
static final String 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:
- Constant Field Values
-
-
Method Detail
-
read
PersistedToolchains read(File input, Map<String,?> options) throws IOException, ToolchainsParseException
Reads the toolchains from the specified file.- Parameters:
input
- The file to deserialize the toolchains from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized toolchains, never
null
. - Throws:
IOException
- If the toolchains could not be deserialized.ToolchainsParseException
- If the input format could not be parsed.
-
read
PersistedToolchains read(Reader input, Map<String,?> options) throws IOException, ToolchainsParseException
Reads the toolchains from the specified character reader. The reader will be automatically closed before the method returns.- Parameters:
input
- The reader to deserialize the toolchains from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized toolchains, never
null
. - Throws:
IOException
- If the toolchains could not be deserialized.ToolchainsParseException
- If the input format could not be parsed.
-
read
PersistedToolchains read(InputStream input, Map<String,?> options) throws IOException, ToolchainsParseException
Reads the toolchains from the specified byte stream. The stream will be automatically closed before the method returns.- Parameters:
input
- The stream to deserialize the toolchains from, must not benull
.options
- The options to use for deserialization, may benull
to use the default values.- Returns:
- The deserialized toolchains, never
null
. - Throws:
IOException
- If the toolchains could not be deserialized.ToolchainsParseException
- If the input format could not be parsed.
-
-