Package org.openhab.core.thing.fileconverter

Interface ThingFileParser

@NonNullByDefault public interface ThingFileParser
ThingFileParser is the interface to implement by any file parser for Thing object.
Author:
Laurent Garnier - Initial contribution

  • Method Details

    • getFileFormatParser

      String getFileFormatParser()
      Returns the format of the syntax.
      Returns:
      the syntax format

    • startParsingFileFormat

      @Nullable String startParsingFileFormat(String syntax, List<String> errors, List<String> warnings)
      Parse the provided syntax in file format without impacting the thing registry.
      Parameters:
      syntax - the syntax in file format
      errors - the list to be used to fill the errors
      warnings - the list to be used to fill the warnings
      Returns:
      the model name used for parsing if the parsing succeeded without errors; null otherwise

    • getParsedThings

      Collection<Thing> getParsedThings(String modelName)
      Get the Thing objects found when parsing the file format.
      Parameters:
      modelName - the model name used for parsing
      Returns:
      the collection of things

    • getParsedChannelLinks

      Collection<ItemChannelLink> getParsedChannelLinks(String modelName)
      Get the ItemChannelLink objects found when parsing the file format.
      Parameters:
      modelName - the model name used for parsing
      Returns:
      the collection of items channel links

    • finishParsingFileFormat

      void finishParsingFileFormat(String modelName)
      Release the data from a previously started file format parsing.
      Parameters:
      modelName - the model name used for parsing