Distribution

This article is about the distributions of the library. The distributions are:

• The zip files containing the source files for the project
• The zip file containing the test files for the project
• The zip file containing the binary files for the project

Source files

There are two distributions for the source files:

• A source distribution which is only under the LGPL 2.1 license
• A source distribution which is on both the LGPL 2.1 and APACHE 2.0 licenses

LGPL 2.1 distribution

The MDIUtilities_LGPL-src-<version>.zip contains all the source files for the project.

LGPL 2.1 + APACHE 2.0 distribution

The MDIUtilities_LGPL-src-<version>.zip contains the source files for the project which are compatible for both the LGPL 2.1 and the APACHE 2.0 licenses.

Binary files

There is only one distribution for the binary files.

The binary files are only provided under the LGPL license because this library can be used without any license problem in any project, even a project with a proprietary license. The zip file is the MDIUtilities_LGPL-bin-<version>.zip file. The file contain the following jar files:

• MDIUtilitiesLGPL.jar: jar file containing all the classes of the library, usable on Swing and JavaFX. There are Swing and JavaFX dependencies for this library
• MDIUtilities-core-LGPL.jar: jar file containing the non UI classes of the library. There are no Swing nor JavaFX dependencies for this library
• MDIUtilities-ui-LGPL.jar: jar file containing only the classes of the library usable on Swing. There are no JavaFX dependencies for this library
• MDIUtilities-jfx.jar: jar file containing only the classes of the library usable on JavaFX. There are no Swing dependencies for this library
• AppLauncher.jar: jar file containing the AppLauncher class and all its dependencies
• MDIUtilities-junit.jar: jar file containing the JUnit helper classes

Test files

The test files are only provided under the LGPL license. The zip file is the MDIUtilities_LGPL-tests-<version>.zip file.

Usage

If you want to use the library, the most simple jar to add in the classpath is MDIUtilitiesLGPL.jar. However:

• If you want to use only non UI classes, you can only add the MDIUtilities-core-LGPL.jar jar to the classpath
• If you want to use only Swing-related classes, classes, you must add both the MDIUtilities-core-LGPL.jar jar and the MDIUtilities-ui-LGPL.jar jar to the classpath
• If you want to use only javaFX-related classes, classes, you must add both the MDIUtilities-core-LGPL.jar jar and the MDIUtilities-jfx-LGPL.jar jar to the classpath

Java 9 integration

All the jar files are Java 9 automatic modules. Java 9 does not allow modules to share packages, so each package must me exclusive to one module only.

So some Swing classes which were in the same package as core classes were put in specific swing packages to allow to use the MDIUtilities-core-LGPL.jar library with the MDIUtilities-ui-LGPL.jar library starting with Java 9^[1]

Prior to that change it was not possible to use both MDIUtilities-core-LGPL.jar and MDIUtilities-ui-LGPL.jar in the same Java 9 project

.

See ModuleFinder.of(Path...) for more information.

The name of the modules are:

• MDIUtilities.jar and MDIUtilitiesLGPL.jar: org.mdiutil.all
• MDIUtilities-core-LGPL.jar: org.mdiutil.core
• MDIUtilities-ui-LGPL.jar: org.mdiutil.ui
• MDIUtilities-jfx.jar: org.mdiutil.jfx
• MDIUtilities-junit.jar: org.mdiutil.junit