de.frame4j

Class Del

java.lang.Object

de.frame4j.util.App

de.frame4j.Del

All Implemented Interfaces:

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

@MinDoc(copyright="Copyright 2003 - 2009, 2016  A. Weinert",
        author="Albrecht Weinert",
        version="V.44",
        lastModified="6.05.2021",
        usage="start as Java application (-? for help)",
        purpose="delete files and / or directories specified also by complex criteria")
public class Del
extends App
implements FileVisitor

Deleting files.

This application deletes files and directories by command line without any prior question. One purpose is the use in scripts. By command line parameters or by an extra .properties file even complex file and directory criteria may be applied.

For deleting according to multiple file or directory denotations also given as a list use the tool Era. Era, allowing optional safety questions, is also suitable for "hand work" / attended use. This tool Del is a "hard" tool for automated / batch processing, that tries to do what it is told — at once.
So use it with very great care at the command line input.

Options allow

• recursively visiting sub-directories, also (-r),
• specifying an age range for files to be deleted (-since, -til, -days, -daysOld),
• deleting all (visited) directories if empty (-d, -delEmpty),
• deleting also non empty directories if the fit the file criteria (-t, -tDel).
  Nota bene: file criteria and not the directory criteria specifying the sub-directories to be visited.
• Output a help text (-?, -help)

The ample possibilities for file and directory criteria may (best) be set by Properties. See FileService . set(PropMap).

Hints:

See the .properties file Del.properties. It is an integral part of this application and may as part of the documentation answer open questions.

For denominating files in the command line so called wildcards may be used:
..\tmp\+.j+ ..\tmp\class;bak;tmp;obj;map
Like in the example + may be substituted for *. If you use * or ? the parameter has to be put in quotes. Otherwise the expansion mechanism of Linux shells will spoil all. No "all clear" signal for Windows here: this bug has been meticulously ported to Windows JREs/JDKs by SUN&Oracle.

© Copyright 2003 Albrecht Weinert

See Also:

Era, Prop, FileCriteria, FileService

Nested Class Summary

Nested classes/interfaces inherited from interface de.frame4j.io.FileVisitor

FileVisitor.Ask, FileVisitor.AskConsImpl, FileVisitor.AskGrafImpl

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

ComVar.Impl

Field Summary

Fields

Modifier and Type	Field and Description
boolean	fDel Do delete files.
String	fileName File(s) to work on.
boolean	noStartDel Don't delete the start directory.
boolean	tDel Also delete directories.

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

Constructor Summary

Constructors

Constructor and Description
Del()

Method Summary

Modifier and Type	Method and Description
int	doIt() Del's working method.
static void	main(String[] args) Start method of Del.
int	visit(File aktDatei) The file visitor implementation.

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

fileName

public String fileName

File(s) to work on.

fDel

public boolean fDel

Do delete files.

default : true

tDel

public boolean tDel

Also delete directories.

default: false

noStartDel

public boolean noStartDel

Don't delete the start directory.

If true, the start directory (specified by parameter) is kept, even if it fits the criteria and is (afterwards) empty.

default: false

Constructor Detail

Del

public Del()

Method Detail

main

public static void main(String[] args)

Start method of Del.

Return code:
Exit 0, if run successfully.
Exit 1, if the deleting of any file or directory was impossible (due to any objections (can only be a lock at DOS/Windows)
Exit 2, if deleting caused exceptions
Exit > 2, Start or parameter problems (nothing done at all)

Parameters:

args - command line parameters

visit

public int visit(File aktDatei)

The file visitor implementation.

This is the "desolator".

Specified by:

visit in interface FileVisitor

Parameters:

aktDatei - the file or directory to be deleted (without any fuss)

Returns:

the response; mostly irrelevant under (pure) action / procedural aspects

See Also:

doUpDate()

doIt

public int doIt()

Del's working method.

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