Difference between revisions of "Java"

From ArchWiki
Jump to: navigation, search
m (Oracle JVM)
(31 intermediate revisions by 17 users not shown)
Line 1: Line 1:
[[Category:Development (English)]]
+
[[Category:Programming language]]
{{i18n|Java}}
+
[[cs:Java]]
 +
[[es:Java]]
 
[[fr:Java]]
 
[[fr:Java]]
 
+
[[it:Java]]
 +
[[pt:Java]]
 +
[[ru:Java]]
 +
[[tr:Java]]
 
{{Article summary start}}
 
{{Article summary start}}
 
{{Article summary text|This article explains how to install and configure JRE/JDK.}}
 
{{Article summary text|This article explains how to install and configure JRE/JDK.}}
Line 13: Line 17:
 
== Installation ==
 
== Installation ==
 
The only JVM implementation in supported repositories is the open source [http://openjdk.java.net/ OpenJDK]. Additional Java implementations are available via the [[AUR]]. Keep in mind that the open-source and closed-source versions cannot be installed simultaneously. The open-source version is nearly perfect at the time of writing, and there is mostly no need anymore to install Oracle's proprietary version of Java.
 
The only JVM implementation in supported repositories is the open source [http://openjdk.java.net/ OpenJDK]. Additional Java implementations are available via the [[AUR]]. Keep in mind that the open-source and closed-source versions cannot be installed simultaneously. The open-source version is nearly perfect at the time of writing, and there is mostly no need anymore to install Oracle's proprietary version of Java.
 +
 +
{{Note|After installation, the Java environment will need recognized by the shell ({{Ic|$PATH}} variable and {{Ic|$JAVA_HOME}}).  This can be done from the command line by sourcing {{Ic|/etc/profile}}, and for Desktop Environments it is likely a logout/login will be necessary.}}
  
 
=== OpenJDK JVM ===
 
=== OpenJDK JVM ===
To be able to run Java programs, you can install [[Wikipedia:JRE|Java runtime]] with the package {{Pkg|jre7-openjdk}}, available in the [[official repositories]]. There is also a [[Wikipedia:JDK|Java Development Kit]] in {{Pkg|jdk7-openjdk}}. For those interested in the old Java v6, both JRE6 and JDK6 can be found in {{Pkg|openjdk6}}.
+
To be able to run Java programs, you can install [[Wikipedia:JRE|Java runtime]] with the package {{Pkg|jre7-openjdk}}, available in the [[official repositories]]. There is also a [[Wikipedia:JDK|Java Development Kit]] in {{Pkg|jdk7-openjdk}}. As of [https://mailman.archlinux.org/pipermail/arch-general/2013-February/032930.html March 2013] {{Ic|openjdk6}} is no longer available.
  
You will likely need the {{Pkg|icedtea-web-java7}} package for Java functionality in browsers, namely [[Wikipedia:Java applet|applets]] and [[Wikipedia:Java Web Start|Web Start]] (for more details see [[Browser Plugins#Java]]).
+
You will likely need the {{Pkg|icedtea-web-java7}} package for Java functionality in browsers, namely [[Wikipedia:Java applet|applets]] and [[Wikipedia:Java Web Start|Web Start]] (for more details see [[Browser Plugins#Java (IcedTea)]]).
  
{{Note|If you use a non-reparenting window manager and Java 6, you should uncomment the corresponding line in {{Ic|/etc/profile.d/openjdk6.sh}}}}
+
==== Flagging OpenJDK packages as out-of-date ====
 +
Please flag packages {{Pkg|jre7-openjdk-headless}}, {{Pkg|jre7-openjdk}} and {{Pkg|jdk7-openjdk}} as out-of-date based on their [http://icedtea.wildebeest.org/download/source IcedTea version] (2.3.4) rather than on their Oracle version (u9).
 +
IcedTea-web projects (packages {{Pkg|icedtea-web}} and {{Pkg|icedtea-web-java7}}) have version numbers that are independant from the IcedTea one (packages {{Pkg|jre7-openjdk-headless}}, {{Pkg|jre7-openjdk}} and {{Pkg|jdk7-openjdk}}) so please flag each package based on its right version number.
  
 
=== Oracle JVM ===
 
=== Oracle JVM ===
Prior to the [http://mailman.archlinux.org/pipermail/arch-general/2011-August/021671.html retirement of the Oracle DLJ], it was possible to simply install the {{Ic|jre}} and {{Ic|jdk}} packages from the repositories. However, now Arch Linux (and any other GNU/Linux distribution) can no longer package the Oracle implementation of Java. The OpenJDK packages are the recommended providers of {{Ic|java-runtime}} and {{Ic|java-environment}}.
+
Prior to the [https://mailman.archlinux.org/pipermail/arch-general/2011-August/021671.html retirement of the Oracle DLJ], it was possible to simply install the {{AUR|jre}} and {{AUR|jdk}} packages from the repositories. However, now Arch Linux (and any other GNU/Linux distribution) can no longer package the Oracle implementation of Java. The OpenJDK packages are the recommended providers of {{Ic|java-runtime}} and {{Ic|java-environment}}.
  
AUR contains packages for {{AUR|jre}} and {{AUR|jdk}}, the Oracle implementations of Java.
+
=== Oracle JVM (Java 6) ===
 +
AUR contains package for {{AUR|jre6}} and {{AUR|jdk6}}, which are the Oracle implementations of Java SE 6.  These packages conflict with the other java packages, so there are also {{AUR|jre6-compat}} and {{AUR|jdk6-compat}} which can be used along side other java installations.
  
{{Note|You will need to ensure that {{Ic|/opt/java/jre/bin/}} is in your {{Ic|$PATH}} variable, and that {{Ic|$JAVA_HOME}} points to the correct position (generally {{Ic|/opt/java}}). You can do this by either logging out and in again, or by sourcing {{Ic|/etc/profile}}.}}
+
=== Kaffe (Discontinued) ===
 
+
=== Java SE 6 (Oracle JVM) ===
+
 
+
For users interested in Java SE 6, the packages {{AUR|jre}} and {{AUR|jdk}} have been updated to Java SE 7. However, you can still install the JRE/JDK manually.
+
 
+
Here's how to do so:
+
 
+
{{Note| This short walkthrough installs the JDK alone.}}
+
 
+
First, go to http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html, move down to Hava SE 6u31 (or something of the sort) "JDK." Accept the license agreement and then download either {{Ic|jdk-6u31-linux-i586.bin}} if your system is 32-bit OR {{Ic|jdk-6u31-linux-i586.bin}} if your system is 64-bit.
+
 
+
Now, do the following:
+
 
+
{{Note| The rest of this walkthrough assumes you'll be installing the JDK in /opt. If this is not the case, alter the instructions to where you installed the JDK. Instructions for 32-bit and 64-bit operating systems will vary.}}
+
 
+
==== For 32-bit systems ====
+
 
+
Open up a terminal, and then change to the directory where you downloaded the binary. Then do the following:
+
 
+
  $ chmod a+x jdk-6u31-linux-i586.bin
+
  $ su -c 'mv jdk-6u31-linux-i586.bin /opt
+
  $ cd /opt
+
  # ./jdk-6u31-linux-i586.bin
+
  # rm jdk-6u31-linux-i586.bin
+
 
+
The JDK has now been installed. However, we're not quite finished. We need to alter our PATH so that Java will be in it. To do so, we need to edit /etc/profile. Why? Because we want to make this configuration system-wide, and not bound to one user. Now, using your favorite text editor, open up /etc/profile as root and then find this line:
+
 
+
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:"
+
 
+
Now, add the location of where the JDK was installed. In this tutorial's case, the JDK was installed in /opt. Therefore, the result should look like this if you've installed the JDK in /opt:
+
 
+
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/opt/jdk1.6.0_31/bin:/opt/jdk1.6.0_31/jre/bin"
+
 
+
After you've done so, save your changes and exit. For your changes to take effect, either log out or source /etc/profile. To see if the changes took place, execute the following:
+
 
+
  $ echo $PATH
+
 
+
If you see something like <jdk>/bin:<jdk>/jre/bin in your PATH, where <jdk> is the location of where you installed it, congratulations! You've installed the JDK!
+
 
+
To install the browser plugin, first close any and all web browser you have open. Then create a symlink to the browser plugin like so:
+
 
+
  $ ln -s <jdk>/jre/lib/i386/libnpjp2.so ~/.mozilla/plugins
+
 
+
Remember to replace <jdk> with the location of where the JDK is.
+
 
+
==== For 64-bit systems ====
+
 
+
According to Oracle, you can run either the 32-bit version of the JDK/JRE or the 64-bit, however if you have a 32-bit browser, you *must* follow the 32-bit version of the tutorial. The installation of the JDK/JRE remains largely the same, aside from a few differences.
+
 
+
First, open up a terminal and then change to the directory where you downloaded the binary. Then, do the following:
+
 
+
{{Note| If you're not going to install in /opt, then change the instructions to where you wish to install the JDK.}}
+
 
+
  $ chmod a+x jdk-6u31-linux-x64.bin
+
  $ su -c 'mv jdk-6u31-linux-x64.bin /opt'
+
  $ cd /opt
+
  # ./jdk-6u31-linux-x64.bin
+
  # rm jdk-6u31-linux-x64.bin
+
 
+
Now that the JDK's been installed, it's time to edit your PATH. Using your favorite text editor, open up /etc/profile as root and then find the line in /etc/profile that looks like this:
+
 
+
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:"
+
 
+
Now append the location to where you set up the JDK to the end of the line. In this tutorial's case, it was installed in /opt. Therefore, the result for us will look like this:
+
 
+
  PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/opt/jdk1.6.0_31/bin:/opt/jdk1.6.0_31/jre/bin"
+
 
+
Now either log out or source /etc/profile. To see if your changes took effect, execute the following:
+
 
+
  $ echo $PATH
+
 
+
If you see something like <jdk>/bin:<jdk>/jre/bin in your PATH, where <jdk> is the location of where you installed the JDK, congratulations! You just installed the JDK manually :). Give yourself a pat on the back.
+
 
+
To install the browser plugin, close all browser windows you have open and create a symlink to {{Ic|~/.mozilla/plugins.}} like so:
+
 
+
  $ ln -s <jdk>/jre/lib/amd64/libnpjp2.so ~/.mozilla/plugins
+
 
+
=== Apache Harmony ===
+
[http://harmony.apache.org/ Apache Harmony] is a clean room re-implementation of the Java language and comes under the Free Apache license. A binary re-distribution of the Harmony JRE can be found in the AUR: {{AUR|apache-harmony-jre}}.
+
 
+
=== Kaffe ===
+
 
[http://www.kaffe.org/ Kaffe] is another clean-room implementation of a Java VM without official endorsement from Sun/Oracle. A [[git]] package of Kaffe can be found in the [[AUR]] here: {{AUR|kaffe-git}}. The Kaffe VM is redistributed according to the GPL license.
 
[http://www.kaffe.org/ Kaffe] is another clean-room implementation of a Java VM without official endorsement from Sun/Oracle. A [[git]] package of Kaffe can be found in the [[AUR]] here: {{AUR|kaffe-git}}. The Kaffe VM is redistributed according to the GPL license.
  
Line 114: Line 42:
  
 
=== VMkit LLVM-based JIT VM ===
 
=== VMkit LLVM-based JIT VM ===
[http://vmkit.llvm.org/index.html VMkit] is an LLVM-based framework for JIT virtual machines. J3 is a JVM running on VMkit. A broken build for VMkit can be found in the [[AUR]] here: {{AUR|vmkit-svn}}. J3 depends on the GNU classpath libraries, but may also work with the Apache class path libraries.
+
[http://vmkit.llvm.org/index.html VMkit] is an LLVM-based framework for JIT virtual machines. J3 is a JVM running on VMkit. The webpage can be found here: [[http://vmkit.llvm.org/get_started.html vmkit]]. J3 depends on the GNU classpath libraries, but may also work with the Apache class path libraries.
  
 
=== Parrot VM ===
 
=== Parrot VM ===
The [http://www.archlinux.org/packages/?q=parrot Parrot VM] offers experimental [http://trac.parrot.org/parrot/wiki/Languages support for Java] through two different methods: Either as a [http://code.google.com/p/parrot-jvm/ Java VM bytecode translator] or as a [https://github.com/chrisdolan/perk Java compiler targeting the Parrot VM]. Available in the AUR package {{AUR|parrot-git}}.
+
The [https://www.archlinux.org/packages/?q=parrot Parrot VM] offers experimental [http://trac.parrot.org/parrot/wiki/Languages support for Java] through two different methods: Either as a [http://code.google.com/p/parrot-jvm/ Java VM bytecode translator] or as a [https://github.com/chrisdolan/perk Java compiler targeting the Parrot VM]. Available in the AUR package {{AUR|parrot-git}}.
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 140: Line 68:
  
 
You can also try replacing padsp with aoss, which can also fix it under standard ALSA as well as in Pulse, do what works best. I must warn everyone that these hacks sometimes work perfect, but are sometimes very unstable as well.
 
You can also try replacing padsp with aoss, which can also fix it under standard ALSA as well as in Pulse, do what works best. I must warn everyone that these hacks sometimes work perfect, but are sometimes very unstable as well.
 +
=== Impersonate Another Window Manager ===
 +
You may use the {{pkg|wmname}} from [http://tools.suckless.org/wmname  suckless.org] to make the JVM believe you are running a different window manager. This may solve a rendering issue of Java GUIs occuring in window managers like [[Awesome]] or [[Dwm]].
 +
 +
<pre>$ wmname LG3D</pre>
 +
 +
(You must restart the application in question after issuing the wmname command.)
 +
 +
This works because the JVM contains a hard-coded list of known non-re-parenting window managers.  For maximum irony, many users prefer to impersonate &ldquo;<code>LG3D</code>,&rdquo; the non-re-parenting window manager [http://en.wikipedia.org/wiki/Project_Looking_Glass written by Sun, in Java].
 +
 +
=== Fonts are Illegible ===
 +
In addition to the suggestions mentioned below in [[https://wiki.archlinux.org/index.php/Java#Better_font_rendering| tips and tricks]] some fonts may still not be legible afterwards. If this is the case there is a good chance ms-fonts are being used. Install {{AUR|ttf-ms-fonts}} from the AUR.
  
 
== Tips and tricks ==
 
== Tips and tricks ==
{{Note|Suggestions in this section are applicable to all applications, using explicitly installed (external) Java runtime. Some applications are bundled with own (private) runtime or use own mechanics for GUI, font rendering etc, so none of written below is guaranteed to work.}}
+
{{Note|Suggestions in this section are applicable to all applications, using explicitly installed (external) Java runtime. Some applications are bundled with own (private) runtime or use own mechanics for GUI, font rendering, etc., so none of written below is guaranteed to work.}}
  
 
Behavior of most Java applications can be controlled by supplying predefined variables to Java runtime. From [https://bbs.archlinux.org/viewtopic.php?id=72892 this forum post], a way to do it consists of adding the following line in your {{Ic|~/.bashrc}} (or {{Ic|/etc/profile.d/jre.sh}} to affect all users):
 
Behavior of most Java applications can be controlled by supplying predefined variables to Java runtime. From [https://bbs.archlinux.org/viewtopic.php?id=72892 this forum post], a way to do it consists of adding the following line in your {{Ic|~/.bashrc}} (or {{Ic|/etc/profile.d/jre.sh}} to affect all users):
  
 
  export _JAVA_OPTIONS="-D'''<option 1>''' -D'''<option 2>'''..."
 
  export _JAVA_OPTIONS="-D'''<option 1>''' -D'''<option 2>'''..."
 +
 +
For example, to use system anti-aliased fonts and make swing use the GTK look and feel:
 +
 +
export _JAVA_OPTIONS='-Dawt.useSystemAAFontSettings=on -Dswing.aatext=true -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel'
  
 
=== Better font rendering ===
 
=== Better font rendering ===
Both closed source and open source one implementations of Java are known to have improperly implement antialiasing of fonts. This can be fixed with following options: {{Ic|1=awt.useSystemAAFontSettings=on}}, {{Ic|1=swing.aatext=true}}
+
Both closed source and open source implementations of Java are known to have improperly implemented anti-aliasing of fonts. This can be fixed with the following options: {{Ic|1=awt.useSystemAAFontSettings=on}}, {{Ic|1=swing.aatext=true}}
  
 
=== GTK LookAndFeel ===
 
=== GTK LookAndFeel ===
If your java programs look ugly, you may want to set up the default look and feel for the swing components: {{Ic|1=swing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel}}.
+
If your Java programs look ugly, you may want to set up the default look and feel for the swing components: {{Ic|1=swing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel}}.
 +
 
 +
Some stubborn Java programs insist on using the cross platform Metal look and feel.  In some of these cases you can force these apps to use the GTK look and feel by setting the following property:
 +
 
 +
{{Ic|1=swing.crossplatformlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel}}.

Revision as of 21:28, 4 March 2013

Summary help replacing me
This article explains how to install and configure JRE/JDK.
Related
Java Package Guidelines

"Java is a programming language originally developed by Sun Microsystems and released in 1995 as a core component of Sun Microsystems' Java platform. The language derives much of its syntax from C and C++ but has a simpler object model and fewer low-level facilities. Java applications are typically compiled to bytecode that can run on any Java virtual machine (JVM) regardless of computer architecture." — Wikipedia article

Installation

The only JVM implementation in supported repositories is the open source OpenJDK. Additional Java implementations are available via the AUR. Keep in mind that the open-source and closed-source versions cannot be installed simultaneously. The open-source version is nearly perfect at the time of writing, and there is mostly no need anymore to install Oracle's proprietary version of Java.

Note: After installation, the Java environment will need recognized by the shell ($PATH variable and $JAVA_HOME). This can be done from the command line by sourcing /etc/profile, and for Desktop Environments it is likely a logout/login will be necessary.

OpenJDK JVM

To be able to run Java programs, you can install Java runtime with the package jre7-openjdk, available in the official repositories. There is also a Java Development Kit in jdk7-openjdk. As of March 2013 openjdk6 is no longer available.

You will likely need the icedtea-web-java7 package for Java functionality in browsers, namely applets and Web Start (for more details see Browser Plugins#Java (IcedTea)).

Flagging OpenJDK packages as out-of-date

Please flag packages jre7-openjdk-headless, jre7-openjdk and jdk7-openjdk as out-of-date based on their IcedTea version (2.3.4) rather than on their Oracle version (u9). IcedTea-web projects (packages icedtea-web and icedtea-web-java7) have version numbers that are independant from the IcedTea one (packages jre7-openjdk-headless, jre7-openjdk and jdk7-openjdk) so please flag each package based on its right version number.

Oracle JVM

Prior to the retirement of the Oracle DLJ, it was possible to simply install the jreAUR and jdkAUR packages from the repositories. However, now Arch Linux (and any other GNU/Linux distribution) can no longer package the Oracle implementation of Java. The OpenJDK packages are the recommended providers of java-runtime and java-environment.

Oracle JVM (Java 6)

AUR contains package for jre6AUR and jdk6AUR, which are the Oracle implementations of Java SE 6. These packages conflict with the other java packages, so there are also jre6-compatAUR and jdk6-compatAUR which can be used along side other java installations.

Kaffe (Discontinued)

Kaffe is another clean-room implementation of a Java VM without official endorsement from Sun/Oracle. A git package of Kaffe can be found in the AUR here: kaffe-gitAUR. The Kaffe VM is redistributed according to the GPL license.

BEA JRockit JIT JVM (+JDK)

JRockit is JIT version of Java, provided by Oracle and available from the AUR here: jrockitAUR.

VMkit LLVM-based JIT VM

VMkit is an LLVM-based framework for JIT virtual machines. J3 is a JVM running on VMkit. The webpage can be found here: [vmkit]. J3 depends on the GNU classpath libraries, but may also work with the Apache class path libraries.

Parrot VM

The Parrot VM offers experimental support for Java through two different methods: Either as a Java VM bytecode translator or as a Java compiler targeting the Parrot VM. Available in the AUR package parrot-gitAUR.

Troubleshooting

MySQL

Due to the fact that the JDBC-drivers often use the port in the URL to establish a connection to the database, it is considered "remote" (i.e., MySQL does not listen to the port as per its default settings) despite the fact that they are possibly running on the same host, Thus, to use JDBC and MySQL you should enable remote access to MySQL, following instructions in MySQL article.

Java sound with Pulseaudio

Note: This procedure is likely to be relevant for previous version of Java (Java 6) only.

By default, Java and Pulseaudio do not get along very well with each other, but this is easy to fix using padsp.

(These paths are correct for Sun's Java, you will need to change the paths for OpenJDK)

First, rename the java binary to java.bin

# mv /opt/java/jre/bin/java /opt/java/jre/bin/java.bin

Then, create a new launcher script at /opt/java/jre/bin/java

#!/bin/sh
padsp /opt/java/jre/bin/java.bin "$@"

Finally, make the launcher script executable

# chmod +x /opt/java/jre/bin/java

You will need to redo this process on each update of Java.

You can also try replacing padsp with aoss, which can also fix it under standard ALSA as well as in Pulse, do what works best. I must warn everyone that these hacks sometimes work perfect, but are sometimes very unstable as well.

Impersonate Another Window Manager

You may use the wmname from suckless.org to make the JVM believe you are running a different window manager. This may solve a rendering issue of Java GUIs occuring in window managers like Awesome or Dwm.

$ wmname LG3D

(You must restart the application in question after issuing the wmname command.)

This works because the JVM contains a hard-coded list of known non-re-parenting window managers. For maximum irony, many users prefer to impersonate “LG3D,” the non-re-parenting window manager written by Sun, in Java.

Fonts are Illegible

In addition to the suggestions mentioned below in [tips and tricks] some fonts may still not be legible afterwards. If this is the case there is a good chance ms-fonts are being used. Install ttf-ms-fontsAUR from the AUR.

Tips and tricks

Note: Suggestions in this section are applicable to all applications, using explicitly installed (external) Java runtime. Some applications are bundled with own (private) runtime or use own mechanics for GUI, font rendering, etc., so none of written below is guaranteed to work.

Behavior of most Java applications can be controlled by supplying predefined variables to Java runtime. From this forum post, a way to do it consists of adding the following line in your ~/.bashrc (or /etc/profile.d/jre.sh to affect all users):

export _JAVA_OPTIONS="-D<option 1> -D<option 2>..."

For example, to use system anti-aliased fonts and make swing use the GTK look and feel:

export _JAVA_OPTIONS='-Dawt.useSystemAAFontSettings=on -Dswing.aatext=true -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel'

Better font rendering

Both closed source and open source implementations of Java are known to have improperly implemented anti-aliasing of fonts. This can be fixed with the following options: awt.useSystemAAFontSettings=on, swing.aatext=true

GTK LookAndFeel

If your Java programs look ugly, you may want to set up the default look and feel for the swing components: swing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel.

Some stubborn Java programs insist on using the cross platform Metal look and feel. In some of these cases you can force these apps to use the GTK look and feel by setting the following property:

swing.crossplatformlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel.