Skip to content
/ se2rest Public

This repository includes a tutorial for the module "Software Engineering 2" by Professor Wolfgang Lux @ University Of Applied Sciences Düsseldorf.

ei.hs-duesseldorf.de/personen/lux
4 stars 1 fork Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

hs-duesseldorf/se2rest

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
images
images
 
 
README.md
README.md
 
 
README_eclipse.md
README_eclipse.md
 
 

Repository files navigation

1. Introduction

In this course we will build a very simple JavaFX client app which can create the simplest form of users/persons with only one attribute (name) which is sent to a Java server via HTTP. The server will digest those requests by either storing or getting the data in/from a MariaDB database.

We use Java, Maven, Spring Boot, and XAMPP for this.

We use the development environment VSCode, but thanks to the modularity of Maven projects any other Java development environment could also be used like Intellij IDEA, NetBeans or Eclipse!

So please make sure you have ALL of the following software installed BEFORE you start with the database, server or client!

1.1. Download-Links / Quick-install commands

WINDOWS
  • Winget for Windows 10 users: LINK (winget is installed in Windows 11 by default)
  • Java Open JDK 17
    • Either via installer: Adoptium Open JDK installer
    • Or via winget (system-wide by default): 
      winget install EclipseAdoptium.Temurin.17.JDK
  • Visual Studio Code
    • Either via installer: Visual Studio Code Installer
    • Or with winget system-wide: 
      winget install Microsoft.VisualStudioCode --scope machine
    • Or with winget as a user-only installation: 
      winget install Microsoft.VisualStudioCode
  • VSCode Java extension pack
  • VSCode Spring Boot extension pack
  • Gluon Scene Builder
  • Maven
    • open powershell as administrator (right-click: open as administrator) and run: 
      Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
    • Once the installation is completed, close the Powershell (Admin) or Terminal (Admin) and open it again and run: 
      choco install maven
MACOS

  • Homebrew (If wanted)

    • If wanted you can use homebrew to complete the following installation steps. Homebrew is a unofficial package manager for macOS, which should help you with installing new software on your system. To get started with homebrew just paste the following command inside your terminal window: 
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  • Java Open JDK 17

  • Visual Studio Code

  • VSCode Java extension pack

  • VSCode Spring Boot extension pack

  • Gluon Scene Builder

  • Maven

    • Either manually using these setup instructions: Maven - Installing
    • Or via brew: 
      brew install maven
UBUNTU

1.2. Learning Goals

  • Use Maven to access external Java libraries
  • Use abstract classes, abstract methods and generics to reduce code duplication
  • Get to know Spring Boot
  • Learn REST and HTTP basics
  • Learn the basics of JavaFX and Scene Builder
  • Understand the use case for the Singleton software design pattern

2. Database

2.1. Install XAMPP

A very comfortable way of setting up a XAMPP installation is via a Docker container.

2.1.1 Install Docker in Ubuntu

  • Open a terminal with CTRL + ALT + T and insert the following commands successively: 
    sudo apt install docker.io
sudo groupadd docker
sudo usermod -aG docker $USER
reboot # this restarts your machine
docker pull tomsik68/xampp # start a new terminal

2.1.2 Install Docker and set up the container in Windows and MacOS

2.1.3 Manage the Docker container without Docker desktop (needed for Ubuntu)

You can either use Docker Desktop for managing your Docker container (start, stop, etc) if you use Windows/MacOS or you can use the official Microsoft Docker extension for VSCode (recommended) so you do not need to leave VSCode:

docker

2.2. Setup user, database and permission

If you used either the XAMPP installer or the Docker container to set up XAMPP you can now proceed to set up your database, its user and permissions:

  • navigate to http://localhost:80/phpmyadmin
  • click on "User accounts"
  • click on "Add user account"
  • insert a username and password
  • IMPORTANT: check "Create database with same name and grant all privileges." and "Grant all privileges on wildcard name (username_%)." and "Check all". The first option will generate a new database with the same name as your username.
  • don't change anything else
  • click "Go"

3. Server

Our server will

  1. Write and read from a database
  2. Digest requests from our client application, which we will create later on

For those two steps we need to use the source code of three different Java libraries. spring-boot-starter-data-jpa and mysql-connector-java provide the Java classes for the database communication and spring-boot-starter-data-rest for the client communication via HTTP calls. So we need to include those three external libraries as dependencies for our server application.

3.1. Preparation

