feat(logging): migrate to SLF4J/logback (#3)

* feat(logging): migrate to SLF4J/logback

- Replace custom Debug/logger implementations with SLF4J
- Add centralized ErrorHandler with dialog
- Configure Logback with file rotation

* feat(logging): switch to JSON logs with logstash-logback-encoder

Migrated from plain text to structured JSON logging using logstash-logback-encoder.
Simplified logback.xml, added colored console output, and enabled JSON files for structured logs.

* docs(logging): update README with new NDJSON log format configuration

Updates documentation to reflect the switch from plain text to NDJSON logging format.

---------

Co-authored-by: Riccardo Bertelli <riccardo@codetotime.com>

Author: matteotrubini

README.md

@@ -3,12 +3,15 @@
 EPPClient è un'applicazione desktop Java per l'interazione con i server EPP (Extensible Provisioning Protocol) del Registro .it, a supporto dei Registrar nella gestione di domini, contatti e messaggi EPP. Fornisce un'interfaccia grafica e strumenti idonei alle principali operazioni di registrazione e mantenimento.
 
 ## Cos'è e a cosa serve
+
 - Gestione dei domini .it tramite EPP (creazione, aggiornamento, trasferimento, ecc.).
 - Gestione della rubrica contatti e della messaggistica EPP.
 - Funzionalità operative a supporto dell'attività quotidiana del Registrar.
 
 ## Origini del progetto
+
 Il progetto nasce come rimodernizzazione del software originale sviluppato dall'associazione [AssoTLD](https://www.assotld.it/) per i propri soci. Il software è stato aggiornato e rilasciato come software libero, con l'aggiunta di varie funzionalità, tra cui il supporto a DNSSEC, la gestione dei domini .gov.it e .edu.it e l'esportazione del database in formato CSV, oltre all'aggiornamento di tutte le dipendenze obsolete.
+
 ## Licenze
 
 - Le informazioni dettagliate sono disponibili nella cartella `LICENSES/` alla radice del progetto e nel file `REUSE.toml` (convenzioni [REUSE](https://reuse.software/)).
@@ -31,16 +34,21 @@ Il nome esatto del JAR da utilizzare è indicato nel file `build.gradle` alla se
 Per la compilazione e l'esecuzione in ambiente di sviluppo si utilizza Gradle.
 
 ### Requisiti
+
 - Java 21
 
 ### Esecuzione in sviluppo
+
 Per avviare l'applicazione direttamente tramite Gradle, eseguire:
+
 ```bash
 ./gradlew run
 ```
 
 ### Compilazione
+
 Per compilare il progetto senza eseguirlo:
+
 ```bash
 ./gradlew build
 ```
@@ -52,24 +60,62 @@ Per compilare il progetto senza eseguirlo:
 Il "fat jar" è un file JAR che include tutte le dipendenze necessarie per eseguire l'applicazione in modo autonomo.
 
 ### Generazione del Jar eseguibile
+
 Per generare il fat jar, eseguire il comando:
+
 ```bash
 ./gradlew shadowJar
 ```
+
 Al termine, il file generato sarà disponibile nella cartella:
 `build/libs/`
 
 Il nome del file sarà simile a:
 `eppclient-<versione>-all.jar`
 
-(Esempio: `eppclient-2.3.1-SNAPSHOT-all.jar`)
+(Esempio: `eppclient-2.3.1-all.jar`)
 
 ### Esecuzione del Fat Jar
+
 Per eseguire l'applicazione utilizzare il comando `java -jar`:
+
 ```bash
 java -jar build/libs/eppclient-<versione>-all.jar
 ```
-*(Verificare il nome del file generato presente nella cartella build/libs)*
+
+_(Verificare il nome del file generato presente nella cartella build/libs)_
+
+---
+
+## Opzioni di log e debug
+
+L'applicazione registra i messaggi sia su console che su file simultaneamente. Il livello di log predefinito è `INFO`.
+
+### Configurazione del livello di log
+
+Per cambiare il livello di log, utilizzare il flag `-Deppclient.logLevel`:
+
+```bash
+java -Deppclient.logLevel=DEBUG -jar build/libs/eppclient-<versione>-all.jar
+```
+
+### Logging su file (NDJSON)
+
+I log vengono salvati in formato NDJSON nel file `logs/eppclient.log` con rotazione giornaliera (mantenuti per un massimo di 30 giorni).
+Questo formato strutturato include i campi: `timestamp`, `loglevel`, `logger`, `message`, `thread`, `stackTrace`.
+
+### Livelli di log disponibili
+
+- `ERROR` - Solo errori
+- `WARN` - Warning e errori
+- `INFO` - Info, warning e errori
+- `DEBUG` - Messaggi di debug completi
+- `TRACE` - Trace dettagliato
+- `OFF` - Disabilita il logging
+
+### Visualizzatore log integrato
+
+Quando il debug logging è abilitato, appare automaticamente il pulsante "Apri Log" nella schermata principale che apre il visualizzatore dei log con filtro per livello.
 
 ---
 
@@ -98,18 +144,23 @@ Il progetto Derby è stato abbandonato nel 2025. Per il momento si è deciso di
 ## Software Bill of Materials (SBOM)
 
 Componenti e versioni principali attualmente in uso (si veda `build.gradle`):
-- org.apache.xmlbeans:xmlbeans:3.1.0
-- org.apache.httpcomponents:httpclient:4.5.14
-- org.apache.httpcomponents:httpcore:4.4.16
-- epp-client-cmd-line:1.19.1 (Fornito dal Registro .it, JAR locale da collocare in `libs/`)
+
+- ch.qos.logback:logback-classic:1.5.32
+- ch.qos.logback:logback-core:1.5.32
+- com.google.code.gson:gson:2.13.2
+- com.mysql:mysql-connector-j:9.6.0
 - org.apache.derby:derby:10.17.1.0
 - org.apache.derby:derbytools:10.17.1.0
+- org.apache.httpcomponents:httpclient:4.5.14
+- org.apache.httpcomponents:httpcore:4.4.16
+- org.apache.xmlbeans:xmlbeans:3.1.0
+- net.logstash.logback:logstash-logback-encoder:9.0
 - org.slf4j:slf4j-api:2.0.17
-- org.slf4j:slf4j-simple:2.0.17
-- com.google.code.gson:gson:2.13.2
+- epp-client-cmd-line:1.19.1 (Fornito dal Registro .it, JAR locale da collocare in `libs/`)
 - test: org.junit:junit-bom:5.10.0; org.junit.jupiter:junit-jupiter
 
 Runtime/Build:
+
 - Java 21
 
 ---

build.gradle

@@ -24,16 +24,18 @@ repositories {
 }
 
 dependencies {
-    implementation('org.apache.xmlbeans:xmlbeans:3.1.0')
-    implementation('org.apache.httpcomponents:httpclient:4.5.14')
-    implementation('org.apache.httpcomponents:httpcore:4.4.16')
-    implementation(files('libs/epp-client-cmd-line-1.19.1.jar'))
+    implementation('ch.qos.logback:logback-classic:1.5.32')
+    implementation('ch.qos.logback:logback-core:1.5.32')
+    implementation('com.google.code.gson:gson:2.13.2')
+    implementation('org.mariadb.jdbc:mariadb-java-client:3.5.7')
     implementation('org.apache.derby:derby:10.17.1.0')
     implementation('org.apache.derby:derbytools:10.17.1.0')
+    implementation('org.apache.httpcomponents:httpclient:4.5.14')
+    implementation('org.apache.httpcomponents:httpcore:4.4.16')
+    implementation('org.apache.xmlbeans:xmlbeans:3.1.0')
+    implementation('net.logstash.logback:logstash-logback-encoder:9.0')
     implementation('org.slf4j:slf4j-api:2.0.17')
-    implementation('org.slf4j:slf4j-simple:2.0.17')
-    implementation('com.google.code.gson:gson:2.13.2')
-    implementation('org.mariadb.jdbc:mariadb-java-client:3.5.7')
+    implementation(files('libs/epp-client-cmd-line-1.19.1.jar'))
 
     testImplementation platform('org.junit:junit-bom:5.10.0')
     testImplementation 'org.junit.jupiter:junit-jupiter'
@@ -104,4 +106,4 @@ jar {
     manifest {
         attributes('Main-Class': application.mainClass)
     }
-}
+}

src/main/java/EPPClient/ErrorHandler.java

@@ -0,0 +1,93 @@
+/*
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * This file is part of EPPClient.
+ *
+ * EPPClient is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ *
+ * EPPClient is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along with EPPClient. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package EPPClient;
+
+import java.awt.Component;
+import javax.swing.JDialog;
+import javax.swing.JFrame;
+import javax.swing.JOptionPane;
+import org.slf4j.Logger;
+
+/**
+ * Centralized error handling utility class.
+ * Provides dialog display for errors - logging is done directly via SLF4J.
+ */
+public class ErrorHandler
+{
+
+  /**
+   * Default message shown to users when an error occurs.
+   */
+  public static final String DEFAULT_USER_MESSAGE = "Si è verificato un errore durante l'operazione.\n\n" + "Consultare i log per maggiori dettagli.";
+
+  /**
+   * Logs an error and shows a dialog to the user.
+   * The exception is logged at ERROR level with full stack trace.
+   *
+   * @param logger The SLF4J logger instance
+   * @param exception The exception that occurred
+   * @param userTitle The title for the error dialog
+   * @param parent The parent frame for the dialog
+   */
+  public static void error(Logger logger, Exception exception, String userTitle, JFrame parent)
+  {
+    logger.error("Error occurred: {}", exception.getMessage(), exception);
+    showErrorDialog(parent, userTitle);
+  }
+
+  /**
+   * Logs an error without showing a dialog.
+   *
+   * @param logger The SLF4J logger instance
+   * @param exception The exception that occurred
+   */
+  public static void logError(Logger logger, Exception exception)
+  {
+    logger.error("Error occurred: {}", exception.getMessage(), exception);
+  }
+
+  /**
+   * Shows an error dialog to the user
+   *
+   * @param parent The parent component for the dialog
+   * @param title The title of the dialog
+   */
+  public static void showErrorDialog(Component parent, String title, String message) {
+    JOptionPane optionPane = new JOptionPane(
+            message,
+            JOptionPane.ERROR_MESSAGE,
+            JOptionPane.DEFAULT_OPTION,
+            null,
+            new Object[]{"OK"},
+            "OK"
+    );
+
+    JDialog dialog = optionPane.createDialog(parent, title);
+    dialog.setResizable(false);
+    dialog.setVisible(true);
+    dialog.dispose();
+  }
+
+  /**
+   * Shows an error dialog to the user with the default message.
+   * Delegates to {@link #showErrorDialog(Component, String, String)}.
+   *
+   * @param parent The parent component for the dialog
+   * @param title The title of the dialog
+   */
+  public static void showErrorDialog(Component parent, String title)
+  {
+    showErrorDialog(parent, title, DEFAULT_USER_MESSAGE);
+  }
+}

src/main/java/EPPClient/UpdateChecker.java

@@ -27,9 +27,13 @@
 import java.net.URL;
 import java.util.ArrayList;
 import java.util.List;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 public class UpdateChecker {
 
+  private static final Logger log = LoggerFactory.getLogger(UpdateChecker.class);
+
     private static final String GITHUB_API_URL = "https://api.github.com/repos/CodeToTime/EPPClient/releases";
 
     public static void checkForUpdates(Component parent, String currentVersion) {
@@ -46,7 +50,7 @@ public static void checkForUpdates(Component parent, String currentVersion) {
                 }
             } catch (Exception e) {
                 // Silenziosamente ignora errori di rete
-                System.err.println("Errore durante il controllo aggiornamenti: " + e.getMessage());
+                log.warn("Errore durante il controllo aggiornamenti: {}", e.getMessage());
             }
         }).start();
     }