Class FSGConverter


  • public class FSGConverter
    extends java.lang.Object
    Class for converting FreeCol Savegames (fsg-files).
    Since:
    0.5.2
    See Also:
    getFSGConverter()
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static FSGConverter singleton
      A singleton object of this class.
      private static java.lang.Object singletonLock  
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private FSGConverter()
      Creates an instance of FSGConverter
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private void convertToXML​(java.io.File in, java.io.File out)
      Converts the given input file to an uncompressed and indented XML-file.
      private void convertToXML​(java.io.InputStream ins, java.io.OutputStream outs)
      Converts the data from the given input stream to an uncompressed and indented text to the output stream.
      static FSGConverter getFSGConverter()
      Gets an object for converting FreeCol Savegames.
      static void main​(java.lang.String[] args)
      An entry point for converting FreeCol Savegames.
      private static void printUsage()
      Prints the usage of this program to standard out.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • singletonLock

        private static java.lang.Object singletonLock
    • Constructor Detail

      • FSGConverter

        private FSGConverter()
        Creates an instance of FSGConverter
    • Method Detail

      • getFSGConverter

        public static FSGConverter getFSGConverter()
        Gets an object for converting FreeCol Savegames.
        Returns:
        The singleton object.
      • convertToXML

        private void convertToXML​(java.io.File in,
                                  java.io.File out)
                           throws java.io.IOException
        Converts the given input file to an uncompressed and indented XML-file. Savegame compression is automatically detected, so using this method on an uncompressed savegame creates an indented version of that savegame.
        Parameters:
        in - The input file.
        out - The output file. This file will be overwritten if it already exists.
        Throws:
        java.io.IOException - if thrown while reading or writing the files.
      • convertToXML

        private void convertToXML​(java.io.InputStream ins,
                                  java.io.OutputStream outs)
                           throws java.io.IOException
        Converts the data from the given input stream to an uncompressed and indented text to the output stream. Both streams are closed by this method.

        Savegame compression is automatically detected, so using this method on an uncompressed savegame creates an indented version of that savegame.
        Parameters:
        ins - The input stream.
        outs - The output stream.
        Throws:
        java.io.IOException - if thrown while reading or writing the streams.
      • printUsage

        private static void printUsage()
        Prints the usage of this program to standard out.
      • main

        public static void main​(java.lang.String[] args)
        An entry point for converting FreeCol Savegames.
        Parameters:
        args - The command-line parameters.