Make sure you have Java, Maven, VSCode, the Java extension pack from Microsoft and the Spring Boot extension pack from Pivotal installed, as described here: software engineering 1 setup tutorial!!!

3.1.3. Create a new Spring Boot Maven project

We will create a special type of Java project called "Maven project". Maven is a program to manage the lifecycle of Java software development and there is much to learn about Maven, however we will only use it here to manage the dependencies (external Java libraries). We will use the Spring Boot Initializr to import all needed dependencies on the fly and create a predefined spring boot maven project.

Either press CTRL + SHIFT + P (MacOS: CMD + SHIFT + P) and type spring initializr: create a maven project... (auto complete will let you hit enter after some starting letters)

or create a Java project with the "+" Symbol in the Java Projects section in your sidebar

or if you have a fresh window opened use the "create java project" button

In either case now select "Spring Boot" and then "Maven Project" as your spring boot project type:

Use the most recent version, by April 2023 this should be 3.0.2:

Use "Java" as project language:

Type org.hsd.inflab as the group Id:

Use se2server as the artifactId:

Use Jar as the packaging type:

Use Java 17 as the Java version, unless you have Java 11 installed, then use 11:

Now you will be asked to select dependencies that will be included. Include the

  • MySQL driver
  • rest reposities
  • spring data jpa for sql
  • Then press Select 3 dependencies

You will be asked to save your application where you want. Afterwards a dialog will ask you to open the project - open it:

Here is a short video of all steps:

3.1.5. Prepare the spring boot server application

Now that we've defined which external libraries we need, we need to set up our spring boot server application.

Open the file application.properties inside the src/main/resources package and insert the following properties and change DATABASENAME, USERNAME and PASSWORD to the values you've entered in 2.2. The DATABASENAME is the equivalent to your USERNAME, given that you checked the mandatory box in step 2.2:

spring.jpa.hibernate.ddl-auto=create-drop
spring.datasource.url=jdbc:mysql://localhost:3306/DATABASENAME?serverTimezone=Europe/Berlin
spring.jpa.database-platform=org.hibernate.dialect.MySQL5Dialect
spring.datasource.username=USERNAME
spring.datasource.password=PASSWORD
spring.jackson.serialization.fail-on-empty-beans=false
spring.jpa.show-sql=true

To test our server we will have to execute it. Make sure the database is running from within your XAMPP Docker!!!

Open the Spring Boot panel on the left side and press the start button above your Spring Boot project se2server (even if this GIF shows the name se2rest):

3.2. Server implementation

Now that we've created the server skeleton, we will fill it up with packages and classes needed to manage the creation, deletion and updating of users.

3.2.1. Create package structure

Maven does not insist on many files to work but the package structure is very important!

Inside the meta package org.hsd.inflab.se2server with

create the following packages/folders:

  • entity
  • repository
  • restcontroller

3.2.2. Entities

VERY IMPORTANT: if you use a major spring version lower than 3, replace all occurrences of jakarta.persistence with javax.persistence in your import commands.

Now spring-boot-starter-data-jpa comes into play. With it a copy of hibernate is downloaded. Hibernate is an implementation of the Java Persistence API (JPA) and can process special types of classes named Entities. Each entity refers to one table inside our database and each attribute of this entity refers to a column inside this table. Hibernate is smart enough so it can even create tables just from looking onto our entity classes.

The Java Persistence API and thus hibernate work with annotations. When you want to declare a Java class as an entity, you simply put the @Entity tag above the class declaration. Now all attributes are already understood as individual columns when they are primitive data types such as for example int and String.

One attribute every entity/table needs is a primary key so each row can be identified. In most cases this is a number and just like in an Excel file, each row has a number as its first entry. To annotate an attribute as the primary key of a class we need to insert the @Id above. If our database should automatically generate a new primary key for each insert into the table, we need to include the @GeneratedValue annotation. If this attribute should have a unique value every time, we also need to use the @Column(unique = true) annotation. In our case, we need all three annotations.

Since every entity needs a primary key we can put this id attribute into an abstract class and let all other entities extend from this class. This may look weird in our case, since we only have one Entity, but if you would have 10 classes, you would already save 100 lines of code if you let them all extend from an abstract entity.

Create AbstractEntity.java and Person.java inside the entity package (depending on your package presentation it might be displayed with its full name org.hsd.inflab.se2server.entity)

