Index: apichanges.xml =================================================================== RCS file: /cvs/java/platform/apichanges.xml,v --- apichanges.xml 27 Jun 2005 22:22:36 -0000 1.3 +++ apichanges.xml 27 Jul 2005 16:39:20 -0000 @@ -76,6 +76,27 @@ + + + Added new CustomPlatformInstall implemented by the platform installers which does not use the file chooser to select new platform + + + + + +

+ 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. +

+
+ + +
Switched to major release version 1 Index: manifest.mf =================================================================== RCS file: /cvs/java/platform/manifest.mf,v --- manifest.mf 6 Apr 2005 00:06:47 -0000 1.7 +++ manifest.mf 27 Jul 2005 16:39:20 -0000 @@ -1,6 +1,6 @@ Manifest-Version: 1.0 OpenIDE-Module: org.netbeans.modules.java.platform/1 -OpenIDE-Module-Specification-Version: 1.4 +OpenIDE-Module-Specification-Version: 1.5 OpenIDE-Module-Localizing-Bundle: org/netbeans/modules/java/platform/Bundle.properties OpenIDE-Module-Layer: org/netbeans/modules/java/platform/resources/layer.xml Index: src/org/netbeans/spi/java/platform/CustomPlatformIntall.java =================================================================== RCS file: src/org/netbeans/spi/java/platform/CustomPlatformIntall.java --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ src/org/netbeans/spi/java/platform/CustomPlatformIntall.java 27 Jul 2005 16:39:21 -0000 @@ -0,0 +1,47 @@ +/* + * 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 (); + +}