Interface BatchConverter

  • All Known Implementing Classes:
    BatchConverterBase, BatchConverterImpl

    public interface BatchConverter
    This is an interface for a converter, which offers conversion of all OpenDocument (or OpenOffice.org 1.x) documents in a directory (and optionally subdirectories), creating index pages in a specific format. Instances of this interface are created using the ConverterFactory
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void convert​(java.io.File source, java.io.File target, boolean bRecurse, BatchHandler handler)
      Convert a directory using the given Converter (if none is given, all files will be ignored).
      OutputFile createIndexFile​(java.lang.String sHeading, IndexPageEntry[] entries)
      Create an index page with specific entries
      Config getConfig()
      Get the configuration interface for this batch converter
      void readTemplate​(java.io.File file)
      Read a template to use as a base for the index pages.
      void readTemplate​(java.io.InputStream is)
      Read a template to use as a base for the index pages.
      void setConverter​(Converter converter)
      Define a Converter implementation to use for conversion of the individual documents.
    • Method Detail

      • getConfig

        Config getConfig()
        Get the configuration interface for this batch converter
        Returns:
        the configuration
      • setConverter

        void setConverter​(Converter converter)
        Define a Converter implementation to use for conversion of the individual documents. If no converter is given, the convert method cannot convert documents (but can still create index pages).
        Parameters:
        converter - the Converter to use
      • readTemplate

        void readTemplate​(java.io.InputStream is)
                   throws java.io.IOException
        Read a template to use as a base for the index pages. The format of the template depends on the BatchConverter implementation.
        Parameters:
        is - an InputStream from which to read the template
        Throws:
        java.io.IOException - if some exception occurs while reading the template
      • readTemplate

        void readTemplate​(java.io.File file)
                   throws java.io.IOException
        Read a template to use as a base for the index pages. The format of the template depends on the BatchConverter implementation.
        Parameters:
        file - the file from which to read the template
        Throws:
        java.io.IOException - if the file does not exist or some exception occurs while reading the template
      • createIndexFile

        OutputFile createIndexFile​(java.lang.String sHeading,
                                   IndexPageEntry[] entries)
        Create an index page with specific entries
        Parameters:
        sHeading - a heading describing the index page
        entries - an array of IndexPageEntry objects (null entries are allowed, and will be ignored) describing the individual directories and documents
      • convert

        void convert​(java.io.File source,
                     java.io.File target,
                     boolean bRecurse,
                     BatchHandler handler)
        Convert a directory using the given Converter (if none is given, all files will be ignored). This method fails silently if you haven't set a converter.
        Parameters:
        source - a File representing the directory to convert
        target - a File representing the directory to contain the converted documents
        bRecurse - determines wether or not to recurse into subdirectories
        handler - a BatchHandler