3.2.2.1. AbstractEntity.java

package org.hsd.inflab.se2server.entity;

import java.io.Serializable;

import jakarta.persistence.Column;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import jakarta.persistence.MappedSuperclass;

@MappedSuperclass
public abstract class AbstractEntity implements Serializable {

    private static final long serialVersionUID = 1L;
    
    @Id
    @GeneratedValue
    @Column(unique = true)
    long id;

    public long getId() {
        return id;
    }

    public void setId(long id) {
        this.id = id;
    }
    
}

3.2.2.2 Person.java

package org.hsd.inflab.se2server.entity;

import jakarta.persistence.Entity;

@Entity
public class Person extends AbstractEntity {

    private static final long serialVersionUID = -3421268250084118586L;
    private String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Person() {
    }
    
}

3.2.3. Repositories

Spring Boot has the power to automatically generate code to access the database for us. One last step is needed to make this possible. We need to create one interface extending from JpaRepository for each entity we want to manage. In our project we also want to make the restcontrollers (later on) to be as generic as possible, thus we will also make our data repository interface generic. A JpaRepository could also include method signatures that are then implemented by the spring framework via reflection, in the pattern of findPersonByName(String name) but we won't do this here, so our repository interfaces do not include any method. This may look weird but all the magic is done by the spring framework in the background.

Create the interfaces (not classes) GenericRepository.java and PersonRepository.java inside the repository package. The person repository works as our data access object (DAO) you might know from other stacks. Depending on your future projects, it might make sense to move away from the generic approach here and just create one repository interface for each entity without using a GenericRepository.

3.2.3.1. GenericRepository.java

package org.hsd.inflab.se2server.repository;

import java.io.Serializable;
import org.hsd.inflab.se2server.entity.AbstractEntity;
import org.springframework.data.jpa.repository.JpaRepository;

public abstract interface GenericRepository<T extends AbstractEntity> extends JpaRepository<T, Serializable> { }

3.2.3.2. PersonRepository.java

package org.hsd.inflab.se2server.repository;

import org.hsd.inflab.se2server.entity.Person;

public interface PersonRepository extends GenericRepository<Person> { }

3.2.4. Restcontroller

The restcontroller(s) define(s) how the server answers to HTTP calls from clients. Each HTTP command (GET, POST, PUT, DELETE) is translated to a CRUD (create, read/receive, update, delete) operation to store the received JSON in the database as a table row, or to retrieve information the client(s) ask(s) for from the database and send it back inside the http body in JSON.

Because in theory we could have much more entities to be made accessible via a restcontroller we will first create a GenericRestcontroller.java that already includes all HTTP Call mappings. Only changing an already existing entity is a bit tricky to be made generic, since we can not say how much and what attributes all of our entities will have. So GenericRestcontroller.java includes the abstract method updateEntity() which needs to be implemented by each child class of GenericRestcontroller. In our case we only have PersonRestController.java so this might look like too much effort but if you imagine again you have more than one entity you probably do not want to write down the same mappings again and again.

Create GenericRestController.java and PersonRestController.java inside the restcontroller package.

3.2.4.1. GenericRestController.java

package org.hsd.inflab.se2server.restcontroller;

import java.util.List;
import org.hsd.inflab.se2server.entity.AbstractEntity;
import org.hsd.inflab.se2server.repository.GenericRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;

public abstract class GenericRestController<E extends AbstractEntity> {
    
    // We don't know which fields the entities have so
    // the concrete classes need to implement this method
    protected abstract E updateEntity(E e, E newE);
    
    @Autowired
    protected GenericRepository<E> repository;

	@GetMapping // HTTP GET
	public List<E> list() {
        return repository.findAll();
    }
    
	@PostMapping // HTTP POST
	public E create(@RequestBody E entity) {
        return repository.save(entity);
    }
    
	@DeleteMapping("{id}") // HTTP DELETE
	public void delete(@PathVariable(value = "id") long id) {
        repository.deleteById(id);
    }
    
	@GetMapping("{id}") // HTTP GET
	public E get(@PathVariable(value = "id") long id) {
        return repository.getReferenceById(id);
    }
    
    @PutMapping("{id}") // HTTP PUT
    public E update(@PathVariable long id, @RequestBody E newE) {

        return repository.findById(id).map(e -> {
            e = updateEntity(e, newE);

			return repository.save(e);

        }).orElseGet(() -> {
            newE.setId(id);
            return repository.save(newE);
        });        
    }
}

