Package hudson.tools

Class JDKInstaller

java.lang.Object

hudson.tools.ToolInstaller

hudson.tools.JDKInstaller

All Implemented Interfaces:

ExtensionPoint, Describable<ToolInstaller>

public class JDKInstaller
extends ToolInstaller

Install JDKs from java.sun.com.

Since:

1.305

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	JDKInstaller.CPU	CPU type.
static final class	JDKInstaller.DescriptorImpl
static interface	JDKInstaller.FileSystem	Abstraction of the file system to perform JDK installation.
static final class	JDKInstaller.JDKFamily
static final class	JDKInstaller.JDKFamilyList
static final class	JDKInstaller.JDKFile
static final class	JDKInstaller.JDKList	JDK list.
static final class	JDKInstaller.JDKRelease
static enum	JDKInstaller.Platform	Supported platform.
static enum	JDKInstaller.Preference

Nested classes/interfaces inherited from class hudson.tools.ToolInstaller

ToolInstaller.ToolInstallerEntry, ToolInstaller.ToolInstallerList

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field	Description
final boolean	acceptLicense	We require that the user accepts the license by clicking a checkbox, to make up for the part that we auto-accept cds.sun.com license click through.
final String	id	The release ID that Sun assigns to each JDK, such as "jdk-6u13-oth-JPR@CDS-CDS_Developer"

Fields inherited from class hudson.tools.ToolInstaller

tool

Constructor Summary

Constructors

Constructor	Description
JDKInstaller(String id, boolean acceptLicense)

Method Summary

Modifier and Type	Method	Description
JDKInstaller.DescriptorImpl	getDescriptor()
void	install(Launcher launcher, JDKInstaller.Platform p, JDKInstaller.FileSystem fs, TaskListener log, String expectedLocation, String jdkBundle)	Performs the JDK installation to a system, provided that the bundle was already downloaded.
URL	locate(TaskListener log, JDKInstaller.Platform platform, JDKInstaller.CPU cpu)	Performs a license click through and obtains the one-time URL for downloading bits.
FilePath	performInstallation(ToolInstallation tool, Node node, TaskListener log)

Methods inherited from class hudson.tools.ToolInstaller

appliesTo, getLabel, preferredLocation, setTool

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

id

public final String id

The release ID that Sun assigns to each JDK, such as "jdk-6u13-oth-JPR@CDS-CDS_Developer"

This ID can be seen in the "ProductRef" query parameter of the download page, like https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=jdk-6u13-oth-JPR@CDS-CDS_Developer

acceptLicense

public final boolean acceptLicense

We require that the user accepts the license by clicking a checkbox, to make up for the part that we auto-accept cds.sun.com license click through.

Constructor Details

JDKInstaller

@DataBoundConstructor
public JDKInstaller(String id,
 boolean acceptLicense)

Method Details

performInstallation

public FilePath performInstallation(ToolInstallation tool,
 Node node,
 TaskListener log)
                             throws IOException,
InterruptedException

Specified by:

performInstallation in class ToolInstaller

Throws:

IOException

InterruptedException

install

public void install(Launcher launcher,
 JDKInstaller.Platform p,
 JDKInstaller.FileSystem fs,
 TaskListener log,
 String expectedLocation,
 String jdkBundle)
             throws IOException,
InterruptedException

Performs the JDK installation to a system, provided that the bundle was already downloaded.

Parameters:

launcher - Used to launch processes on the system.

p - Platform of the system. This determines how the bundle is installed.

fs - Abstraction of the file system manipulation on this system.

log - Where the output from the installation will be written.

expectedLocation - Path to install JDK to. Must be absolute and in the native file system notation.

jdkBundle - Path to the installed JDK bundle. (The bundle to download can be determined by locate(TaskListener, Platform, CPU) call.)

Throws:

IOException

InterruptedException

locate

public URL locate(TaskListener log,
 JDKInstaller.Platform platform,
 JDKInstaller.CPU cpu)
           throws IOException

Performs a license click through and obtains the one-time URL for downloading bits.

Throws:

IOException

getDescriptor

public JDKInstaller.DescriptorImpl getDescriptor()

Specified by:

getDescriptor in interface Describable<ToolInstaller>

Overrides:

getDescriptor in class ToolInstaller