Steg 1: Sette opp Java-prosjekt, og lage app-mappe og app-klasse

Eclipse strukturerer koden i såkalt prosjekter. Vanligvis har en ett Java-prosjekt for hver app en lager, men hvis en for det meste lager små app-er, så er det greit å samle dem i ett Java-prosjekt. Da blir det mindre arbeid med oppsett.

Et prosjekt er enkelt sagt en mappe med innhold/oppsett tilpasset typen app en skal lage. Først og fremst handler det om å velge programmeringsspråk, så når du skal lage en ny app med JavaFX, så må du lage et Java-prosjekt. Du vil da få en mappe med flere under-mapper, og en av disse heter src og vil inneholde all koden din. For at de ikke skal bli for uoversiktlig, spesielt hvis du har flere app-er i samme prosjekt, så bør du så lage en Java-mappe for app-en din. Når det er gjort så kan lage Java-filen for app-en din!

Steg 2: Skrive og kjøre HelloWorldApp-klassen

En Hello World-app er ment å være den enkleste app-en en kan tenke seg som viser Hello World på skjermen. F.eks. slik som dette:

En slik app må inneholde følgende elementer:

• Den må bygge på Application-klassen (i pakken javafx.application) ved at du skriver extends Application i klassedefinisjonen. Uten det, er klassen rett og slett ikke en app-klasse.

• Den må inneholde en metode (Java-funksjoner kalles metoder) kalt start som lager og putter skjermbilde-elementene inn i app-vinduet (som den får som argument).

• Den kan inneholde en init-metode som typisk brukes for å initialisere variabler i app-en. Koden under har ikke en slik metode.

• Oppstartsfunksjonen main, som kjøres når klassen din startes som et program, må kalle launch-metoden med klassen din som argument. Når du kjører koden vil følgende skje:

  • App-en din vil bli laget. App-en vil være et HelloWorldApp-objekt, også kalt en instans av HelloWorldApp-klassen.
  • init-metoden vil bli kalt (hvis du har en, og det har ikke koden vår)
  • App-vinduet vil bli laget (automatisk av JavaFX, ikke av vår kode)
  • start-metoden blir kalt med app-vinduet som argument (det er derfor det står (Stage primaryStage) bak start-navnet)

Her er den nødvendige koden, med kommentarer:

// klassen ligger i pakken helloworld, og
// det må stemme med package-deklarasjonen
package helloworld;

// med en import-setning, så slipper en å skrive hele navnet på klassene vi bruker
// vi har like godt en import-setning for hver av klassene vi bruker
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.Pane;
import javafx.scene.text.Font;
import javafx.scene.text.Text;
import javafx.stage.Stage;

// bygg på Application-klassen med extends
// det er det som gjør at vår klasse kan fungere som en JavaFX-app
public class HelloWorldApp extends Application {

  // her er metoden som kalles med app-vinduet
  // den tar inn app-vinduet som argument
  public void start(Stage primaryStage) {
    // vi lager oss det grafiske tekst-objektet, av typen Text
    Text helloWorldText = new Text("Hello world");
    // så sier vi hvor i vindet den skal plasseres, x- og y-posisjon
    helloWorldText.setLayoutX(10);
    helloWorldText.setLayoutY(50);
    // vi lager oss et font-objekt, av typen Font
    Font font = Font.font("Arial", 36);
    // og setter den som teksten font
    helloWorldText.setFont(font);

    // vi mnå også lage et panel, av typen Pane
        Pane root = new Pane();
        // vi setter ønsket størrelse, bredde og høyde
        root.setPrefWidth(300);
        root.setPrefHeight(200);
        // og putter teksten inni
    root.getChildren().add(helloWorldText);

    // til slutt legges panelet inn i app-vinduet
        primaryStage.setScene(new Scene(root));
        // og vises frem
        primaryStage.show();
  }

  // dette er den egentlig oppstartsmetoden
  public static void main(String[] args) {
    // kall den innebygde funksjonen launch, med app-klassen vår som argument
    launch(HelloWorldApp.class, args);
  }
}

Steg 3: Bruke kode-kompletteringsfunksjonen i Eclipse

Eclipse inneholder mange nyttige funksjoner for å gjøre koding mer effektivt. Eclipse kjenner til alt Java har av muligheter, og kan både foreslå kode du kan skrive og rette enkle feil i koden.

• Eclipse holder rede på hvilke navn (på variabler, klasser og pakker) som gjelder hvor og kan foreslå alternativer basert på hva du har skrevet inn. Lag en ny linje under der skriftstypen settes med setFont(...). Skriv inn begynnelsen på variablen for Text-objektet f.eks. hello. Så holder du nede ctrl-tasten og trykker mellomrom. Eclipse vil da vise en liste over alle navn som begynner med hello:

  

Her ser du at Eclipse foreslår et variabelnavn (helloWorldText), et pakkenavn (helloworld) og et klassenavn (HelloWorldApp). Hvis du velger helloWorldText, så legges denne teksten inn. Denne funksjonen kalles kode-komplettering (eng: code completion) og gjør det bl.a. greit å bruke lange navn på variabler, klasser og pakker.

• Eclipse vet hvilke verdier du kan sette for ulike typer grafiske objekter og kan hjelpe deg å skrive (og lære) dem. Skriv et punktum (.) etter helloWorldText-navnet. Eclipse vil automatisk aktivere kode-kompletteringsfunksjonen og vise en liste over alle metodene til Text-objektet. Hvis du skriver inn setF så vil Eclipse begrense lista til metodene som begynner med nettopp setF:

  

Der finner du bl.a. setFill og setFont. fill og font kalles egenskaper (eng: properties) og i Java setter du slike egenskaper med metoder som har set foran egenskapsnavnet.

Argument-typen viser hva slags verdi du må gi inn. F.eks. tar setFill et argument av typen Paint (egentlig javafx.scene.paint.Paint). Velg setFill fra lista og skriv inn Color.BLUE. Igjen ser du at Eclipse foreslår navn tilsvarende det du har skrevet.

• Kjør app-en din igjen, så ser du effekten av kallet til setFill-metoden.