Hello World in Java (Linux)
https://lift.cs.princeton.edu/java/linux/
This document instructs you on how to set up a Java programming environment for your Linux computer. It also provides a step-by-step guide for creating and compiling a Java program in IntelliJ and executing it from the command line.
You will need a 64-bit version of Linux.
Warning:
Beta version of instructions. Please send bug reports to wayne@princeton.edu.
Todo: replace Mac OS X screenshots with Linux screenshots.
1. Install Java |
You will use Java SE Development Kit 11 (JDK 11).
Note
Skip this step if you already have JDK 11 installed.
- Log in to the user account in which you will be programming. Your account must have Administrator privileges and you must be connected to the Internet.
- Launch your shell. We’ll assume that the command prompt looks like the following (though your command prompt will likely differ):
The symbol<span style="color:#ffffff"><span style="color:#75cfff">~></span></span>
~
is shorthand for your home directory. - Install the Java SE Development Kit 11, either from OpenJDK or Oracle. Many Linux distributions (such as Ubuntu 18.04 or 20.04) include OpenJDK 11 by default, so you can skip this step. Otherwise, use your Linux distribution’s package manager (see the first FAQ) to install OpenJDK 11. For example, here are the commands for Ubuntu 16.04:
<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">sudo add-apt-repository ppa:openjdk-r/ppa</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">sudo apt-get update</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">sudo apt-get install openjdk-11-jdk</span> </span>
- To confirm that Java 11 is installed, type the following commands:
It’s important that the Java version numbers match and that you see the number<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">javac -version</span> javac 11.0.7 <span style="color:#75cfff">~></span> <span style="color:#ffffa8">java -version</span> openjdk version "11.0.7" 2020-04-14 OpenJDK Runtime Environment (build 11.0.7+10-Ubuntu) OpenJDK 64-Bit Server VM (build 11.0.7+10-Ubuntu, mixed mode, sharing) </span>
11
, but the rest is not critical.
2. Install Command-Line Tools |
Next, you will install our textbook libraries, SpotBugs, PMD, and Checkstyle to /usr/local/lift
and associated wrapper scripts to /usr/local/bin
.
- Type the following commands:
The command<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">cd /usr/local</span> <span style="color:#75cfff">/usr/local/></span> <span style="color:#ffffa8">sudo curl -O "https://lift.cs.princeton.edu/java/linux/lift-cli.zip"</span> <span style="color:#75cfff">/usr/local/></span> <span style="color:#ffffa8">sudo unzip lift-cli.zip</span> <span style="color:#75cfff">/usr/local/></span> <span style="color:#ffffa8">sudo rm lift-cli.zip</span> </span>
curl
downloads files from the web. - To confirm that the command-line tools are installed, type the following command:
You should hear an A-scale.<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">java-introcs StdAudio</span> </span>
You should not need to update any shell configuration files (such as .bashrc
) or set any environment variables (such as JAVA_HOME
or CLASSPATH
). For reference, here are our recommended shell configuation files for Bash:
3. Install IntelliJ |
Now, you will install IntelliJ.
- Download and install IntelliJ IDEA, Community Edition 2020.1 for Linux. Use all of the default options.
- Download our IntelliJ preferences to your home directory.
<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">cd</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">rm -rf .cache/JetBrains/IdeaIC2020.1</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">rm -rf .config/JetBrains/IdeaIC2020.1</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">rm -rf .local/share/JetBrains/IdeaIC2020.1</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">curl -O "https://lift.cs.princeton.edu/java/linux/IdeaIC2020.1.zip"</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">unzip IdeaIC2020.1.zip</span> <span style="color:#75cfff">~></span> <span style="color:#ffffa8">rm IdeaIC2020.1.zip</span> </span>
Warning
This will overwrite any previous IntelliJ 2020.1 settings with our novice-friendly settings.
4. Open a Project in IntelliJ |
You will develop your Java programs in an application called IntelliJ IDEA, Community Edition.
IntelliJ organizes Java programs into projects. In our context, each project corresponds to one programming assignment. A typical project contains Java programs, associated data files, and course-specific settings (such as compiler options, style rules, and textbook libraries).
- Download the project for your programming assignment to a convenient location (such as the Desktop).
[ sample project for COS 126 (Princeton) ]
[ sample project for COS 226 (Princeton) ]
[ sample project for Computer Science: Programming with a Purpose (Coursera) ]
[ sample project for Algorithms, Part I (Coursera) ]
Unzip the zip file using the following command:
This creates a project folder with the name of the corresponding programming assignment (such as<span style="color:#ffffff"><span style="color:#75cfff">~></span> <span style="color:#ffffa8">unzip -d hello hello.zip</span> </span>
hello
orpercolation
). Delete the zip file.Warning
The project folders contain course-specific information. Be sure to download the one corresponding to your institution and course.
- Launch IntelliJ.
- When you launch IntelliJ for the first time,
- IntelliJ may display the JetBrains privacy policy. Scroll down and Accept.
- IntelliJ may ask if you want to send anonymous usage statistics to JetBrains. Choose your preferred option.
- IntelliJ may display the JetBrains privacy policy. Scroll down and Accept.
- To open a project from the Welcome screen, click Open and select the project folder.
When you launch IntelliJ for the first time, it may take a minute or two to index your files; some features (such as auto importing) will be unavailable until this process completes.Warning
Do not select Create New Project; this option is intended for advanced programmers. Also, always use Open with a project folder, not an individual file. - You will need to manually configure the Platform SDK. To do so,
- Navigate to File → Project Structure → Platform Settings → SDKs.
- Click the + symbol (top left) to add an SDK.
- Locate an SDK. A typical location for a Java SDK on Linux is
/usr/lib/jvm/java-11-openjdk-amd64/
. - Use the shorthand name suggested by IntelliJ (e.g., 11 for version 11.0.7).
- Navigate to File → Project Structure → Platform Settings → SDKs.
- When you are finished working, select the menu option File → Exit to exit IntelliJ. The next time you launch IntelliJ, your recent projects will appear in the Welcome screen for easy access.
5. Create a Program in IntelliJ |
Now you are ready to write your first Java program. IntelliJ features many specialized programming tools including line numbering, syntax highlighting, bracket matching, auto indenting, auto formatting, auto importing, variable renaming, and continuous code inspection.
- To create a new Java program:
- Re-open IntelliJ and the project (if you closed it in the previous step).
- Click the project name in the Project View sidebar (at left), so that it becomes highlighted.
- Select the menu option LIFT → New Java Class. When prompted, type HelloWorld for the Name and click OK.
- Re-open IntelliJ and the project (if you closed it in the previous step).
- In the main editor window, complete the Java program
HelloWorld.java
exactly as it appears below. (IntelliJ generates the gray boilerplate code automatically, along with the course header block comment.)public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World"); } }
- As you type, IntelliJ highlights different syntactic elements in different colors. When you type a left bracket, IntelliJ adds the matching right bracket. When you begin a new line, IntelliJ indents it.
- To save the file, select the menu option File → Save All (Ctrl + S). When you save the file, IntelliJ re-formats it (if necessary).
6. Compile and Execute the Program (from IntelliJ) |
Now, it is time to execute (or run) your program. This is the exciting part, where your computer follows the instructions specified by your program. Before doing so, you must compile your program into a form more amenable for execution on a computer.
- Select the program that you wish to compile and execute in the the Project View sidebar. The program should now appear in the main editor window.
- To compile your program, select the menu option LIFT → Recompile 'HelloWorld.java' (Ctrl + B). If the compilation succeeds, you will receive confirmation in the status bar (at bottom).
If the compilation fails, a Recompile panel will open up (at bottom), highlighting the compile-time errors or warnings. Check your program carefully for typos, using the error messages as a guide.
- To execute your program, select the menu option LIFT → Run 'HelloWorld' with Arguments (Ctrl + E). Since this program takes no command-line arguments, click OK.
You should see the output of the program (in white), along with a message that the program finished normally (with exit code 0).
Tip
Use the LIFT menu to compile and execute your program from IntelliJ. The Build and Run menus support additional options for advanced programmers.
Also be sure that the main editor window is active before using the LIFT menu (e.g., by clicking the code you want to compile or execute).
7. Compile and Execute the Program (from the command line) |
The command line is a simple and powerful mechanism for controlling your programs (e.g., command-line arguments, file redirection, and piping). IntelliJ supplies an embedded terminal for easy access to the command line.
- Select the menu option View → Tool Windows → Terminal (Alt + 2).
- This will launch a Bash terminal where you type commands. You will see a command prompt that looks something like this:
The<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> </span>
~/hello
is the current working directory, where~
is shorthand for your home directory. - To compile your program, type the following
javac
command. More specifically, type the text in yellow that appears on the same line as the command prompt.
Assuming that the file<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">javac HelloWorld.java</span> <span style="color:#75cfff">~/hello></span></span>
HelloWorld.java
is in the current working directory, you should not see any compile-time errors or warnings. - To execute your program, type the following
java
command:
You should see the output of your program beneath the line on which you typed the command.<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">java HelloWorld</span> Hello, World </span>
Tip
Typically, you should compile from IntelliJ (because IntelliJ highlights the lines on which any compile-time errors or warnings occur) and execute from the command line (because the command line makes it is easy to specify command-line arguments and use file redirection).
8. Textbook Libraries (from the command line) |
To make our textbook libraries accessible to Java from the command line, you will use our wrapper scripts.
- Computer Science: An Interdisciplinary Approach (including COS 126 students). The program Barnsley.java uses our standard drawing and standard random libraries in
stdlib.jar
to draw a Barnsley fern. First download Barnsley.java. Then, use your system’s file manager (such as Nautilus) to move it to a project folder (such ashello
). Finally, to compile and execute it, type the following commands in the terminal:
When you execute the program, a standard drawing window will appear and an image like this one will be generated, one point at a time:<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">ls</span> Barnsley.java COS 126.iml WELCOME.txt logo.png <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">javac-introcs Barnsley.java</span> <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">java-introcs Barnsley 10000</span> </span>
To get your command prompt back, close the standard drawing window.
- Algorithms, 4th Edition (including COS 226 and Coursera students). The program CollidingDisks.java uses various libraries in
algs4.jar
to simulate the motion of n disks subject to the laws of elastic collision. First download CollidingDisks.java Then, use your system’s file manager (such as Nautilus) to move it to a project folder (such aspercolation
). Finally, to compile and execute it, type the following commands in the terminal:
When you execute the program, a standard drawing window will appear with an animation of 20 colliding disks. To get your command prompt back, close the standard drawing window.<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">ls</span> CollidingDisks.java COS 226.iml WELCOME.txt logo.png <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">javac-algs4 CollidingDisks.java</span> <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">java-algs4 CollidingDisks 20</span> </span>
Frequently Asked Questions Licensing FAQLinux FAQJava FAQIntelliJ FAQCommand-Line / Embedded Terminal FAQAll of the included software is licensed under various open-source licenses.- IntelliJ IDEA, Community Edition is licensed under the Apache License, Version 2.0.
- OpenJDK 11 is licensed under the GNU General Public License, version 2, with the Classpath Exception.
- SpotBugs is licensed under the GNU Lesser Public License, Version 2.1.
- Checkstyle is licensed under the GNU Lesser Public License, Version 2.1.
- PMD is licensed under a BSD-style license.
- stdlib.jar and algs4.jar are licensed under the GNU General Public License, Version 3.
We haven’t tested out these instructions on all flavors of Linux, but the instructions should be identical except for installing Java. We recommend using your distribution’s package manager (such as
apt
,zypper
,emerge
, oryum
) to install Java.Can I use a vendor and version of Java other than OpenJDK 11?
Yes. You may use any version of Java 8, Java 9, Java 10, or Java 12, from either Oracle or OpenJDK. However, if you do so, you will need to manually configure the Platform SDK and Project SDK via IntelliJ via File → Project Structure.
How can I check which version of Java is installed (and where it is installed)?
Type the following commands in the terminal:
It’s important that the Java version numbers match and that you see the number<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">javac -version</span> javac 11.0.7 <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">java -version</span> openjdk version "11.0.7" 2018-07-17 OpenJDK Runtime Environment 18.3 (build 11.0.7+13) OpenJDK 64-Bit Server VM 18.3 (build 11.0.7+13, mixed mode) </span>
11
, but the rest is not critical.How does this custom version of IntelliJ different from the standard one?
IntelliJ is an industrial-strength integrated development environment (IDE), suitable for use by professional programmers. The installer configures your user preferences to make it more suitable for use by novice programmers:- Disables all built-in plugins except Terminal and JUnit. Installs the SpotBugs, Checkstyle-IDEA, Run-with-Arguments, Save-Actions, and Archive browser plugins.
- Eliminates or reduces various popup elements (lightbulbs, code folding, breadcrumbs, gutter markers, notifications, parameter hints).
- Simplifies menus and toolbars, hiding advanced options.
- Disables live templates and postfix completion.
- Adopts the Obsidian Black color scheme.
- Auto-configures Java upon installation.
- Adds a few keyboard shortcuts.
The course-specific project folders perform additional customizations:
- Streamlines autocomplete to display only relevant libraries (such as
java.lang
,java.util
, andalgs4.jar
). - Configures SpotBugs and Checkstyle with course-specific rules.
- Provides course-specific libraries (such as
algs4.jar
). - Enables auto-formatting of code on save.
- Enables auto-importing of Java libraries.
Which are the most important IntelliJ menu options to remember?
Here are the most important ones (and their shortcuts).- LIFT → New Java Class (Ctrl + N). Create a new Java class.
- LIFT → Recompile (Ctrl + B). Compile the current program.
- LIFT → Run with Arguments (Ctrl + E). Run the current program with command-line arguments.
- LIFT → Open in Terminal (Ctrl + T). Open a new Terminal tab.
- File → Save All (Ctrl + S). Save (and reformat) all open files.
- View → Tool Windows → Project (Alt + 1). Show/hide the Project View sidebar.
- View → Tool Windows → Terminal (Alt + 2). Show/hide the Terminal window.
Any special characters to avoid when naming IntelliJ projects or files?
Do not use an exclamation point (!) as the last character in the project folder (or any directory name along the path to your project folder); that will confuse both IntelliJ and Checkstyle.
How can I create a new project in IntelliJ?
If you want to inherit all of the properties of an existing project,- Use your system’s file manager (such as Nautilus) to copy the project folder, giving it your preferred name.
- Delete any unwanted files.
- Be sure to keep the
.iml
file (which defines the project), the.idea
subdirectory (which contains the IntelliJ course preferences), and the.lift
subdirectory (which contains the course libraries).
To create a new project from scratch, you can use the Create New Project option from the Welcome screen. But, we do not recommend this approach for novice programmers.
Can I use a version of IntelliJ that is more recent than 2020.1.1?
Yes, though if it is 2020.2 (or above), you will need to migrate your user preferences.
- To restore the menus and toolbars: Preferences → Appearances & Behavior → Menus and Toolbars → Restore All Defaults.
- To restore all settings: Help → Find Action → Restore Default Settings.
Make sure that you are using the appropriate wrapper script, such as
If you followed our instructions, our wrapper scripts (such asjavac-algs4
orjava-algs4
.javac-algs4
andjava-algs4
) should already be available.Our autoinstaller customizes the command line in a few ways by copying these three configuration files:
.bashrc
,.bash_profile
, and.inputrc
.How do I break out of a program in an infinite loop?
Type
Ctrl-C
.How do I specify EOF to signal that standard input is empty?
On Mac OS X and Linux, type
Enter
Ctrl-D
. On Windows, typeEnter
Ctrl-Z
Enter
, even in Git Bash.How can I run SpotBugs, PMD, and Checkstyle from the command line?
The installer includes wrapper scripts to simplify this process.- To run SpotBugs 4.0.3, type the following command in the terminal:
The argument must be a list of<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">spotbugs HelloWorld.class</span> Running spotbugs on HelloWorld.class: </span>
.class
files. Here is a list of bug descriptions. - To run PMD 6.15.0, type the following command in the terminal:
The argument must be either a single<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">pmd HelloWorld.java</span> Running pmd on HelloWorld.java: </span>
.java
file or a directory containing one or more.java
files. Here is a list of bug patterns. - To run Checkstyle 8.31, type one of the following commands in the terminal, depending on whether you are COS 126, COS 226, or Coursera student:
The argument must be a list of<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">checkstyle -cos126 HelloWorld.java</span> Running checkstyle on HelloWorld.java: <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">checkstyle -cos226 HelloWorld.java</span> Running checkstyle on HelloWorld.java: <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">checkstyle -coursera HelloWorld.java</span> Running checkstyle on HelloWorld.java: </span>
.java
files. Here is a list of available checks.Due to a bug in the autoinstaller, for this to work, you must update the Checkstyle config files to be compatible with Checkstyle 8.31. On OS X, the command is
<span style="color:#ffffff"><span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">cd /usr/local/lift</span> <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">sudo curl -O "https://lift.cs.princeton.edu/java/checkstyle-{cos126,cos226,coursera,suppressions}.xml"</span> <span style="color:#75cfff">~/hello></span> <span style="color:#ffffa8">cd -</span> </span>
How do I verify that
/usr/local/bin
is in myPATH
environment variable? - IntelliJ IDEA, Community Edition is licensed under the Apache License, Version 2.0.