3.2.4.2. PersonRestController.java

package org.hsd.inflab.se2server.restcontroller;

import org.hsd.inflab.se2server.entity.Person;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
// the url suffix where the person resource
// is mapped to
@RequestMapping("/persons")
public class PersonRestController extends GenericRestController<Person> {

    // Our concrete entity person has only one field
    // So this might look a bit over engineered
    @Override
    protected Person updateEntity(Person e, Person newE) {
        e.setName(newE.getName());

        return e;
    }    
    
}

3.3. Testing the server

You could now test the server with any rest client. We use the extension Thunder Client from RANGA VADHINENI in VSCode:

4. Client

For our very simple application stack we already set up a MariaDB via XAMPP and created a Spring Boot server to communicate with both clients and the database. Now it is time to create this client in the form of a JavaFX graphical user interface (app).

4.1. Preparation

4.1.2. Create maven project with archetype

This time we create the Maven project without the Spring Boot initializr but with the archtetype javafx-archetype-fxml from org.openjfx. Expand the JAVA PROJECTS section in the left panel and click on the +-Symbol:

Click on Maven or use your keyboard (cursor down -> enter):

Select More...:

Type org.openjfx which filtes the results, select java-fx-archetype-fxml:

Select the most recent version - at the time this tutorial was made it was 0.0.6:

Enter org.hsd.inflab as your group id and press enter:

Enter se2fxclient as your artifact id:

Select any directory but DO NOT select your se2server directory!!!:

Just press enter for the property 'version':

Type in Y and press enter:

Click on Open which opens the client project in a new VSCode window, keep both VSCode windows opened:

Important: Check that your installed java version matches with the java version in the pom.xml of your client:

For example for Java 17

Client pom.xml
...
<properties>
	<maven.compiler.source>17</maven.compiler.source>
	<maven.compiler.target>17</maven.compiler.target>
</properties>
...

For the server:

...
<properties>
    <java.version>17</java.version>
</properties>
...

Also for the server, if you use java17 please check that the springframework parent version is greater or atleast equal to 2.6.5

4.1.3. Delete unwanted files

The archetype created the pom.xml, the outer package structure and module-info.java for us. But it also created some files which we do not need. Thus we need to delete them now, to prevent confusion.

Delete:

... in src/main/java/org/hsd/inflab/se2fxclient

  • App.java
  • PrimaryController.java
  • SecondaryController.java

... in src/main/resources/org/hsd/inflab/se2fxclient

  • primary.fxml
  • secondary.fxml

We will create similar files by hand in the next steps.

4.1.4. Customize pom.xml

Even though we've created the Maven project from the archetype, we still need to add two dependencies (external Java libraries) for creating a HTTPClient and JSONObjects into pom.xml. Inside <depedencies>...</dependencies> add the following lines (depending on the time you read this tutorial, you might need to adapt the version numbers...):

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>
<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20211205</version>
</dependency>

Information: we use the apache HttpClient, because it allows us to create a CloseableHttpClient, which is closed automatically in a try-with-resource statement. This is currently not possible with the HttpClient in the JDK, so we would need to close the HttpClient ourselves!

You might be asked if you want to synchronize your Java classpath/configuration - choose ALWAYS!

4.2 Implementation

!!! IMPORTANT !!!: Before you start with the implementation, make sure you have GLUON SCENE BUILDER VERSION 17 installed to manipulate FXML files from within a graphical user interface!

4.2.1. Create package structure

Our client code organisation and thus the package structure will follow the model-view-controller pattern: the model package will include the very simple Java classes that store the actual data, the view includes all classes that store the graphical user interface and the controller stores the program logic. On top of this we will also need service classes to communicate with the server.

Inside src/main/java/org/hsd/inflab create the folder se2fxclient:

Inside src/main/resources/org/hsd/inflab create the folder se2fxclient

Inside src/main/java/org/hsd/inflab/se2fxclient create the following folders successively

  • model
  • view
  • controller
  • service

So you end up with the following directory structure - IMPORTANT - please double check if you created the directory hierarchy correctly:

4.2.2. Create App class

App.java is the entry point of our JavaFX application.

Create the class App.java inside the view folder:

4.2.3. Finalize the app class

We only need to extend our App from javafx.application.Application and overwrite the start() method, where we load a new Scene build from a FXML file, to have a working JavaFX application.

