16.5.3. JavaFX Application Structure

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class JavaFXApp extends Application {
    public void start(Stage primaryStage) {
        Button btn = new Button("Say Hello");
        btn.setOnAction(e -> System.out.println("Hello from JavaFX"));
        StackPane root = new StackPane(btn);
        Scene scene = new Scene(root, 300, 200);
        primaryStage.setTitle("JavaFX App");
        primaryStage.setScene(scene);
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

This code represents a simple JavaFX application. It defines a class JavaFXApp that extends the Application class, which is required to create any JavaFX application. The method start is where the main logic of the application is defined. Within this method, a Button component named btn is created with the text 'Say Hello'. This button, when clicked, will execute an action that prints 'Hello from JavaFX' to the console. The button is then added to a layout container called StackPane, which organizes its child nodes in a stack. A Scene is created with this layout and a specified width and height. The title of the main window, referred to as primaryStage, is set to 'JavaFX App', and the scene is assigned to this stage, which is then made visible by calling show().

Think of a JavaFX application like a play in a theater. The 'Stage' is the physical stage where the play is performed, and it’s where the audience watches. In this analogy, the 'Scene' represents the entire performance happening on that stage, and the 'Button' is like an actor delivering a specific line. Just as an actor waits for their cue to speak, the button waits for user interaction (like a mouse click) to perform its action.

btn.setOnAction(e -> System.out.println("Hello from JavaFX"));

This line of code is crucial for defining what happens when the button is clicked. setOnAction is a method that attaches an event handler to the button, meaning that it sets up a response that will be activated when the button is clicked. The syntax e -> System.out.println("Hello from JavaFX") is a lambda expression, introduced in Java 8, which provides a concise way to implement functional interfaces like event listeners. In this case, it specifies that when the button is clicked, the message 'Hello from JavaFX' should be printed to the console.

Imagine a doorbell at your home. When someone presses the doorbell (button), it triggers an action: the doorbell rings (the event). In this example, when the button is clicked, it’s like someone pressing that doorbell, and the action is the ringing sound (printing the message) that follows. Thus, it connects a simple action (pressing the button) to a defined response (outputting a message).

StackPane root = new StackPane(btn);
Scene scene = new Scene(root, 300, 200);

Here, a StackPane layout is created, which is a type of container that allows you to stack multiple nodes on top of one another. In this case, it contains only the button btn. The next line initializes a Scene with root as its root node, which serves as the starting point for displaying the UI. The dimensions of the scene are set to 300 pixels in width and 200 pixels in height. This is effectively what the user will see in the application window.

Consider building a display in a store window. The 'StackPane' is like the shelf that holds your items (nodes), and in this instance, it only holds one item (the button). When setting up the display, you create the 'window' where customers will view your items, similar to how creating a 'Scene' defines how your application will visually present its components to users.

primaryStage.setTitle("JavaFX App");
primaryStage.setScene(scene);
primaryStage.show();

This segment of the code configures the main application window. The setTitle method sets the title that appears in the title bar of the window to 'JavaFX App'. The setScene method associates the previously created scene with the primaryStage. Finally, the show() method brings the window to the front and displays it to the user. Without calling show(), the application window would not be visible.

Imagine you are opening a new restaurant. The restaurant's 'primaryStage' is the front of the restaurant where customers enter. When you put up the sign (setting the title) with the restaurant's name, arrange the tables and decor (set the scene), and then open the doors (show), that's when people can see and enter into the restaurant. Similarly, in programming, configuring and displaying the stage allows users to interact with your application.

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

This snippet is the standard entry point for a JavaFX application. The main method is where the Java program starts execution. The launch(args) method is a static method provided by the Application class that initializes the JavaFX framework and prepares the application to run. It essentially sets up the required resources and calls the start method to begin the user interface.

Think of starting a movie screening. The main method is like the director announcing 'Let’s begin!' before the show starts. The launch(args) is akin to pressing the play button on the projector, signaling everything to start running. This is the moment when everything that has been set up (the application’s code, the UI, etc.) comes to life for viewers (users) to engage with.

--