JavaFX con Maven — IntelliJ e VSCode

1

Cosa devi saper fare per una GNI

JavaFX non serve per fare effetti speciali: serve per consegnare una piccola applicazione desktop funzionante. L'obiettivo realistico e' saper aprire una finestra, organizzare i controlli, leggere input, reagire ai click e tenere il progetto Maven eseguibile anche su un altro PC.

Base solida JDK 17+, Maven, struttura standard e classe che estende Application.

Interfaccia utile VBox, HBox, GridPane, TextField, Button, TableView.

Logica separata Non mettere tutto nel bottone: crea classi modello e metodi chiari.

GNI Per una gara conta piu' un'app semplice, stabile e leggibile che una GUI enorme. Punta a una schermata principale completa, validazione input e salvataggio dati se richiesto.

Quiz veloce

Qual e' la priorita' in una prova pratica?

Animazioni complesse e CSS avanzato App funzionante, leggibile e ricostruibile con Maven Usare piu' librerie possibili

2

Installazione minima: JDK, Maven, IDE

Prima della gara verifica questi comandi da terminale. Se falliscono, l'IDE puo' sembrare rotto anche quando il progetto e' corretto.

Verifica ambiente

# Java: usa JDK 17 o superiore
java -version
javac -version

# Maven: deve rispondere senza errori
mvn -version

Componente	Cosa installare	Errore tipico
JDK	Temurin/OpenJDK 17 o 21	`JAVA_HOME` punta a una JRE o a un JDK vecchio.
Maven	Maven 3.8+	`mvn` non e' nel `PATH`.
IntelliJ	Community va bene	Project SDK non impostato.
VSCode	Extension Pack for Java	Workspace aperto nella cartella sbagliata.

Comandi gara

Cambia comando e controlla l'output atteso.

3

Progetto Maven: struttura giusta

Maven vuole una struttura precisa. Se la rispetti, IntelliJ, VSCode e terminale vedono lo stesso progetto.

Esplora struttura progetto

Cartella radice: apri questa nell'IDE, non src e non target.

Creazione rapida da terminale

mkdir gni-javafx
cd gni-javafx
mkdir -p src/main/java/it/zuc/gni src/main/resources src/test/java
touch pom.xml

pom.xml essenziale

pom.xml funzionante

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>it.zuc.gni</groupId>
  <artifactId>gni-javafx</artifactId>
  <version>1.0.0</version>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.release>17</maven.compiler.release>
    <javafx.version>21.0.2</javafx.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-controls</artifactId>
      <version>${javafx.version}</version>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.11.0</version>
      </plugin>
      <plugin>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-maven-plugin</artifactId>
        <version>0.0.8</version>
        <configuration>
          <mainClass>it.zuc.gni.Launcher</mainClass>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

Controlla il tuo pom.xml

Incolla qui il tuo pom.xml: il checker verifica gli elementi minimi.

4

Prima app JavaFX senza FXML

Per una gara conviene partire senza FXML: meno file, meno magia, debug piu' diretto. Quando sei sicuro puoi aggiungere Scene Builder, ma non serve per una prova decente.

Launcher.java

package it.zuc.gni;

public class Launcher {
    public static void main(String[] args) {
        App.main(args);
    }
}

App.java

package it.zuc.gni;

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.control.*;
import javafx.scene.layout.*;
import javafx.stage.Stage;

public class App extends Application {
    private final ListView<String> risultati = new ListView<>();

    @Override
    public void start(Stage stage) {
        TextField nome = new TextField();
        nome.setPromptText("Nome studente");

        TextField punti = new TextField();
        punti.setPromptText("Punti");

        Button aggiungi = new Button("Aggiungi");
        aggiungi.setOnAction(event -> aggiungiRisultato(nome, punti));

        HBox form = new HBox(8, nome, punti, aggiungi);
        VBox root = new VBox(12, new Label("Classifica GNI"), form, risultati);
        root.setPadding(new Insets(16));

        stage.setTitle("GNI JavaFX");
        stage.setScene(new Scene(root, 640, 420));
        stage.show();
    }

    private void aggiungiRisultato(TextField nome, TextField punti) {
        if (nome.getText().isBlank() || punti.getText().isBlank()) {
            new Alert(Alert.AlertType.WARNING, "Compila entrambi i campi").showAndWait();
            return;
        }
        risultati.getItems().add(nome.getText() + " - " + punti.getText() + " punti");
        nome.clear();
        punti.clear();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

Errore comune Se vedi "JavaFX runtime components are missing", non lanciare la classe con il pulsante Java generico: usa mvn javafx:run o configura l'IDE per usare il goal Maven.

5

IntelliJ e VSCode: stesso progetto, due flussi

Il progetto deve funzionare prima da terminale. Poi l'IDE diventa solo un aiuto per scrivere, completare e fare debug.

IntelliJ IDEA Community

Apri la cartella che contiene pom.xml con File > Open.
Quando IntelliJ chiede se importare Maven, accetta.
Controlla File > Project Structure > Project SDK: deve essere JDK 17+.
Apri il pannello Maven, espandi Plugins > javafx e lancia javafx:run.
Per debug: crea una Run Configuration Maven con command line javafx:run.

Configurazione Maven in IntelliJ

Run > Edit Configurations > + > Maven
Working directory: cartella del progetto
Command line: javafx:run
JRE: Project JDK 17+

Visual Studio Code

Installa Extension Pack for Java e Maven for Java.
Apri la cartella radice del progetto, non il singolo file Java.
Attendi "Importing Maven projects". Se non parte, usa Java: Clean Java Language Server Workspace.
Nel pannello Maven lancia Plugins > javafx > javafx:run.
Se il pulsante Run sopra main fallisce, non e' grave: per JavaFX usa Maven.

.vscode/settings.json opzionale

{
  "java.configuration.updateBuildConfiguration": "automatic",
  "java.compile.nullAnalysis.mode": "automatic"
}

Quiz veloce

Se IntelliJ/VSCode non trova JavaFX ma mvn javafx:run funziona, cosa controlli?

Cambio linguaggio Cancello pom.xml Import Maven, JDK del progetto e configurazione Maven run

6

Schema da usare in gara

Quando arriva una traccia, non partire dalla grafica. Parti dai dati e dalle azioni. Poi costruisci una finestra che permetta di usare quelle azioni.

Fase	Cosa fare	Output concreto
1. Modello	Identifica entita' e campi.	`Studente`, `Squadra`, `Risultato`.
2. Logica	Scrivi metodi senza JavaFX.	`aggiungi`, `cerca`, `ordina`, `calcolaTotale`.
3. GUI	Collega campi e bottoni ai metodi.	`TextField`, `ComboBox`, `TableView`.
4. Validazione	Blocca input vuoti o numeri non validi.	`Alert` chiaro e nessun crash.
5. Consegna	Prova da terminale pulito.	`mvn clean javafx:run` riuscito.

Controlli JavaFX da conoscere

Label: testo statico.
TextField e TextArea: input breve o lungo.
Button: azione con setOnAction.
ComboBox<T>: scelta da elenco.
ListView<T>: elenco semplice.
TableView<T>: dati tabellari, utile per classifiche e gestionali.
VBox, HBox, BorderPane, GridPane: layout base.

Strategia Se il tempo stringe, consegna una GUI meno bella ma completa: input, lista dati, operazione principale, messaggio di errore e istruzioni per esecuzione.

7

Quiz finale

Controllo rapido prima di usare il tutorial come traccia di ripasso.

0 / 6