Put the following code into App.java:

package org.hsd.inflab.se2fxclient.view;

import java.io.IOException;
import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.stage.Stage;

public class App extends Application {

    @Override
    public void start(Stage stage) throws IOException {
        FXMLLoader fxmlLoader = new FXMLLoader(App.class.getResource("PersonView.fxml"));
        Scene scene = new Scene(fxmlLoader.load());
        stage.setResizable(false);
        stage.setScene(scene);
        stage.show();
    }

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

4.2.4. Create the FXML file PersonView.fxml for the UI hierarchy

We've loaded PersonView.fxml inside the start() method of App.java but this file doesn't exist yet. It is a XML file story just the hierarchy of our UI. SceneBuilder is an additional program alongside our IDE (Eclipse, VSCode, ...) that simplifies and visualizes the creation of such FXML files.

Open SceneBuilder and create a new file, drag and drop the container BorderPane out of the left panel (section Containers) onto the drawing area and save the file afterwards into the directory where your se2fxclient project is on your computer into the package se2fxclient/src/main/resources/org/hsd/inflab/se2fxclient/view with the file name PersonView.fxml

newfxml

4.2.5. First App test

Before you can test your app you need to correct the file Module-info.java to this:

module org.hsd.inflab {
    requires javafx.controls;
    requires javafx.fxml;
    requires transitive javafx.graphics;

    opens org.hsd.inflab.se2fxclient.view to javafx.fxml;
    exports org.hsd.inflab.se2fxclient.view;
}

Switch back to your VSCode and start App.java by clicking on the little Run label above your main() method:

... and an empty white window should appear

testapp2

4.2.6. Model classes

As described it is a common practice in software development to detach the code containing the data from the code containing the user interface. In our case we only have one kind of object (Persons) with only one attribute (name) so the information about every person will be stored inside instances of a very simple class Person.java as every person should be available on each layer. Additionally to the name attribute we also need to identify every person. So when we allow persons to have the same names, which is quite common in real life, we need an additional attribute id. And since we do not want to copy-paste the same attribute and its setter- and getter-methods every time we add another class inside model we first create an AbstractModel.java class containing only the id attribute and its setter/getter methods.

Create the model classes AbstractModel.java and Person.java inside the model package.

4.2.6.1 AbstractModel.java

package org.hsd.inflab.se2fxclient.model;

public class AbstractModel {
    
    int id;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }
}

4.2.6.2. Person.java

package org.hsd.inflab.se2fxclient.model;

public class Person extends AbstractModel {

    String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Person() {
    }

    public Person(String name) {
        this.name = name;
    }    
}

4.2.7. Service classes

Before you create the service classes modify module-info.java once again to the following version:

module org.hsd.inflab {
    requires transitive javafx.controls;
    requires javafx.fxml;
    requires transitive javafx.graphics;
    requires org.apache.httpcomponents.httpcore;
    requires org.apache.httpcomponents.httpclient;
    requires commons.logging;
    requires org.json;

    opens org.hsd.inflab.se2fxclient.view to javafx.fxml;
    opens org.hsd.inflab.se2fxclient.controller to javafx.fxml;
    
    exports org.hsd.inflab.se2fxclient.view;
    exports org.hsd.inflab.se2fxclient.model;
}

4.2.7.1. GenericRestService.java

The core of the client is the rest service. It contains methods representing the CRUD operations on the server side. create() read() update() and delete() use a HTTPClient to create HTTP calls. They either create JSON Objects from model objects and send them via HTTP, or receive JSON objects from HTTP and return person model objects created from the JSON objects.

To detach most of the code from the actual model object we want to receive, we will first put most of the code inside GenericRestService.java. Only the specifics like the resource url and how to convert JSON to model and vice versa will be put into PersonRestService.java which extends GenericRestService.java. To reduce the amount of HTTPClient objects that are created, we will also use the singleton pattern for the PersonRestController.java.

Since this class is a little bit bigger than previous ones, explanations can be found inside the source code as comments. So, create GenericRestService.java inside the service package of your client with the following content:

package org.hsd.inflab.se2fxclient.service;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.ArrayList;
import java.util.List;
import java.util.Properties;
import org.apache.http.HttpHeaders;
import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.client.methods.HttpDelete;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.hsd.inflab.se2fxclient.model.AbstractModel;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

public abstract class GenericRestService<M extends AbstractModel> {
    
