Class Svetovid

java.lang.Object
Svetovid
public class Svetovid extends Object
This is a utility class that serves as an easy access point to various functionalities of Svetovid library. The main functionalities provided are readers and writers for standard input and output streams and file access, as well as graphical user interface message boxes and dialogs.
Author:
Ivan Pribela

  • Field Details

    • in

      public static StandardSvetovidReader in
      The "standard" input. This reader is already open and ready to supply input data. Typically this stream corresponds to keyboard input or another input source specified by the host environment or user.

    • out

      public static StandardSvetovidWriter out
      The "standard" output. This writer is already open and ready to accept output data. Typically this stream corresponds to display output or another output destination specified by the host environment or user.

    • err

      public static StandardSvetovidErrorWriter err
      The "standard" error output. This writer is already open and ready to accept output data. Typically this stream corresponds to display output or another output destination specified by the host environment or user. By convention, this output stream is used to display error messages or other information that should come to the immediate attention of a user even if the principal output stream, the value of the variable out, has been redirected to a file or other destination that is typically not continuously monitored.

    • gui

      public static AutoCloseDialogFactory gui
      The graphical user interface factory used to create and show message and dialog boxes.

  • Method Details

    • testIn

      public static boolean testIn(String source)
      Checks whether the given source can be used for input.
      Parameters:
      source - a string describing the source
      Returns:
      true if the given source can be read; false otherwise.

    • testOut

      public static boolean testOut(String target)
      Checks whether the given target can be used for output.
      Parameters:
      target - a string describing the target
      Returns:
      true if it is possible to write to the given target; false otherwise.

    • testAppend

      public static boolean testAppend(String target)
      Checks whether the data can be appended to the given target.
      Parameters:
      target - a string describing the target
      Returns:
      true if it is possible to append data to the given target; false otherwise.

    • testOut

      public static boolean testOut(String target, boolean append)
      Checks whether the given target can be used for output.
      Parameters:
      target - a string describing the target
      append - true to check if the data can be appended to the target; false to check if the data can be overwritten
      Returns:
      true if it is possible to write to the given target; false otherwise.

    • in

      public static SvetovidReader in(String source)
      The input reader for the given source. The returned reader is already open and ready to supply input data. If the supplied source string is a file name, the returned reader will correspond to that file. If the source is a url the reader will read the resource identified by that url. Otherwise, the returned reader will correspond to the standard input stream.
      Parameters:
      source - a string describing the source
      Returns:
      a SvetovidReader that can be used to read from the desired source.

    • out

      public static SvetovidWriter out(String target)
      The output writer for the given target. The returned writer is already open and ready to accept output data. If the supplied target string is a file name, the returned writer will correspond to that file; otherwise it will correspond to the standard output stream.
      Parameters:
      target - a string describing the writter's target
      Returns:
      a SvetovidWriter that can be used to write to the desired target.

    • append

      public static SvetovidWriter append(String target)
      The output writer that will append data to the given target. The returned writer is already open and ready to accept output data. If the supplied target string is a file name, the returned writer will correspond to that file; otherwise it will correspond to the standard output stream.
      Parameters:
      target - a string describing the writter's target
      Returns:
      a SvetovidWriter that can be used to write to the desired target.

    • out

      public static SvetovidWriter out(String target, boolean append)
      The output writer that will optionally append data to the given target. The returned writer is already open and ready to accept output data. If the supplied target string is a file name, the returned writer will correspond to that file; otherwise it will correspond to the standard output stream.
      Parameters:
      target - a string describing the writter's target
      append - should the data be appended to the given target or not
      Returns:
      a SvetovidWriter that can be used to write to the desired target.

    • closeIn

      public static SvetovidReader closeIn(String source) throws SvetovidIOException
      Closes the reader (if any) and releases any resources associated with the given source.
      Parameters:
      source - the source for which to close the reader
      Returns:
      the closed reader.
      Throws:
      SvetovidIOException - if an error occurred during the operation.

    • closeOut

      public static SvetovidWriter closeOut(String target) throws SvetovidIOException
      Closes the writer (if any) and releases any resources associated with the given target.
      Parameters:
      target - the target for which to close the writer
      Returns:
      the closed writer.
      Throws:
      SvetovidIOException - if an error occurred during the operation.

    • main

      public static void main(String[] args)
      The main method just prints out the version number.
      Parameters:
      args - this argument is just ignored