Package cli.checklinks

Class FileLinkChecker

java.lang.Object
cli.checklinks.FileLinkChecker
All Implemented Interfaces:
Callable<Integer>
public class FileLinkChecker extends Object implements Callable<Integer>
Ein Kommando-Zeilenwerkzeug zur Überprüfung von file://-Links in Java- und Markdown-Dateien.

Diese Klasse implementiert einen Link-Checker, der rekursiv durch Dateien und Verzeichnisse geht und alle file://-URIs validiert. Sie überprüft, ob die Zieldateien existieren und gibt detaillierte Berichte über fehlerhafte oder fehlende Links aus.

Funktionsweise

  • Sammelt alle unterstützten Quelldateien (Java und Markdown) aus den angegebenen Verzeichnissen
  • Durchsucht jede Datei nach file://-Links mittels regulärer Ausdrücke
  • Für Java-Dateien: Extrahiert Links nur aus Kommentaren (Zeilen- und Blockkommentare)
  • Für Markdown-Dateien: Scannt den gesamten Inhalt
  • Validiert jeden gefundenen Link und meldet fehlerhafte oder fehlende Ziele

Verwendung

 java cli.checklinks.FileLinkChecker [OPTIONS] [ROOT...]

Optionen

  • -v, --verbose: Gibt auch gültige Links aus
  • -h, --help: Zeigt die Hilfemeldung an

Parameter

  • ROOT: Optionale Liste von Dateien oder Verzeichnissen zum Scannen. Standardmäßig wird das aktuelle Verzeichnis verwendet

Rückgabeverte

  • 0: Alle Links sind gültig
  • 1: Ein oder mehrere fehlerhafte oder fehlende Links wurden gefunden
Since:
0.45.0
Author:
Josef Friedrich

  • Constructor Details

    • FileLinkChecker

      public FileLinkChecker()

  • Method Details

    • call

      public Integer call()
      Führt die Überprüfung von Dateiverknüpfungen durch.

      Diese Methode scannt alle Quelldateien in den angegebenen Wurzelverzeichnissen auf file:// URIs und überprüft, ob die referenzierten Ziele existieren.

      Der Prozess umfasst folgende Schritte:

      • Sammlung aller Quelldateien aus den Wurzelverzeichnissen
      • Zeilenweise Verarbeitung jeder Datei mit UTF-8 Codierung
      • Filterung von Kommentarbereichen (Block-Kommentare werden ignoriert)
      • Extraktion und Validierung von file:// URI-Mustern
      • Bereinigung von nachfolgenden Satzzeichen
      • Auflösung und Überprüfung der Verknüpfungsziele

      Für jede überprüfte Verknüpfung wird überprüft:

      • Ob das Ziel existiert (broken flag)
      • Im ausführlichen Modus werden erfolgreiche Links grün angezeigt
      • Fehlerhafte Verknüpfungen werden gesammelt und am Ende angezeigt

      Fehler beim Dateizugriff werden ebenfalls erfasst und in den Bericht aufgenommen.

      Specified by:
      call in interface Callable<Integer>
      Returns:
      0, wenn keine fehlerhaften Verknüpfungen gefunden wurden; 1 sonst
      Since:
      0.45.0

    • main

      public static void main(String[] args)