    // The base url should be the same for all rest endpoints
    // so we can make this attribute static
    private static String baseUrl;
    // The resource url suffix however can't
    private String url;
    // Child classes need to implement their own resource name
    protected abstract String getResourceName();
    // We do not know how many attributes the child classes have
    // So both directions of conversion need to be abstract
    protected abstract JSONObject createJSONObjectFromModelObject(M m);
    protected abstract M createModelObjectFromJSONObject(JSONObject jsonObject);
    
    // The URL will then be taped together from the baseURL
    // Plus the resource url in the child class
    protected void createURL() {
        loadProperties();
        url = new String(baseUrl + "/" + getResourceName());
    }

    public GenericRestService() {
        createURL();
    }

    // First of all we will send a simple HTTP get to the baseurl
    // To test if the connection is working
    public boolean connectionIsWorking() {
        try (CloseableHttpClient client = HttpClientBuilder.create().build()) {
            HttpGet request = new HttpGet(baseUrl);
            HttpResponse response = client.execute(request);
            return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK;
        } catch (IOException e) {
            e.printStackTrace();
            return false;
        }        
    }

    // It is a good practice to load static data from .properties files
    // In this case this is only done for the base.url
    public static void loadProperties() {
        Properties properties = new Properties();
        try {
            properties.load(GenericRestService.class.getResourceAsStream("connections.properties"));
        } catch (IOException e) {
            e.printStackTrace();
        }
        baseUrl = properties.getProperty("base.url");
    }

    // When we want to create a model object
    // We will send a HTTP post call to the server
    // Including a JSON file in the message body (also called entity)
    // Which only includes all properties of the child class
    public M create(M m) {
        // As described we can not know how many properties the model has
        // so we call the abstract method to create the JSON Obhect for us
        JSONObject jsonObject = createJSONObjectFromModelObject(m);
        // The HTTP Post request is created with the url
        HttpPost request = new HttpPost(url);
        // And the content type is set        
        request.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");

        HttpResponse response;

        // Now we use the the httpclient from the apache library
        // Which automatically closes the connection after use
        try (CloseableHttpClient client = HttpClientBuilder.create().build()) {
            request.setEntity(new StringEntity(jsonObject.toString()));
            // The reponse is stored after request execution
            response = client.execute(request);
            // And the response body (entity) is pumped into stringbuilder
            BufferedReader bufferedReader = new BufferedReader(
                    new InputStreamReader(response.getEntity().getContent()));
            StringBuilder stringBuilder = new StringBuilder();
            String line = "";
            while ((line = bufferedReader.readLine()) != null) {
                stringBuilder.append(line);
                System.out.println(line);
            }
            // The string containing the JSON can then be stored
            // inside a JSONObject from the maven dependency we've included
            JSONObject json = new JSONObject(stringBuilder.toString());
            m.setId(json.getInt("id"));
        } catch (IOException e) {
            e.printStackTrace();
        }
        return m;
    }

