de.frame4j

Class Update

java.lang.Object

de.frame4j.util.App

de.frame4j.Update

All Implemented Interfaces:

AttrSettable, TextHelper.MessageComponents, AppMBean, ComVar, UIInfo, ActionListener, EventListener

@MinDoc(copyright="Copyright  1998 - 2005, 2016  A. Weinert",
        author="Albrecht Weinert",
        version="V.50",
        lastModified="4.06.2021",
        usage="start as Java application (-? for help)",
        purpose="updates files and / or directories also by complex criteria")
public class Update
extends App

Update files and directories.

This application updates files for a source to a destination directory. Optionally sub-directories can be worked on recursively. Additionally it is possible to copy files to a backup-directory before they are replaced in the destination directory.

The making of non existent destination directories can be forbidden.

Also, the creating of non existent files in the destination directories can be prohibited; that would mean "update existing files only".

Fundamental rule:
A file will be copied from the source to the destination directory if not existing there or if there older than in source. For source files of length 0 deleting in source instead of copying the empty file can be chosen as option.

Attention: If source and destination directories are on different computers (as network drives e.g.) different time handling and especially asynchronous handling of daylight saving clock switches, can lead to totally surprising results (like updating thousands of files in the wrong direction). The same is true for diskettes or partitions using different file systems. Those effects may be experienced with all tools depending on file date/time — not just this one. But this features some safety / counter measures proven efficient over some years of experience in form of harder and adaptive age difference criteria.

The evaluation of age differences as update criterion may be switched off (by the -xCopy option). This makes the update to a plain copy, but featuring all the other FileService control possibilities.

Hint: To this application Update belongs (as integral part) a .properties file named Updatey.properties. It's part of the documentation.


Copyright 1998 - 2005, 2009 Albrecht Weinert

See Also:

App, FileCriteria

Nested Class Summary

Nested classes/interfaces inherited from interface de.frame4j.util.ComVar

ComVar.Impl

Field Summary

Fields

Modifier and Type	Field and Description
String	back Backup directory.
String	dest Destination directory.
boolean	reverse Reverse roles of source and destination.
String	source Source directory with (optional) file specification.

Fields inherited from class de.frame4j.util.App

ano, appBase, appIO, appStartTime, appStartTimeMS, args, argsOrig, bgColor, err, fullClassName, help, icon, log, mainThread, myClass, myFrame, name, out, outMode, packName, prop, retCode, runFlag, shortClassName, title, verbose, verbosity

Fields inherited from interface de.frame4j.util.ComVar

AUTHOR, BLANK_STRING, cons, CONSOL_ENCODING, COPYRIGHT, D, D_NaN, D_NegInf, D_PosInf, EMPTY_INT_A, EMPTY_STRING, FILE_ENCODING, FRW_CLLD, FS, FSS, H, hasCons, HOST_IP, HOST_IPv4, HOST_NAME, INIT_ERROR, JAR_ENCODING, JH, JOB_DONE_OK, JRL, LOG_OUT_ERROR, M, MAIN_THREAD_EXC, NO_BYTES, NO_CLASSES, NO_DOUBLES, NO_OBJECTS, NO_PARS_ERROR, NO_STRINGS, NOT_WINDOWS, ON_PI, ONE_DAY, ONE_HOUR, ONE_LEAP_YEAR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, ONE_YEAR, OS, PROG_NAME, PROG_SHORT, PS, RUNTIME, S, SHY, UD, UL, UL_UR_da, UR

Fields inherited from interface de.frame4j.net.AttrSettable

ILLEGAL_TYPE, ILLEGAL_VALUE, NO_ATTRIBUTE, NO_KNOWN_ATTRIBUTE, NO_VALUE, OK, retVtext

Method Summary

Modifier and Type	Method and Description
int	doIt() Working method of Update.
static void	main(String[] args) Start method of Update .

Methods inherited from class de.frame4j.util.App

actionPerformed, allowNoPropertiesFile, clientOrder, condHelpLog, connect, errMeld, errMeld, errorExit, errorExit, errorText, extraPropertiesFile, formMessage, formMessage, formMessage, getAbout, getAboutText, getActTime, getAppLogger, getAppStartTime, getArgs, getAuthor, getCopyright, getDbLogger, getExecTimeMs, getExecTimeMsL, getExecTimeString, getHelp, getHelpText, getIcon, getLanguage, getLogHandler, getMessageComponent, getMessageComponentsLength, getMyFrame, getName, getNameWithVersDate, getOutMode, getProp, getPurpose, getStartTime, getStateString, getTheCloser, getTitle, getUsage, getVerbose, getVerbosity, getVersDate, go, go, go, haveIcon, isDebug, isHelp, isHelpLog, isNormal, isRunFlag, isSilent, isTest, isVerbose, logVerbose, logVerbose, makeStatusTextEnd, makeStatusTextStart, messageFormat, normalExit, parsePartial, performeAction, queueAction, regAsStdMBean, repExc, setAboutText, setAttribute, setAttribute, setAuthor, setBgColor, setCodePages, setCopyright, setHelp, setLogOut2, setName, setOutMode, setOutMode, setPurpose, setTitle, setUsage, setVerbose, setVerbose, setVerbosity, setVerbosity, setVersDate, stop, threeLineEndMsg, toString, twoLineEndMsg, twoLineStartMsg, valueLang, valueLang, wakeMainThread

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.frame4j.net.AttrSettable

retVtext

Field Detail

source

public String source

Source directory with (optional) file specification.

After the denotation of the source directory (example D:\weinert\java\) file denotations may follow directly. They may contain wildcards. Using * or ? means that the corresponding commend line parameter has to be put in quotes. Alternatively + can be used instead of *. (Example: D:\weinert\java\Data+.+).

Instead of a file name denotation like in the example a list of types is also possible (example: D:\weinert\java\java;class;bat;html).

dest

public String dest

Destination directory.

This is the denotation of the destination directory where to copy or update the files to.

Non existing directories (and sub-directories) will be made, if that is not explicitly forbidden.

In destination directory denotations the properties stJMT, stHM and stJMTHM (in batch files embraced in percent signs, like %stJMT%, %stHM% and %stJMTHM%) may be used as part of the names. These contain the date and time of the applications start.

reverse

public boolean reverse

Reverse roles of source and destination.

default: false

See Also:

FileService.reverse

back

public String back

Backup directory.

If not empty it is taken as a denotation of a directory (that will be made if needed and not yet existing). To this directory files will be copied, before the will be replaced or deleted in the destination directory dest.

Method Detail

main

public static void main(String[] args)

Start method of Update .

If the application did its job successfully it will end with exit code 0. An exit code > 0 means an abort due to a problem.

Parameters:

args - command line parameter

See Also:

doIt()

doIt

public int doIt()

Working method of Update.

Specified by:

doIt in class App

Returns:

the exit code; 0 means OK

See Also:

Prop, App.go(String[]), App.go(String[], String, CharSequence), App.mainThread