<change id="CompositeCategoryProvider">

            <api name="general"/>

            <summary>Ability to construct a project customizer from panels declared in layers.</summary>

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

            <date day="11" month="4" year="2006"/>

            <author login="mkleint"/>

            <compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible">

            </compatibility>

            <description>

                Added <code>createCustomizerDialog(String, Lookup, String, ActionListener, HelpCtx)</code> method to ProjectCustomizer.

                That allows to construct project customizer from a layer folder content. It assumes to find instances of

                <code>ProjectCustomizer.CompositeCategoryProvider</code>in the layer and constructs the UI from them.

                The context is passed into the panel via a Lookup instance. What is in the lookup, is up to the individual project

                implementations.

            </description>

            <class package="org.netbeans.spi.project.ui.support" name="ProjectCustomizer"/>

            <issue number="74373"/>

        </change>

import java.io.IOException;

import java.util.ArrayList;

import java.util.Collections;

import java.util.HashMap;

import java.util.List;

import java.util.logging.Level;

import java.util.logging.Logger;

import org.openide.cookies.InstanceCookie;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileStateInvalidException;

import org.openide.filesystems.Repository;

import org.openide.loaders.DataFolder;

import org.openide.loaders.DataObject;

import org.openide.util.Lookup;

    /**

     * Creates standard customizer dialog that can be used for implementation of

     * {@link org.netbeans.spi.project.ui.CustomizerProvider} based on content of a folder in Layers.

     * Use this method when you want to allow composition and 3rd party additions to your customizer UI.

     * You don't need to call <code>pack()</code> method on the dialog. The resulting dialog will

     * be non-modal. <br> 

     * Call <code>show()</code> on the dialog to make it visible. If you want the dialog to be

     * closed after user presses the "OK" button you have to call hide() and dispose() on it.

     * (Usually in the <code>actionPerformed(...)</code> method of the listener

     * you provided as a parameter. In case of the click on the "Cancel" button

     * the dialog will be closed automatically.

     * @param folderPath the path in the System Filesystem that is used as root for panel composition.

     *        The content of the folder is assummed to be {@link org.netbeans.spi.project.ui.support.ProjectCustomizer.CompositeCategoryProvider} instances

     * @param context the context for the panels, up to the project type what the context shall be, for example org.netbeans.api.project.Project instance

     * @param preselectedCategory name of one of the supplied categories or null.

     *        Category with given name will be selected. If  <code>null</code>

     *        or if the category of given name does not exist the first category will

     *        be selected.

     * @param okOptionListener listener which will be notified when the user presses

     *        the OK button.

     * @param helpCtx Help context for the dialog, which will be used when the

     *        panels in the customizer do not specify their own help context.

     * @return standard project customizer dialog.

     */

    public static Dialog createCustomizerDialog( String folderPath,

                                                 Lookup context,

                                                 String preselectedCategory,

                                                 ActionListener okOptionListener,

                                                 HelpCtx helpCtx) {

        FileObject root = Repository.getDefault().getDefaultFileSystem().findResource(folderPath);

        if (root == null) {

            throw new IllegalArgumentException("The designated path " + folderPath + " doesn't exist. Cannot create customizer.");

        }

        DataFolder def = DataFolder.findFolder(root);

        assert def != null : "Cannot find DataFolder for " + folderPath;

        DelegateCategoryProvider prov = new DelegateCategoryProvider(def, context);

        return createCustomizerDialog(prov.getSubCategories(),

                                      prov,

                                      preselectedCategory, okOptionListener, helpCtx);

    }

    /**

     * Interface for creation of Customizer categories and their respective UI panels.

     * Implementations are to be registered in System FileSystem via module layers. Used by the

     * {@link org.netbeans.spi.project.ui.support.ProjectCustomizer#createCustomizerDialog(String,Lookup,String,ActionListener,HelpCtx)}

     */

    public static interface CompositeCategoryProvider {

        /**

         * create the Category instance for the given project customizer context.

         */

        Category createCategory( Lookup context );

        /**

         * create the UI component for given category and context.

         */

        JComponent createComponent (Category category, Lookup context );

    }