    // We call this method to get an array of model object classes
    // For this a HTTP GET request is send to the server
    // And the response is stored inside JSONArray
    public List<M> readAll() {
        HttpGet request = new HttpGet(url);
        HttpResponse response;
        List<M> list = new ArrayList<>();
        try (CloseableHttpClient client = HttpClientBuilder.create().build()) {
            response = client.execute(request);
            BufferedReader bufferedReader = new BufferedReader(
                    new InputStreamReader(response.getEntity().getContent()));
            StringBuilder stringBuilder = new StringBuilder();
            String line = "";
            while ((line = bufferedReader.readLine()) != null) {
                stringBuilder.append(line);
            }
            JSONArray jsonArray = new JSONArray(stringBuilder.toString());
            for (JSONObject jsonObject : getJSONObjectListFromJSONArray(jsonArray)) {
                list.add(createModelObjectFromJSONObject(jsonObject));
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return list;
    }

    // We send a HTTP PUT call to the server in this method
    // when we want to update an existing entity on the server
    public void update(M m) {
        JSONObject jsonObject = createJSONObjectFromModelObject(m);
        HttpPut request = new HttpPut(url + "/" + m.getId());
        request.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");
        try (CloseableHttpClient client = HttpClientBuilder.create().build()) {
            request.setEntity(new StringEntity(jsonObject.toString()));
            client.execute(request);
            System.out.println(jsonObject.toString());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // To delete an entity on the server, we send a HTTP DELETE call
    // to the baseurl, followed by the resource URL and the objects id
    public void delete(M m) {
        HttpDelete request = new HttpDelete(url + "/" + m.getId());
        request.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");
        try (CloseableHttpClient client = HttpClientBuilder.create().build()) {
            client.execute(request);
            System.out.println("Deleted Entity with id: " + m.getId());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // This helper method gives us a List of JSONObjects
    // When we feed it with an JSONArray
    public List<JSONObject> getJSONObjectListFromJSONArray(JSONArray array) throws JSONException {
        ArrayList<JSONObject> jsonObjects = new ArrayList<>();
        for (int i = 0; i < (array != null ? array.length() : 0); jsonObjects.add(array.getJSONObject(i++)))
            ;
        return jsonObjects;
    }
}

4.2.7.2. PersonRestService.java

Since the GenericRestService already included all HTTP Calls, we only need to implement the abstract methods to convert JSON to Person and Person to JSON in PersonRestService.java.

To be very sure that only one instance of each RestService exists in the memory of our computers, we will use the thread safe singleton pattern here. For this the constructor is set to private and a synchronized static getInstance() method can be called outside of this class. This method creates one new instance of itself on call if no instance exists, otherwise it returns a reference of the one already existing instance.

Create PersonRestService.java inside the service package of your client with the following content:

package org.hsd.inflab.se2fxclient.service;

import org.hsd.inflab.se2fxclient.model.Person;
import org.json.JSONObject;

public class PersonRestService extends GenericRestService<Person> {

    // Thread safe singleton pattern
    private static GenericRestService<Person> instance;

    public static synchronized GenericRestService<Person> getInstance() {
        if (instance == null) {
            instance = new PersonRestService();
        }
        return instance;
    }
    
    private PersonRestService() {
        super();
    }

    @Override
    protected String getResourceName() {
        return "persons";
    }

    @Override
    protected JSONObject createJSONObjectFromModelObject(Person m) {
        JSONObject jsonPerson = new JSONObject();
        jsonPerson.put("name", m.getName());
        return jsonPerson;
    }

    @Override
    protected Person createModelObjectFromJSONObject(JSONObject jsonObject) {
        Person person = new Person(jsonObject.getString("name"));
        person.setId(jsonObject.getInt("id"));
        return person;
    }
}

4.2.8. Person view class

The UI representation of a person will be put into FxPerson.java which will be created by the PersonController.java above and holds a reference to the PersonService.

The name TextField contains the value of the name, the OK button calls the update and the delete button the delete methods of the PersonRestService.

As a bit of stylistic sugar, we make all UI elements a little bit rounder at the edges within the applyStyling() method :) Create FxPerson.java inside your view package of your client with the following content:

package org.hsd.inflab.se2fxclient.view;

import org.hsd.inflab.se2fxclient.model.Person;
import org.hsd.inflab.se2fxclient.service.GenericRestService;
import org.hsd.inflab.se2fxclient.service.PersonRestService;
import javafx.scene.control.Button;
import javafx.scene.control.TextField;
import javafx.scene.layout.HBox;
import javafx.scene.layout.VBox;

public class FxPerson extends HBox {

    private TextField name;
    private Button delete, OK;
    private Person person;
    private GenericRestService<Person> personService;

    public FxPerson(Person person, VBox parentVBox) {
        this.person = person;
        personService = PersonRestService.getInstance();
        name = new TextField(this.person.getName());
        delete = new Button("delete");
        delete.setOnAction(e -> {
            personService.delete(person);
            parentVBox.getChildren().removeAll(this);
        });
        OK = new Button("OK");
        OK.setOnAction(e -> {
            person.setName(name.textProperty().getValue());
            personService.update(this.person);
        });
        getChildren().addAll(name, OK, delete);
        applyStyling();
    }

    public TextField getName() {
        return this.name;
    }

    private void applyStyling() {
        name.setStyle("-fx-border-radius: 10 0 0 10");
        name.setStyle("-fx-background-radius: 10 0 0 10");
        name.setMinWidth(300);
        name.setMaxWidth(300);
        delete.setStyle("-fx-border-radius: 0 10 10 0");
        delete.setStyle("-fx-background-radius: 0 10 10 0");
        delete.setMinWidth(100);
        delete.setMaxWidth(100);
        OK.setMinWidth(50);
        OK.setMaxWidth(50);
        OK.setStyle("-fx-border-radius: 0");
        OK.setStyle("-fx-background-radius: 0");
    }
}

4.2.9. The controller class

The controller class includes the FXML method initialize() which is called when the UI is created. Here we set the reference to a new PersonRestService instance. We check if the connection is working - if so we create FxPerson objects for each person in the database.

Create PersonController.java inside the controller package of your client with the following content:

package org.hsd.inflab.se2fxclient.controller;

import org.hsd.inflab.se2fxclient.model.Person;
import org.hsd.inflab.se2fxclient.service.GenericRestService;
import org.hsd.inflab.se2fxclient.service.PersonRestService;
import org.hsd.inflab.se2fxclient.view.FxPerson;
import javafx.fxml.FXML;
import javafx.scene.control.Alert;
import javafx.scene.control.Alert.AlertType;
import javafx.scene.layout.VBox;

public class PersonController {

    GenericRestService<Person> personRestService;

    @FXML
    VBox personsVBox;

    @FXML
    private void initialize() {
        personRestService = PersonRestService.getInstance();
        if (personRestService.connectionIsWorking()) {
            for (Person person : personRestService.readAll()) {
                personsVBox.getChildren().add(new FxPerson(person, personsVBox));
            }
        } else {
            new Alert(AlertType.ERROR, "Could not connect to server!").showAndWait();
            System.exit(1);
        }
    }

    public void addNewPerson() {
        Person person = personRestService.create(new Person(""));
        if (person != null) {
            FxPerson fxPerson = new FxPerson(person, personsVBox);
            personsVBox.getChildren().add(fxPerson);
            fxPerson.getName().requestFocus();
        } else {
            new Alert(AlertType.ERROR, "Could not create Person!").showAndWait();
        }
    }
}

4.2.10. Service properties

Create the file connections.properties inside the service package in src/main/resources and insert

base.url=http://localhost:8080

4.2.11. Set controller in FXML view

Now that all Java code is done, we return to our FXML file to connect the view to the controller and to create the hierarchy of our UI.

Open PersonView.fxml inside SceneBuilder and set org.hsd.inflab.se2fxclient.controller.PersonController as the Controller class

setcontrollerinview

4.2.12. Fill up the view

From within the Containers in the left panel drag and drop a ButtonBar into the bottom of the BorderPane

insertbuttonbar

Click on the button and rename it to New

renamebutton

Select the button and insert addNewPerson into the On Action text field in the Code section of the right panel to connect the button to method in the controller

connectbuttontomethod

Drag and drop an AnchorPane out of the Containers section in the left panel into the center of the BorderPane

insertanchorpane

Drag and drop a VBox out of the Containers section in the left panel into the AnchorPane and set the design as you like

insertvbox

Select the VBox and set personsVBox as the fx:id in the Code section of the right panel to connect the variable in your controller class to the FXML

insertvboxid

If you think this looks better you can add padding left and right to the AnchorPane

insertpadding

4.2.13. DO NOT FORGET: Final module-info.java version

Finally correct module-info.java to the following, to correctly export and import the packages and modules, otherwise you will not get rid of the many missing imports in various classes:

module org.hsd.inflab.se2fxclient {
    requires transitive javafx.controls;
    requires javafx.fxml;
    requires transitive javafx.graphics;
    requires org.apache.httpcomponents.httpcore;
    requires org.apache.httpcomponents.httpclient;
    requires commons.logging;
    requires org.json;

    opens org.hsd.inflab.se2fxclient.view to javafx.fxml;
    opens org.hsd.inflab.se2fxclient.controller to javafx.fxml;
    exports org.hsd.inflab.se2fxclient.controller;
    exports org.hsd.inflab.se2fxclient.view;
    exports org.hsd.inflab.se2fxclient.model;
}

5. Full stack test

  • Start the mysql database from within the XAMPP control panel or the Docker container
  • Start the server class Application.java
  • Start the JavaFx client App.java
  • Create a Person
  • Rename it and click OK to submit
  • Delete a person with the Delete button
  • Check the database if all changes are correctly committed

finaltest

About

This repository includes a tutorial for the module "Software Engineering 2" by Professor Wolfgang Lux @ University Of Applied Sciences Düsseldorf.

ei.hs-duesseldorf.de/personen/lux

Topics

java spring-boot jpa javafx xampp restful-webservices

Resources

Readme
Activity
Custom properties

Stars

4 stars

Watchers

3 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •