/jdk9-jigsaw

Examples of some of the features of jigsaw in jdk9 (Early Access builds)

Primary LanguageShellCreative Commons Zero v1.0 UniversalCC0-1.0

jdk9-jigsaw

Examples of some of the features of Jigsaw released in the Early Access build of JDK9.

Many of the examples here are directly from the Project Jigsaw: Module System Quick-Start Guide, see http://openjdk.java.net/projects/jigsaw/quick-start but we have also contributions from the Java community.

Setup (all platforms)

Download and install latest version of the JDK 9 EA

  • Download JDK 9 EA Early Access build of Jigsaw JDK9 is available at http://jdk.java.net/jigsaw/. Alternative site to download JDK 9 EA binaries from http://bit.ly/2oyOAnf (build 166).

  • Install JDK 9 EA

    • Install using a script

      Linux and MacOSX users only: the bash script getJigsawJDK.sh in the root directory of this repo, helps download the latest Jigsaw JDK from Oracle. Please run this once the repo is cloned.

      Windows users: please feel free to run this script and if there are any tweaks to get it to work successfully, please let us know via a pull request.

    • Install manually

      • Linux

        • tar -xvf jigsaw-jdk-9*.tar

        • mv -f jdk-9 [destination] (might need to use sudo here)

        • update your .bashrc with export JAVA_HOME=[jdk destination]

        • update your .bashrc with export PATH=$JAVA_HOME/bin:$PATH

        • source ~/.bashrc

          [destination] usually /usr/lib/... or related folder

      • MacOSX

        • Please refer to this guide - thanks Nolita (@musinoli) for your help
        • In case a .dmg file is available, download it and follow the installation steps, you will still have to update your JAVA_HOME and start script as mentioned in this guide.
        • update your .bashrc with export PATH=$JAVA_HOME/bin:$PATH

      • Windows

        • Run the executable file.
        • Follow the installation steps
        • Make a note of the destination
        • Edit the JAVA_HOME and PATH environment variables via the My Computer > Properties option

          • JAVA_HOME: JAVA_HOME=[jdk destination]

          • PATH: PATH=%JAVA_HOME%/bin;%PATH%

            [destination] usually C:\Program Files\Java\... or related folder

Verify JDK installation

Say you have downloaded and installed the JDK 9 EA (build 165) binary from the above step, try the below commands:

    $ java -version

As output you should get something like this:

    java version "9-ea"
    Java(TM) SE Runtime Environment (build 9-ea+165)
    Java HotSpot(TM) 64-Bit Server VM (build 9-ea+165, mixed mode)

And

    $ javac -version

As output you should get something like this:

    javac 9-ea

Download and install git or git-bash

  • Ensure you have a git client installed on your local machine/VM/vagrant box, for Windows users git-bash is recommended

Download and install the tree and wget command

Please install the tree command before moving forward:

  • Linux

    sudo apt-get install tree
sudo apt-get install wget

  • MacOSX

    install tree - http://apple.stackexchange.com/questions/128876/whats-the-equivalent-of-the-unix-tree-command-on-osx
install wget - http://stackoverflow.com/questions/4572153/os-x-equivalent-of-linuxs-wget

  • Windows

    install `git-bash` (recommended) or `cgywin`

    The tree command is built into Windows. From within git-bash or cygwin. In case a script is invoking the tree command and failing, please replace the tree -fl keywords with cmd //c "tree /f /a". If that does not work either use ls -R instead, except you won't see the output in a tree format.

    Or manually convert the .sh files into .bat, with minor tweaks should also work there.

    Thanks Richard Kolb (@rjdkolb) for your continued support in this area.

Vagrant box

(Optional) Install JDK 9 compliant IDE

  • Install the latest IDE (IntelliJ, Eclipse, NetBeans - paid or community version) that supports JDK 9 EA, once installed configure the IDE to pickup the JDK 9 EA installed in the previous steps.

Other preparations

  • Get familiar with the command-line a bit as we will be using much of it during the weekend

  • Prepare your VMs or cloud instances with the above, in case your local machine is not up for any installation or configurations

Note: the bash files provided should work on Linux and in theory on the MacOS as well.

For Windows users, if you use git-bash (recommended) or cgywin they should work for you.

In the worst case scenario, we would have to manually convert the .sh files into .bat, with minor tweaks should also work there. Happy to received a pull request for it.

Examples covered

Each example is enclosed in a folder of its own containing bash scripts to compile, package and run the respective examples. Use these scripts for each of the examples.

Must reads

Other resources