glfs/general/prog/java.xml
Pierre Labastie 8824a1e05b Update to icedtea-2.5.0
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@13322 af4574ff-66df-0310-9fd7-8a98e5e911e0
2014-06-27 20:48:53 +00:00

164 lines
6.5 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY anduin-download "http://anduin.linuxfromscratch.org/files/BLFS/OpenJDK-&openjdk-version;">
<!ENTITY openjdk-download-binary-x86 "&anduin-download;/OpenJDK-&openjdk-version;-i686-bin.tar.xz">
<!ENTITY openjdk-bin-md5sum-x86 "5e426f9a8bc6406722adaabc193b0b2b">
<!ENTITY openjdk-bin-size-x86 "162 MB">
<!ENTITY openjdk-bin-buildsize-x86 "487 MB">
<!ENTITY openjdk-download-binary-x64 "&anduin-download;/OpenJDK-&openjdk-version;-x86_64-bin.tar.xz">
<!ENTITY openjdk-bin-md5sum-x64 "476e1266ca2ba89e9f807d781a25546e">
<!ENTITY openjdk-bin-size-x64 "142 MB">
<!ENTITY openjdk-bin-buildsize-x64 "399 MB">
]>
<sect1 id="java" xreflabel="java-&openjdk-version;">
<?dbhtml filename="java.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Java-&openjdk-version;</title>
<indexterm zone="java">
<primary sortas="a-java">JDK Binary</primary>
</indexterm>
<sect2>
<title>About Java</title>
<para>Java is different from most of the packages in LFS and BLFS. It
is a programming language that works with files of byte codes to obtain
instructions and executes then in a Java Virtual Machine (JVM). An
introductory java program looks like:</para>
<screen><literal>public class HelloWorld
{
public static void main(String[] args)
{
System.out.println("Hello, World");
}
}</literal></screen>
<para>This program is saved as <filename>HelloWorld.java</filename>. The
file name, <emphasis>HelloWorld</emphasis>, must match the class name. It
is then converted into byte code with
<command>javac HelloWorld.java</command>. The output file is
<filename>HelloWorld.class</filename>. The program is executed with
<command>java HelloWorld</command>. This creates a JVM and runs the
code. The 'class' extension must not be specified.</para>
<para>Several class files can be combined into one file with the
<command>jar</command> command. This is similar to the standard
<command>tar</command> command. For instance, the command
<command>jar cf myjar.jar *.class</command> will combine all class files
in a directory into one jar file. These act as library files.</para>
<para>The JVM can search for and use classes in jar files automatically.
It uses the <envar>CLASSPATH</envar> environment variable to search for
jar files. This is a standard list of colon-separated directory names
similar to the <envar>PATH</envar> environment variable.</para>
</sect2>
<sect2 id="java-bin" xreflabel="Java Binary" role="package">
<title>Binary JDK Information</title>
<para>Creating a JVM from source requires a set of circular dependencies.
The first thing that's needed is a set of programs called a Java Development
Kit (JDK). This set of programs includes <command>java</command>,
<command>javac</command>, <command>jar</command>, and several others. It
also includes several base <emphasis>jar</emphasis> files.</para>
<para>To start, we set up a binary installation of the JDK created
by the BLFS editors. It is installed in the <filename>/opt</filename>
directory to allow for multiple installations, including a source based
version.</para>
&lfs75_checked;
<bridgehead renderas="sect3">Binary Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Binary download (x86):
<ulink url="&openjdk-download-binary-x86;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &openjdk-bin-md5sum-x86;</para>
</listitem>
<listitem>
<para>Download size (binary): &openjdk-bin-size-x86;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &openjdk-bin-buildsize-x86;</para>
</listitem>
</itemizedlist>
<itemizedlist spacing="compact">
<listitem>
<para>Binary download (x86_64):
<ulink url="&openjdk-download-binary-x64;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &openjdk-bin-md5sum-x64;</para>
</listitem>
<listitem>
<para>Download size (binary): &openjdk-bin-size-x64;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &openjdk-bin-buildsize-x64;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Java Binary Runtime Dependencies</bridgehead>
<para role="required">
<xref linkend="atk"/>,
<xref linkend="cairo"/>,
<xref linkend="cups"/>,
<xref linkend="gdk-pixbuf"/>,
<xref linkend="giflib"/>,
<xref linkend="gtk2"/>,
<xref linkend="lcms2"/>,
<xref linkend="pulseaudio"/>, and
<xref linkend="xorg7-lib"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of the Java BinaryJDK </title>
<para>Begin by extracting the appropriate binary tarball for your
architecture and changing to the extracted directory. Install the binary
<application>OpenJDK</application> with the following commands as the
<systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -vdm755 /opt/OpenJDK-&openjdk-version;-bin &amp;&amp;
mv -v * /opt/OpenJDK-&openjdk-version;-bin &amp;&amp;
chown -R root:root /opt/OpenJDK-&openjdk-version;-bin</userinput></screen>
<para>Configure the temporary <application>OpenJDK</application>
installation by issuing the following commands (note that if you logout
and login back before having definitely configured
<xref linkend='openjdk'/>, you'll have to issue them again):</para>
<screen><userinput>export CLASSPATH=.:/usr/share/java &amp;&amp;
export JAVA_HOME=/opt/OpenJDK-&openjdk-version;-bin &amp;&amp;
export PATH="$PATH:/opt/OpenJDK-&openjdk-version;-bin/bin"</userinput></screen>
<para> Do not forget to reboot or to source the profile file after
modification.</para>
<para>The binary version is now installed. If you don't want to compile the
sources, skip ahead to the <xref linkend='openjdk-config'/> section.
Otherwise, continue to the <xref linkend='junit'/>, <xref
linkend='apache-ant'/>, and <xref linkend='openjdk'/> sections.</para>
</sect2>
</sect1>