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

  • Field Details

    • IS_STRICT

      static final String IS_STRICT
      The key for the option to enable strict parsing. This option is of type Boolean and defaults to true. If false, unknown elements will be ignored instead of causing a failure.
      See Also:

  • Method Details

    • 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 be null.
      options - The options to use for deserialization, may be null 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 be null.
      options - The options to use for deserialization, may be null 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 be null.
      options - The options to use for deserialization, may be null 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.