Improved File Operations in standard jobs

1) Parameter: min_file_age, max_file_age

• Der Parameter nimmt Werte in diesen Formaten an:
  + Sekunden (auch > 60)
  + Stunden:Minuten (jeweils max. 2 Stellen)
  + Stunden:Minuten:Sekunden (jeweils max. 2 Stellen, Stunde kann 0 oder 00 sein)
  + Der Wert 0 des Parameters wird ignoriert, wirkt als gäbe es den Parameter nicht

Zur Implementierung der Stunden:Minuten Syntax steht schon ein Beispiel in sos.scheduler.job.JobSchedulerCleanupFiles (Parameter file_age).

Es werden nur Dateien für weitee Operationen berücksichtigt, die

• min_file_age: mindestens,d.h. auch einschließlich, das angegebene Alter besitzen, z.B. werden Dateien nicht kopiert oder gelöscht, die jünger sind.
• max_file_age: höchstens,d.h. auch einschließlich, das angegebene Alter besitzen, z.B. werden Dateien nicht kopiert oder gelöscht, die älter sind.

Beide Parameter können gemeinsam verwendet werden.

Die Erweiterung gilt für CopyFile, RenameFile, RemoveFile, und FileExists bzw. FileNotExists

2) Parameter: min_file_size, max_file_size

• Der Parameter nimmt Werte in diesen Formaten an:
  + Zahl (Byte), z.B. 40
  + ZahlMB, z.B. 20MB (Groß/Kleinschreibung wird ignoriert)
  + ZahlGB, z.B. 10GB (Groß/Kleinschreibung wird ignoriert)
  + Die Werte 0, 0MB, 0GB des Parameters werden ignoriert, wirken als gäbe es den Parameter nicht

Es werden nur Dateien für weitere Operationen berücksichtigt, die

• min_file_size: mindestens,d.h. auch einschließlich, die angegebene Größe besitzen, z.B. werden Dateien nicht kopiert oder gelöscht, die kleinere sind.
• max_file_size: höchstens,d.h. auch einschließlich, die angegebene Größe besitzen, z.B. werden Dateien nicht kopiert oder gelöscht, die größer sind.

Beide Parameter können gemeinsam verwendet werden.

Die Erweiterung gilt für CopyFile, RenameFile, RemoveFile, und FileExists bzw. FileNotExists.
Die Erweiterungen sollen

• in der Basisklasse SOSFileOperations
• in den Job-Klassen
  implementiert sein

Hier gibt es bereits eine Implementierung für FileExists, bitte diese berücksichtigen und kompatibel halten.

3) Parameter: skip_first_files, skip_last_files

• Der Parameter nimmt Werte in diesen Formaten an:
  + Zahl (Anzahl Dateien), z.B. 40
  + Der Wert 0 des Parameters wird ignoriert, wirkt als gäbe es den Parameter nicht

Die Parameter entfernen die angegebene Anzahl Dateien aus der Ergebnismenge, d.h. auf diese Dateien wirkt eine Operation nicht.

Es darf nur eine der beiden Ausprägungen des Parameters angegeben sein, anderenfalls wird ein Fehler ausgeworfen.

Der Parameter wirkt auf die resultierende Menge von Dateien, die durch andere Parameter (min_file_size, min_file_age etc.) hergestellt wird, und beschränkt diese Menge:

• die Menge ist sortiert entsprechend der verwendeten einschränkenden Parameter
  + min_file_age, max_file_age: aufsteigend nach Änderungsdatum der Datei, d.h. jüngere zuerst
  + min_file_size, max_file_size: aufsteigend nach Größe, d.h. kleinere zuerst
  + sind sowohl Parameter für Größe wie Alter angegeben, dann erfolgt die Sortierung nach Alter

• skip_first_files: die angegebene Anzahl Dateien wird vom Beginn der Ergebnismenge entfernt
• skip_last_files: die angegebene Anzahl Dateien wird vom Ende der Ergebnismenge entfernt

• skip_first_files: die ersten, d.h. auch einschließlich der angegebene Anzahl, Dateien sind von der Operation nicht betroffen, z.B. wären 10 Dateien von einer Rename-Operation betroffen, es werden aber die ersten 3 Dateien nicht umbenannt, wenn der Parameter den Wert 3 enthält.

• skip_last_files: die letzten, d.h. auch einschließlich der angegebenen Anzahl, Dateien sind von der Operation nicht betroffen, z.B. wären 10 Dateien von einer Rename-Operation betroffen, es werden aber die letzten 3 Dateien nicht umbenannt, wenn der Parameter den Wert 3 enthält..

Die Erweiterung gilt für CopyFile, RenameFile, RemoveFile, und FileExists bzw. FileNotExists

4) Wirkung

• alle Parameter wirken additiv in ihren Einschränkungen, d.h. zunächst können Parameter den Umfang der betroffenen Dateien einschränken (min_file_size, min_file_age etc.), auf die resultierende Menge wirken dann die Parameter skip_first_files, skip_last_files in der entsprechenden Sortierung.

• entsteht aus der Einschränkung eine leere Menge, dann verhalten sich die Operationen und Jobs wie gehabt, d.h. Sie melden, dass keine Dateien gefunden wurden, der "gracious" (yes,no,all) Parameter wird berücksichtigt.

• rekursive Operationen werden zunächst nur pro Verzeichnis unterstützt