Gentoo Java指南

1.  什么是Java？

简介

Java是Sun Microsystems开发的一门面向对象的程序语言，可以在不用重新编译的前提下运行在不同的平台上。虽然也可以被编译成原生程序，但良好的移植性和内存垃圾回收才是Java受欢迎的主要原因。Java编译器会将Java代码转换成Java字节码作为中间层在JRE（Java运行环境）上而不是直接在操作系统上运行，这就使平台无关成为了可能。

为了运行Java字节码，必须首先安装JRE（Java运行环境）。JRE会提供核心库，一个独立平台的Java虚拟机和浏览器插件等等。JDK（Java开发工具）则集成了编程所开发需的工具，例如字节码编译器和调试器。

2.  在你开始之前

已经安装

如果已经安装过Java，不论是什么版本都请参照Java升级指南。

全新安装

全新安装不需要其它准备工作。

3.  安装虚拟机

选择

Gentoo提供了多种运行环境（JRE）和开发工具（JDK）。我们现有的选择是：

安装JRE／JDK

你可以使用emerge virtual/jdk来安装profile默认的JDK。或者，你可以使用emerge virtual/jre安装profile默认的JRE。

Sun近期重新制作了一个更适合Linux的JDK／JRE许可认证。所以从Sun Java 1.5开始，用户可以在不做任何额外工作的前提下免费下载。

安装不能通过命令行下载的虚拟机

在安装某些JDK和JRE前你需要多做一些步骤。你只需要照常emerge你需要的软件包，之后ebuild会告诉你在哪里可以下载所需的文件。

把需要的软件包放在/usr/portage/distfiles。完成后重新emerge安装JRE／JDK。

4.  配置你的虚拟机

简介

Gentoo支持安装多个JDK或者JRE并且不会造成任何冲突。

使用java-config工具，你可以更改系统设置（需要root用户）。普通用户可以使用java-config改变个人设置。

设定默认虚拟机

运行java-config --list-available-vms会显示在你机器上现有的JRE和JDK。如下例：

# java-config --list-available-vms
The following VMs are available for generation-2:
1)      IcedTea6-bin 1.4.1 [icedtea6-bin]
2)      Sun JDK 1.5.0.20 [sun-jdk-1.5] (Build Only)
*)      Sun JDK 1.6.0.16 [sun-jdk-1.6]

*标志出了你现在正在使用的虚拟机（系统虚拟机或者用户虚拟机）。括号（[]）中的名字代表这个虚拟机的ID或者handle。你可以使用handle或ID来设置系统虚拟机：java-config --set-system-vm。下面是一个更改系统虚拟机的例子。

（通过handle（推荐））
# java-config --set-system-vm sun-jdk-1.6
Now using sun-jdk-1.6 as your generation-2 system JVM
（通过ID）
# java-config --set-system-vm 3
Now using sun-jdk-1.6 as your generation-2 system JVM

作为一个普通用户，你可以使用java-config --set-user-vm。

Build Only VM

有些虚拟机被标记为buildonly，因为他们的生命周期已经结束或者包含安全漏洞。这些虚拟机并不会自动被Gentoo用来运行应用程序，但是我们仍然提供它因为有些包仍然需要它来构建。我们强烈建议不要把这些虚拟机设定为你的系统或者用户虚拟机，因为如果那样的话，运行/usr/bin/{java,javac,..}等可执行文件以及其他不使用Gentoo的java启动脚本的包的时候，这些虚拟机就会被用到了。

首选虚拟机

当安装Java写成的软件的时候，虚拟机将会在需要时被切换。

因为有很多的不同的虚拟机可以选择，我们没有足够的资源去测试和确认所有的软件包都能在上面正常工作。所以为确保所有的软件包都能成功安装，我们为每个平台都定制了一份默认的／受支持的虚拟机列表。此列表可以在/usr/share/java-config-2/config/jdk-defaults.conf文件中找到。当你在安装Java软件包时，如果系统检测到该列表中的某个虚拟机已经安装，它会自动使用该虚拟机，而不是system-vm。

有时需要在安装软件时切换虚拟机。例如，system-vm设定为1.4，当你安装需要1.5版的软件包时，虚拟机会被临时切换。

当然，Gentoo给予了用户充分的选择权利，你可以重写在/etc/java-config-2/build/jdk.conf中默认的配置，完全控制使用哪一个虚拟机。如下例：

我只想使用sun-jdk，例如1.4版使用sun-jdk-1.4、1.5版使用sun-jdk-1.5等等。
*=sun-jdk

我只想使用sun-jdk-1.5，除了指明需要1.3或1.4版虚拟机的情况
*=sun-jdk-1.5

# 对于1.3版优先使用sun-jdk 1.4。当sun-jdk 1.4不可用时，用ibm-jdk-bin替代
# 对于1.5版, 使用sun-jdk 
1.3=sun-jdk-1.4 ibm-jdk-bin
1.5=sun-jdk

5.  编译器

对于任何的JDK，你可以使用javac来调用标准的编译器。在编译时，你除了可以设定虚拟机，也可以设定编译器。简单说，你可以在/etc/java-config-2/build/compilers.conf里定义你首选的编译器。

# 如果ebuild支持它
# 它会从头到尾的检查COMPILERS变量里的值
# 并且使用第一个已经安装的编译器

