<change id="CustomPlatformInstall">

            <api name="general"/>

            <summary>Added new CustomPlatformInstall implemented by the platform installers which does not use the file chooser to select new platform</summary>

            <version major="1" minor="5"/>

            <date day="27" month="7" year="2005"/>

            <author login="tzezula"/>

            <compatibility addition="yes"/>

            <description>

                <p>

                There are some platform installers which does not use the local disk as source of the java platform,

                for example they download the java platform from the web. Such installers cannot use the current

                PlatformInstall which is file oriented. The CustomPlatformInstall allows to platform install

                provider to implement its own way of installing the new platform. The PlatformInstall is still supported.

                If the module provides the PlatformInstall in the global lookup, the java platform module does the

                java platform chooser for it, the behavior is not changed. If the module provides the CustomPlatformInstall

                in the global lookup, it has to do the platform selection by itself.

                </p>

            </description>

            <class package="org.netbeans.spi.java.platform" name="CustomPlatformInstall"/>

            <issue number="61475"/>

        </change>

/*

 *                 Sun Public License Notice

 * 

 * The contents of this file are subject to the Sun Public License

 * Version 1.0 (the "License"). You may not use this file except in

 * compliance with the License. A copy of the License is available at

 * http://www.sun.com/

 * 

 * The Original Code is NetBeans. The Initial Developer of the Original

 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun

 * Microsystems, Inc. All Rights Reserved.

 */

package org.netbeans.spi.java.platform;

import org.openide.WizardDescriptor;

/**

 * Defines an API for registering custom Java platform installer. The installer

 * is responsible for instantiation of {@link JavaPlatform} through the provided

 * TemplateWizard.Iterator. If your installer selects the platform on the local disk you 

 * probably don't want to use this class, the {@link PlatformInstall} class

 * creates an platform chooser for you. You want to use this class if the 

 * platform is not on the local disk, eg. you want to download it from the web.

 * @author Tomas Zezula

 * @since 1.5

 */

public abstract class CustomPlatformIntall {

    /**

     * Returns the {@link WizardDescriptor#InstantiatingIterator} used to install

     * the platform.

     * @return TemplateWizard.Iterator instance responsible for instantiating

     * the platform. The instantiate method of the returned iterator should

     * return the Set containing the created JavaPlatform.

     */

    public abstract WizardDescriptor.InstantiatingIterator createIterator();

    /**

     * Returns the diaply name of the platform installer

     * @return String, the diaplay name

     */

    public abstract String getDisplayName ();

}