Field Detail

• err

  protected final PrintStream err

  The print stream for error output.

• out

  protected final PrintStream out

  The print stream for standard output.

Constructor Detail

• Application

  protected Application()

  Equivalent to Application(System.out, System.err, true).

• Application

  protected Application(OutputStream out,
             OutputStream err,
             boolean autoFlush)

  Constructs a new command line utility instance.

  Parameters:

  out - the standard output stream.

  err - the error output stream.

  autoFlush - if the output streams are not PrintStreams, then they are wrapped in a new PrintStream with this value as the additional constructor parameter.

Method Detail

• runChecked

  protected abstract int runChecked(String[] args)
                             throws Exception

  Runs this command line utility. Throws an exception if an error occurs.

  Avoid repeating this method and updating the same archive file upon each call! This would degrade the overall performance from O(n) to O(m*n), where m is the number of new or modified entries and n is the number of all entries in the archive file!

  Parameters:

  args - an array of arguments for this command line utility.

  Returns:

  A negative integer in order to continue calling this method in a loop. Otherwise, the return value is used as the exit status of the VM.

  Throws:

  Exception - on any exception.

• setup

  protected void setup()

  Configures the type of the feedback when prompting the user for keys for RAES encrypted ZIP alias ZIP.RAES alias TZP files by the Swing based prompting key manager. If this JVM is running in headless mode, then this configuration is ignored and the user is prompted by the console I/O based prompting key manager.

  Overrides:

  setup in class de.schlichtherle.truezip.file.TApplication<RuntimeException>

• work

  protected final int work(String[] args)

  Runs the work phase by calling runChecked(java.lang.String[]). Prints a user readable error message to the error output stream which was provided to the constructor if an occurs.

  This method is run at least once and repeatedly called until runChecked(java.lang.String[]) returns a non-negative integer for use as the exist status of the VM. After this method, the TApplication.sync() method is called in a finally-block.

  Specified by:

  work in class de.schlichtherle.truezip.file.TApplication<RuntimeException>

  Parameters:

  args - an array of arguments for this command line utility.

  Returns:

  A negative integer in order to continue calling this method in a loop. Otherwise, the return value is used as the exit status of the VM.

  Throws:

  RuntimeException - at the discretion of runChecked(java.lang.String[]).