COMPILERS="ecj-X.Y jikes javac"

部分编译器不支持所有可能的-target和-source参数。所以每一个在列表中的编译器都会被检测来确定它是否支持所需要的-source／-target。javac支持所有的参数，所以如果在列表中没有发现合适的编译器，javac会被调用。

每个编译器的细节如下：

6.  设定默认CLASSPATH

java-config也可以用来设定系统级别的CLASSPATH和用户级别的CLASSPATH。

首先，你要列出所有在你系统上安装的Java库：

# java-config --list-available-packages
[xerces-2] The next generation of high performance, fully compliant XML parsers in the Apache Xerces family (/usr/share/xerces-2/package.env)
[junit] Simple framework to write repeatable tests (/usr/share/junit/package.env)
[bsh] BeanShell: A small embeddable Java source interpreter (/usr/share/bsh/package.env)
[bcel] The Byte Code Engineering Library: analyze, create, manipulate Java class files (/usr/share/bcel/package.env)
[log4j] A low-overhead robust logging package for Java (/usr/share/log4j/package.env)
...

和前面一样，在括号（[]）中的名字代表你将传递给java-config --set-system-classpath的ID。如下例：

# java-config --set-system-classpath log4j,xerces-2

你需要注销并重新登录或者source /etc/profile来更新你的环境变量。

对于用户，java-config --set-user-classpath会建立~/.gentoo/java-env-classpath。之后你应该从你的shell的profile里source这个文件。

if [[ -f "${HOME}/.gentoo/java-env-classpath" ]]; then
	source ${HOME}/.gentoo/java-env-classpath
fi

如果你真的想要设定一个系统级别或者用户指定的classpath，你可以添加下面的代码到你的shell profile，但是我们不建议你这么做。

# export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"

7.  Java浏览器插件

安装插件

你可以在启用nsplugin USE标记的情况下emerge Java虚拟机来安装Java浏览器插件。

Portage允许你安装多个不同版本的Java插件，但是只有一个会被浏览器使用。你可以用以下指令查看可用的插件：

# eselect java-nsplugin list
   [1]   sun-jre-bin-1.6
   [2]   icedtea6-bin

在这个例子中sun-jre-bin被选择做为浏览器插件。

# eselect java-nsplugin set sun-jre-bin-1.6

确认选择了正确的插件：

# eselect java-nsplugin list
   [1]   sun-jre-bin-1.6  current
   [2]   icedtea6-bin

Java.com也提供了一个链接来验证你已经安装的插件。如果你使用基于Mozilla的浏览器，你可以地址栏输入about:plugins来验证你的Java插件。

multilib系统的插件

如果你的系统包括了64位和32位multilib（例如AMD64），你能使用64位和32位Java插件。除非你有不可抗拒的理由要运行32位Java应用程序，否则我们推荐在64位浏览器上使用原生64位插件。

我们提供了几个原生64位浏览器插件。默认的JDK/JRE，sun-jdk和sun-jre-bin，都包含浏览器插件。 只要以nsplugin USE标记emerge其中一个即可。

# echo "dev-java/sun-jre-bin nsplugin" >> /etc/portage/package.use
# emerge sun-jre-bin

要在32位浏览器上使用32位插件，你可以使用nsplugin USE标记emerge emul-linux-x86-java。

# echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use
# emerge emul-linux-x86-java

下一步，检查可用的插件：

# eselect java-nsplugin list
Available 32-bit Java browser plugins
  [1]   emul-linux-x86-java-1.5
  [2]   emul-linux-x86-java-1.6
Available 64-bit Java browser plugins
  [1]   icedtea6-bin
  [2]   sun-jre-bin-1.6

现在，选择适合你的浏览器的正确插件：

(Choose the plugins for 32-bit and 64-bit browsers)
# eselect java-nsplugin set 32bit emul-linux-x86-java-1.6
# eselect java-nsplugin set 64bit sun-jre-bin-1.6

核实选择了正确的插件：

# eselect java-nsplugin list
Available 32-bit Java browser plugins
  [1]   emul-linux-x86-java-1.5
  [2]   emul-linux-x86-java-1.6  current
Available 64-bit Java browser plugins
  [1]   icedtea6-bin
  [2]   sun-jre-bin-1.6  current

8.  Java的USE标记

设定USE标记

更多关于USE标记的信息，参照Gentoo手册USE标记。

标记

• java标记可以让多种不同的程序支持Java
• nsplugin标记让基于Mozilla的浏览器（包括Firefox）支持Java。你需要它来在基于Mozilla的浏览器上运行Java applet。
• source标记会安装以zip形式安装软件包的源代码。这个一般是让IDE给你使用的库添加源代码。
• jce标记添加了对Java加密引擎的支持
• 对于Java的软件包，doc标记将会使用javadoc建立API文档

9.  附加资料

离线资料

• java-config man page
• java-config --help

在线资料

• Gentoo的Java项目主页
• Gentoo的gentoo-java, gentoo-user, and gentoo-dev邮件列表归档
• #gentoo和#gentoo-java IRC频道
• Wikipedia上的Java条目
• 如果你对于这篇文档有建议或问题，请发邮件到Gentoo Java团队：java@gentoo.org

本文档的内容遵循知识共享-署名-相同方式共享许可协议