/SocketServerFX

JavaFX UI application representing the server side of a socket connection

Primary LanguageJavaBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

SocketServerFX

JavaFX UI application representing the server side of a socket connection

This application is written in Java using the JavaFX API. It represents the server side of a socket connection and can:

  • connect to a socket at a configurable port
  • attempt to connect one time, or continually attempt to connect
  • send and receive text messages from a connected socket
  • retrieve sent and received messages

It is typically used in conjunction with a client-side JavaFX UI application called SocketClientFX. It can be found here: https://github.com/jtconnors/SocketClientFX

This version of the source code is tagged 1.0-JDK14-maven. As its name suggests, it is specific to JDK 14 and can be built with the apache maven build lifecycle system. It uses the jdk.incubator.jpackage module autilities whose API has not been finalized and is subject to change. As such, the scripts contained in this project will insist that JDK 14 be used because subsequent jpackage releases may be incompatible.

Requirements:

  1. Your default JDK should point to a valid JDK 14 runtime in your PATH.
  2. Prior to running any of the scripts in this project, either the JAVA_HOME or $env:JAVA_HOME (depending upon the platform in question) environment variable must be set to a valid JDK 14 runtime.
  3. In order to generate EXE or MSI installers for Windows using the scripts in this project, the WiX toolkit version 3.0 or greater must be installed and placed on the PATH.

Of note, the following maven goals can be executed:

  • mvn clean
  • mvn dependency:copy-dependencies - to pull down dependent javafx and com.jtconnors.socket modules
  • mvn compile - to build the application
  • mvn package - to create the SocketServerFX module as a jar file
  • mvn exec:java to run the application

Furthermore, additional .sh and .ps1 files are provided in the sh/ and ps1\ directories respectively:

  • sh/run.sh or ps1\run.ps1 - script file to run the application from the module path
  • sh/run-simplified.sh or ps1\run-simplified.ps1 - alternative script file to run the application, determines main class from SocketClientFX module
  • sh/link.sh or ps1\link.ps1 - creates a runtime image using the jlink utility
  • sh/create-appimage.sh or ps1\create-appimage.ps1 - creates a native package image of application using JEP-343 jpackage tool
  • sh/create-dmg-installer.sh - creates a native MacOS dmg installer of this application using JEP-343 jpackage tool
  • ps1\create-exe-installer.ps1 - creates a native Windows EXE installer of this application using JEP-343 jpackage tool
  • ps1\create-msi-installer.ps1 - creates a native Windows MSI installer of this application using JEP-343 jpackage tool

Notes:

  • These scripts have a few available command-line options. To print out the options, add -? or --help as an argument to any script.
  • These scripts share common properties that can be found in env.sh or env.ps1. These may need to be slightly modified to match your specific configuration.
  • A sample Microsoft.PowerShell_profile.ps1 file has been included to help configure a default Powershell execution environment. A similar file can be generated specific to environments appropriate for running the bash(1) shell with a .bash_login or .bash_profile file.

See also: