From b650c9dc426e7c0c8e6c803064af4528c825a10d Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 10:58:44 +0000 Subject: [PATCH 1/6] Add Javadoc to CruxListProvider constructor --- .../java/de/rub/nds/crawler/targetlist/CruxListProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/CruxListProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/CruxListProvider.java index b979ae8..e50a883 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/CruxListProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/CruxListProvider.java @@ -24,6 +24,11 @@ public class CruxListProvider extends ZipFileProvider { private static final String ZIP_FILENAME = "current.csv.gz"; private static final String FILENAME = "current.csv"; + /** + * Constructs a CruxListProvider with the specified list size. + * + * @param cruxListNumber The number of hosts to extract from the Crux list + */ public CruxListProvider(CruxListNumber cruxListNumber) { super(cruxListNumber.getNumber(), SOURCE, ZIP_FILENAME, FILENAME, "Crux"); } From 5171e2b9ba1e55db4d6b4b2dca000f6b12d124dd Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 10:59:25 +0000 Subject: [PATCH 2/6] Add Javadoc to ITargetListProvider interface method --- .../de/rub/nds/crawler/targetlist/ITargetListProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/ITargetListProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/ITargetListProvider.java index 5e4662f..0155164 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/ITargetListProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/ITargetListProvider.java @@ -12,5 +12,10 @@ public interface ITargetListProvider { + /** + * Retrieves the list of target hosts to scan. + * + * @return A list of target host names + */ List getTargetList(); } From cd69008571de0132181e1998837b68dc58779d6b Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 10:59:41 +0000 Subject: [PATCH 3/6] Add Javadoc to TargetFileProvider constructor --- .../de/rub/nds/crawler/targetlist/TargetFileProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/TargetFileProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/TargetFileProvider.java index 0bffaa7..9e14613 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/TargetFileProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/TargetFileProvider.java @@ -23,6 +23,11 @@ public class TargetFileProvider implements ITargetListProvider { private String filename; + /** + * Constructs a TargetFileProvider with the specified file. + * + * @param filename Path to the file containing target hosts + */ public TargetFileProvider(String filename) { this.filename = filename; } From eaa03edc2ddee01dee339f4b80e296cd86a5fb4f Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 10:59:58 +0000 Subject: [PATCH 4/6] Add Javadoc to TrancoEmailListProvider constructor --- .../rub/nds/crawler/targetlist/TrancoEmailListProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/TrancoEmailListProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/TrancoEmailListProvider.java index 81a03f0..9c43e5e 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/TrancoEmailListProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/TrancoEmailListProvider.java @@ -29,6 +29,11 @@ public class TrancoEmailListProvider implements ITargetListProvider { private final ITargetListProvider trancoList; + /** + * Constructs a TrancoEmailListProvider with the specified Tranco list provider. + * + * @param trancoList The Tranco list provider to extract email servers from + */ public TrancoEmailListProvider(ITargetListProvider trancoList) { this.trancoList = trancoList; } From 2f7309c01ce9d894d3d1083cb176ed85cc57adac Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 11:00:16 +0000 Subject: [PATCH 5/6] Add Javadoc to TrancoListProvider constructor --- .../de/rub/nds/crawler/targetlist/TrancoListProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/TrancoListProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/TrancoListProvider.java index 47d8784..77d8af2 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/TrancoListProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/TrancoListProvider.java @@ -22,6 +22,11 @@ public class TrancoListProvider extends ZipFileProvider { private static final String ZIP_FILENAME = "tranco-1m.csv.zip"; private static final String FILENAME = "tranco-1m.csv"; + /** + * Constructs a TrancoListProvider with the specified number of hosts. + * + * @param number The number of top hosts to extract from the Tranco list + */ public TrancoListProvider(int number) { super(number, SOURCE, ZIP_FILENAME, FILENAME, "Tranco"); } From 449091bf634785fb239624db9a2a023b22e45b57 Mon Sep 17 00:00:00 2001 From: Robert Merget Date: Thu, 19 Jun 2025 11:00:34 +0000 Subject: [PATCH 6/6] Add Javadoc to ZipFileProvider getTargetList method --- .../java/de/rub/nds/crawler/targetlist/ZipFileProvider.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/main/java/de/rub/nds/crawler/targetlist/ZipFileProvider.java b/src/main/java/de/rub/nds/crawler/targetlist/ZipFileProvider.java index ee1419d..7f3fa4f 100644 --- a/src/main/java/de/rub/nds/crawler/targetlist/ZipFileProvider.java +++ b/src/main/java/de/rub/nds/crawler/targetlist/ZipFileProvider.java @@ -41,6 +41,11 @@ protected ZipFileProvider( this.listName = listName; } + /** + * Downloads, extracts, and processes the target list from the configured zip file source. + * + * @return A list of target hosts extracted from the downloaded file + */ public List getTargetList() { List targetList; try {