<change id="source-javadoc-attacher">

            <api name="queries"/>

            <summary>Added SourceJavadocAttacher to allow clients to attach source (javadoc) roots to binary root</summary>

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

            <date day="11" month="8" year="2011"/>

            <author login="tzezula"/>

            <compatibility addition="yes" semantic="compatible" source="compatible" binary="compatible"/>

            <description>

                <p>

                    Added an API to allow clients to attach source roots and javadoc roots to binary roots.

                    The API delegates to SPI implementations which provide specific behavior depending on

                    type of binary root (platform, library, maven artifact). There is also fallback implementation

                    handling unknown binary roots by storing the bindings into IDE's userdir.

                </p>

            </description>

            <class package="org.netbeans.api.java.queries" name="SourceJavadocAttacher" />

            <class package="org.netbeans.spi.java.queries" name="SourceJavadocAttacherImplementation" />

            <issue number="47498"/>

        </change>

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.api.java.queries;

import java.io.IOException;

import java.net.URL;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.spi.java.queries.SourceJavadocAttacherImplementation;

import org.openide.util.Exceptions;

import org.openide.util.Lookup;

import org.openide.util.Parameters;

/**

 * A support for attaching source roots and javadoc roots to binary roots.

 * @author Tomas Zezula

 * @since 1.35

 */

public final class SourceJavadocAttacher {

    private SourceJavadocAttacher() {}

    /**

     * Attaches a source root provided by the SPI {@link SourceJavadocAttacherImplementation}

     * to given binary root.

     * @param root the binary root to attach sources to

     * @param a listener notified about result when attaching is done

     */

    public static void attachSources(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) {

            attach(root, listener, 0);

    }

    /**

     * Attaches a javadoc root provided by the SPI {@link SourceJavadocAttacherImplementation}

     * to given binary root.

     * @param root the binary root to attach javadoc to

     * @param a listener notified about result  when attaching is done

     */

    public static void attachJavadoc(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) {

            attach(root, listener, 1);

    }

    /**

     * Listener notified by {@link SourceJavadocAttacher} about a result

     * of attaching source (javadoc) to binary root.

     */

    public interface AttachmentListener {

        /**

         * Invoked when the source (javadoc) was successfully attached to

         * binary root.

         */

        void attachmentSucceeded();

        /**

         * Invoked when the source (javadoc) was not attached to

         * binary root. The attaching either failed or was canceled by user.

         */

        void attachmentFailed();

    }

    private static void attach(

            final URL root,

            final AttachmentListener listener,

            final int mode) {

        Parameters.notNull("root", root);   //NOI18N

        try {

            for (SourceJavadocAttacherImplementation attacher : Lookup.getDefault().lookupAll(SourceJavadocAttacherImplementation.class)) {

                final boolean handles  = mode == 0 ?

                    attacher.attachSources(root, listener) :

                    attacher.attachJavadoc(root, listener);

                if (handles) {

                    return;

                }

            }

        } catch (IOException ioe) {

            Exceptions.printStackTrace(ioe);

        }

        if (listener != null) {

            listener.attachmentFailed();

        }

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.spi.java.queries;

import java.io.IOException;

import java.net.URL;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.api.java.queries.SourceJavadocAttacher;

import org.openide.util.Lookup;

import org.openide.util.lookup.ServiceProvider;

/**

 * A SPI for attaching source roots and javadoc roots to binary roots.

 * The implementations of this interface are registered in global {@link Lookup}

 * @see ServiceProvider

 * @author Tomas Zezula

 * @since 1.35

 */

public interface SourceJavadocAttacherImplementation {

    /**

     * Attaches a source root provided by this SPI to given binary root.

     * @param root the binary root to attach sources to

     * @param a listener notified about result when attaching is done

     * @throws IOException in case of error

     */

    boolean attachSources(

            @NonNull URL root,

            @NullAllowed SourceJavadocAttacher.AttachmentListener listener) throws IOException;

    /**

     * Attaches a javadoc root provided by this SPI to given binary root.

     * @param root the binary root to attach javadoc to

     * @param a listener notified about result when attaching is done

     * @throws IOException in case of error

     */

    boolean attachJavadoc(

            @NonNull URL root,

            @NullAllowed SourceJavadocAttacher.AttachmentListener listener) throws IOException;

}

                    <code-name-base>org.netbeans.api.annotations.common</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                    <run-dependency>

                        <release-version>1</release-version>

                        <specification-version>1.10</specification-version>

                    </run-dependency>

                </dependency>

                <dependency>

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.libraries;

import java.io.File;

import java.io.IOException;

import java.net.URI;

import java.net.URISyntaxException;

import java.net.URL;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.concurrent.Callable;

import java.util.concurrent.Future;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.api.java.queries.SourceJavadocAttacher.AttachmentListener;

import org.netbeans.api.project.libraries.Library;

import org.netbeans.api.project.libraries.LibraryManager;

import org.netbeans.modules.java.j2seplatform.queries.SourceJavadocAttacherUtil;

import org.netbeans.spi.java.queries.SourceJavadocAttacherImplementation;

import org.openide.util.Exceptions;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=SourceJavadocAttacherImplementation.class, position=151)

public class J2SELibrarySourceJavadocAttacher implements SourceJavadocAttacherImplementation {

    @Override

    public boolean attachSources(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) throws IOException {

        return attach(root, listener, J2SELibraryTypeProvider.VOLUME_TYPE_SRC);

    }

    @Override

    public boolean attachJavadoc(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) throws IOException {

        return attach(root, listener, J2SELibraryTypeProvider.VOLUME_TYPE_JAVADOC);

    }

    private boolean attach(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener,

            @NonNull final String volume) {

        final Pair<LibraryManager,Library> pair = findOwner(root);

        if (pair == null) {

            return false;

        }

        final Runnable call = new Runnable() {

            @Override

            public void run() {

                final LibraryManager lm = pair.first;

                final Library lib = pair.second;

                assert lm != null;

                assert lib != null;

                boolean success = false;

                try {

                    final URL areaLocation = lm.getLocation();

                    final File baseFolder = areaLocation == null ? null : new File(areaLocation.toURI()).getParentFile();

                    final List<? extends URI> selected;

                    if (volume == J2SELibraryTypeProvider.VOLUME_TYPE_SRC) {

                        selected = SourceJavadocAttacherUtil.selectSources(

                            root,

                            new SelectFolder(volume, lib.getName(), baseFolder),

                            new Convertor(volume, baseFolder));

                    } else if (volume == J2SELibraryTypeProvider.VOLUME_TYPE_JAVADOC) {

                        selected = SourceJavadocAttacherUtil.selectJavadoc(

                            root,

                            new SelectFolder(volume, lib.getName(), baseFolder),

                            new Convertor(volume, baseFolder));

                    } else {

                        throw new IllegalStateException();

                    }

                    if (selected != null) {

                        final String name = lib.getName();

                        final String displayName = lib.getDisplayName();

                        final String desc = lib.getDescription();

                        final Map<String,List<URI>> volumes = new HashMap<String, List<URI>>();

                        for (String currentVolume : J2SELibraryTypeProvider.VOLUME_TYPES) {

                            List<URI> content = lib.getURIContent(currentVolume);

                            if (volume == currentVolume) {

                                final List<URI> newContent = new ArrayList<URI>(content.size()+selected.size());

                                newContent.addAll(content);

                                newContent.addAll(selected);

                                content = newContent;

                            }

                            volumes.put(currentVolume,content);

                        }

                        lm.removeLibrary(lib);

                        lm.createURILibrary(

                            J2SELibraryTypeProvider.LIBRARY_TYPE,

                            name,

                            displayName,

                            desc,

                            volumes);

                        success = true;

                    }

                } catch (IOException ioe) {

                    Exceptions.printStackTrace(ioe);

                } catch (URISyntaxException use) {

                    Exceptions.printStackTrace(use);

                } finally {

                    SourceJavadocAttacherUtil.callListener(listener, success);

                }

            }

        };

        SourceJavadocAttacherUtil.scheduleInEDT(call);

        return true;

    }

    private Pair<LibraryManager,Library> findOwner(final URL root) {

        for (LibraryManager lm : LibraryManager.getOpenManagers()) {

            for (Library l : lm.getLibraries()) {

                if (!J2SELibraryTypeProvider.LIBRARY_TYPE.equals(l.getType())) {

                    continue;

                }

                final List<URL> cp = l.getContent(J2SELibraryTypeProvider.VOLUME_TYPE_CLASSPATH);

                if (cp.contains(root)) {

                    return Pair.<LibraryManager,Library>of(lm, l);

                }

            }

        }

        return null;

    }

    private static class Pair<F,S> {

        public final F first;

        public final S second;

        private Pair(F first, S second) {

            this.first = first;

            this.second = second;

        }

        public static <F,S> Pair<F,S> of(F first, S second) {

            return new Pair<F,S>(first,second);

        }

    }

    private static class SelectFolder implements Callable<List<? extends String>> {

        private final String volume;

        private final String libName;

        private final File baseFolder;

        private SelectFolder(

                @NonNull final String volume,

                @NonNull final String libName,

                @NullAllowed final File baseFolder) {

            this.volume = volume;

            this.libName = libName;

            this.baseFolder = baseFolder;

        }

        @Override

        public List<? extends String> call() throws Exception {

            final String[] paths = J2SEVolumeCustomizer.select(

                volume,

                libName,

                new File[1],

                null,

                baseFolder);

            return paths == null ? null : Arrays.<String>asList(paths);

        }

    }

    private static class Convertor implements SourceJavadocAttacherUtil.Function<String, URI> {

        private final String volume;

        private final File baseFolder;

        private Convertor(

                @NonNull final String volume,

                @NullAllowed final File baseFolder) {

            this.volume = volume;

            this.baseFolder = baseFolder;

        }

        @Override

        public URI call(String param) throws Exception {

            return J2SEVolumeCustomizer.pathToURI(baseFolder, param, volume);

        }

    }

}

import java.util.ArrayList;

import java.util.List;

import org.netbeans.api.annotations.common.CheckForNull;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

    @CheckForNull

    static String[] select(

            @NonNull final String volumeType,

            @NonNull final String libName,

            @NonNull final File[] lastFolder,

            @NullAllowed final Component owner,

            @NullAllowed final File baseFolder) {

        assert volumeType != null;

        assert lastFolder != null;

        assert lastFolder.length == 1;

        final File libFolder = baseFolder == null ?

            null:

            FileUtil.normalizeFile(new File(baseFolder, libName));

        FileChooser chooser = new FileChooser(baseFolder, libFolder);

        // for now variable based paths are disabled in library definition

        // can be revisit if it is needed

        chooser.setFileHidingEnabled(false);

        chooser.setAcceptAllFileFilterUsed(false);

        if (volumeType.equals(J2SELibraryTypeProvider.VOLUME_TYPE_CLASSPATH)) {

            chooser.setMultiSelectionEnabled (true);

            chooser.setDialogTitle(NbBundle.getMessage(J2SEVolumeCustomizer.class,"TXT_OpenClasses"));

            chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

            chooser.setFileFilter (new ArchiveFileFilter(NbBundle.getMessage(

                    J2SEVolumeCustomizer.class,"TXT_Classpath"),new String[] {"ZIP","JAR"}));   //NOI18N

            chooser.setApproveButtonText(NbBundle.getMessage(J2SEVolumeCustomizer.class,"CTL_SelectCP"));

            chooser.setApproveButtonMnemonic(NbBundle.getMessage(J2SEVolumeCustomizer.class,"MNE_SelectCP").charAt(0));

        } else if (volumeType.equals(J2SELibraryTypeProvider.VOLUME_TYPE_JAVADOC)) {

            chooser.setMultiSelectionEnabled (true);

            chooser.setDialogTitle(NbBundle.getMessage(J2SEVolumeCustomizer.class,"TXT_OpenJavadoc"));

            chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

            chooser.setFileFilter (new ArchiveFileFilter(NbBundle.getMessage(

                    J2SEVolumeCustomizer.class,"TXT_Javadoc"),new String[] {"ZIP","JAR"}));     //NOI18N

            chooser.setApproveButtonText(NbBundle.getMessage(J2SEVolumeCustomizer.class,"CTL_SelectJD"));

            chooser.setApproveButtonMnemonic(NbBundle.getMessage(J2SEVolumeCustomizer.class,"MNE_SelectJD").charAt(0));

        } else if (volumeType.equals(J2SELibraryTypeProvider.VOLUME_TYPE_SRC)) {

            chooser.setMultiSelectionEnabled (true);

            chooser.setDialogTitle(NbBundle.getMessage(J2SEVolumeCustomizer.class,"TXT_OpenSources"));

            chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

            chooser.setFileFilter (new ArchiveFileFilter(NbBundle.getMessage(

                    J2SEVolumeCustomizer.class,"TXT_Sources"),new String[] {"ZIP","JAR"}));     //NOI18N

            chooser.setApproveButtonText(NbBundle.getMessage(J2SEVolumeCustomizer.class,"CTL_SelectSRC"));

            chooser.setApproveButtonMnemonic(NbBundle.getMessage(J2SEVolumeCustomizer.class,"MNE_SelectSRC").charAt(0));

        }

        if (lastFolder[0] != null) {

            chooser.setCurrentDirectory (lastFolder[0]);

        } else if (baseFolder != null) {

            chooser.setCurrentDirectory (baseFolder);

        }

        if (chooser.showOpenDialog(owner) == JFileChooser.APPROVE_OPTION) {

            try {

                lastFolder[0] = chooser.getCurrentDirectory();

                return chooser.getSelectedPaths();

            } catch (MalformedURLException mue) {

                Exceptions.printStackTrace(mue);

            } catch (IOException ex) {

                Exceptions.printStackTrace(ex);

            }

        }

        return null;

    }

    static URI pathToURI(

            final File baseFolder,

            final String fileName,

            final String volume) throws MalformedURLException, URISyntaxException {

        File f = new File(fileName);

        URI uri = LibrariesSupport.convertFilePathToURI(fileName);

        if (baseFolder != null) {

            File realFile = f;

            if (!f.isAbsolute()) {

                    realFile = FileUtil.normalizeFile(new File(

                        baseFolder, f.getPath()));

            }

            String jarPath = checkFile(realFile, volume);

            if (FileUtil.isArchiveFile(realFile.toURI().toURL())) {

                uri = LibrariesSupport.getArchiveRoot(uri);

                if (jarPath != null) {

                    assert uri.toString().endsWith("!/") : uri.toString(); //NOI18N

                    uri = URI.create(uri.toString() + encodePath(jarPath));

                }

            } else if (!uri.toString().endsWith("/")){ //NOI18N

                try {

                    uri = new URI(uri.toString()+"/"); //NOI18N

                } catch (URISyntaxException ex) {

                    throw new AssertionError(ex);

                }

            }

            return uri;

        } else {

            assert f.isAbsolute() : f.getPath();

            f = FileUtil.normalizeFile (f);

            String jarPath = checkFile(f, volume);

            uri = f.toURI();

            if (FileUtil.isArchiveFile(uri.toURL())) {

                uri = LibrariesSupport.getArchiveRoot(uri);

                if (jarPath != null) {

                    assert uri.toString().endsWith("!/") : uri.toString(); //NOI18N

                    uri = URI.create(uri.toString() + encodePath(jarPath));

                }

            } else if (!uri.toString().endsWith("/")){ //NOI18N

                uri = URI.create(uri.toString()+"/"); //NOI18N

            }

            return uri;

        }

    }

            return false;

    boolean isBroken () {

        if (getInstallFolders().isEmpty()) {

            return true;

        }

        for (String tool : PlatformConvertor.IMPORTANT_TOOLS) {

            if (findTool(tool) == null) {

                return true;

            }

        }

        return false;

    }

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.platformdefinition;

import java.io.File;

import java.io.IOException;

import java.net.MalformedURLException;

import java.net.URI;

import java.net.URL;

import java.util.List;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.api.java.classpath.ClassPath;

import org.netbeans.api.java.platform.JavaPlatform;

import org.netbeans.api.java.platform.JavaPlatformManager;

import org.netbeans.api.java.platform.Specification;

import org.netbeans.api.java.queries.SourceJavadocAttacher.AttachmentListener;

import org.netbeans.modules.java.j2seplatform.queries.SourceJavadocAttacherUtil;

import org.netbeans.spi.java.queries.SourceJavadocAttacherImplementation;

import org.openide.util.Exceptions;

import org.openide.util.NbBundle;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=SourceJavadocAttacherImplementation.class,position=150)

public class J2SEPlatformSourceJavadocAttacher implements SourceJavadocAttacherImplementation {

    @Override

    public boolean attachSources(

            @NonNull final URL root,

            @NullAllowed AttachmentListener listener) throws IOException {

        return attach(root, listener, J2SEPlatformCustomizer.SOURCES);

    }

    @Override

    public boolean attachJavadoc(

            @NonNull final URL root,

            @NullAllowed AttachmentListener listener) throws IOException {

        return attach(root, listener, J2SEPlatformCustomizer.JAVADOC);

    }

    @NbBundle.Messages({

        "TXT_Title=Browse ZIP/Folder",

        "TXT_JavadocFilterName=Library Javadoc (folder, ZIP or JAR file)",

        "TXT_SourcesFilterName=Library Sources (folder, ZIP or JAR file)"

    })

    private boolean attach(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener,

            final int mode) {

        final J2SEPlatformImpl platform = findOwner(root);

        if (platform == null) {

            return false;

        }

        final Runnable call = new Runnable() {

            @Override

            public void run() {

                boolean success = false;

                try {

                    final List<? extends URI> selected;

                    if (mode == J2SEPlatformCustomizer.SOURCES) {

                        selected = SourceJavadocAttacherUtil.selectSources(

                            root,

                            SourceJavadocAttacherUtil.createDefaultBrowseCall(

                                Bundle.TXT_Title(),

                                Bundle.TXT_SourcesFilterName(),

                                new File[1]),

                            SourceJavadocAttacherUtil.createDefaultURIConvertor(true));

                    } else if (mode == J2SEPlatformCustomizer.JAVADOC) {

                        selected = SourceJavadocAttacherUtil.selectJavadoc(

                            root,

                            SourceJavadocAttacherUtil.createDefaultBrowseCall(

                                Bundle.TXT_Title(),

                                Bundle.TXT_JavadocFilterName(),

                                new File[1]),

                            SourceJavadocAttacherUtil.createDefaultURIConvertor(false));

                    } else {

                        throw new IllegalStateException(Integer.toString(mode));

                    }

                    if (selected != null) {

                        final J2SEPlatformCustomizer.PathModel model = new J2SEPlatformCustomizer.PathModel(platform, mode);

                        try {

                            for (URI uri : selected) {

                                model.addPath(uri.toURL());

                            }

                            success = true;

                        } catch (MalformedURLException e) {

                            Exceptions.printStackTrace(e);

                        }

                    }

                } finally {

                    SourceJavadocAttacherUtil.callListener(listener, success);

                }

            }

        };

        SourceJavadocAttacherUtil.scheduleInEDT(call);

        return true;

    }

    private J2SEPlatformImpl findOwner(final URL root) {

        for (JavaPlatform p : JavaPlatformManager.getDefault().getPlatforms(null, new Specification(J2SEPlatformImpl.PLATFORM_J2SE, null))) {

            if (!(p instanceof J2SEPlatformImpl)) {

                //Cannot handle unknown platform

                continue;

            }

            final J2SEPlatformImpl j2sep = (J2SEPlatformImpl) p;

            if (j2sep.isBroken()) {

                continue;

            }

            for (ClassPath.Entry entry : j2sep.getBootstrapLibraries().entries()) {

                if (root.equals(entry.getURL())) {

                    return j2sep;

                }

            }

        }

        return null;

    }

}

TXT_LocalJavadoc=&Local Javadoc:

TXT_RemoteJavadoc=&Remote Javadoc URL:

TXT_Browse=&Browse

TXT_AttachJavadocTo=Attach Javadoc to "{0}"

TXT_AttachSourcesTo=Attach Sources to "{0}"

TXT_LocalSources=Sources:

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.queries;

import java.net.URL;

import java.util.Map;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.java.queries.JavadocForBinaryQuery;

import org.netbeans.api.java.queries.JavadocForBinaryQuery.Result;

import org.netbeans.spi.java.queries.JavadocForBinaryQueryImplementation;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=JavadocForBinaryQueryImplementation.class) //position = last

public class DefaultJavadocForBinaryQuery implements JavadocForBinaryQueryImplementation {

    @Override

    public Result findJavadoc(@NonNull final URL binaryRoot) {

        final Map<URL,? extends JavadocForBinaryQuery.Result> mapping = QueriesCache.getJavadoc().getRoots();

        return mapping.get(binaryRoot);

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.queries;

import java.net.URL;

import java.util.Map;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.java.queries.SourceForBinaryQuery;

import org.netbeans.spi.java.queries.SourceForBinaryQueryImplementation2;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=SourceForBinaryQueryImplementation2.class) //position = last

public class DefaultSourceForBinaryQuery implements SourceForBinaryQueryImplementation2 {

    @Override

    public Result findSourceRoots2(@NonNull final URL binaryRoot) {

        final Map<URL,? extends Result> mapping = QueriesCache.getSources().getRoots();

        return mapping.get(binaryRoot);

    }

    @Override

    public SourceForBinaryQuery.Result findSourceRoots(URL binaryRoot) {

        return findSourceRoots2(binaryRoot);

    }

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.queries;

import java.io.File;

import java.io.IOException;

import java.net.MalformedURLException;

import java.net.URI;

import java.net.URL;

import java.util.List;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.annotations.common.NullAllowed;

import org.netbeans.api.java.queries.SourceJavadocAttacher.AttachmentListener;

import org.netbeans.spi.java.queries.SourceJavadocAttacherImplementation;

import org.openide.filesystems.FileStateInvalidException;

import org.openide.util.Exceptions;

import org.openide.util.NbBundle;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

@ServiceProvider(service=SourceJavadocAttacherImplementation.class) //position=last

public class DefaultSourceJavadocAttacher implements SourceJavadocAttacherImplementation {

    @Override

    public boolean attachSources(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) throws IOException {

        return attach(root, listener, 0);

    }

    @Override

    public boolean attachJavadoc(

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener) throws IOException {

        return attach(root, listener, 1);

    }

    private boolean attach (

            @NonNull final URL root,

            @NullAllowed final AttachmentListener listener,

            final int mode) throws IOException {

        final Runnable call = new Runnable() {

            @Override

            public void run() {

                boolean success = false;

                try {

                    final URL[] toAttach = selectRoots(root, mode);

                    if (toAttach != null) {

                        switch (mode) {

                            case 0:

                                QueriesCache.getSources().updateRoot(root, toAttach);

                                break;

                            case 1:

                                QueriesCache.getJavadoc().updateRoot(root, toAttach);

                                break;

                            default:

                                throw new IllegalArgumentException(Integer.toString(mode));

                        }

                        success = true;

                    }

                } catch (MalformedURLException e) {

                    Exceptions.printStackTrace(e);

                } catch (FileStateInvalidException e) {

                    Exceptions.printStackTrace(e);

                } finally {

                    SourceJavadocAttacherUtil.callListener(listener,success);

                }

            }

        };

        SourceJavadocAttacherUtil.scheduleInEDT(call);

        return true;

    }

    @NbBundle.Messages({

        "TXT_Title=Browse ZIP/Folder",

        "TXT_Javadoc=Library Javadoc (folder, ZIP or JAR file)",

        "TXT_Sources=Library Sources (folder, ZIP or JAR file)"

    })

    private static URL[] selectRoots(final URL root, final int mode) throws MalformedURLException, FileStateInvalidException {

        final File[] cfh = new File[]{currentFolder};

        final List<? extends URI> selected;

        if (mode == 0) {

            selected = SourceJavadocAttacherUtil.selectSources(

                root,

                SourceJavadocAttacherUtil.createDefaultBrowseCall(

                    Bundle.TXT_Title(),

                    Bundle.TXT_Sources(),

                    cfh),

                SourceJavadocAttacherUtil.createDefaultURIConvertor(true));

        } else if (mode == 1) {

            selected = SourceJavadocAttacherUtil.selectJavadoc(

                root,

                SourceJavadocAttacherUtil.createDefaultBrowseCall(

                    Bundle.TXT_Title(),

                    Bundle.TXT_Javadoc(),

                    cfh),

                SourceJavadocAttacherUtil.createDefaultURIConvertor(false));

        } else {

            throw new IllegalStateException(Integer.toString(mode));

        }

        if (selected == null) {

            return null;

        }

        currentFolder = cfh[0];

        final URL[] result = new URL[selected.size()];

        for (int i=0; i< result.length; i++) {

            result[i] = selected.get(i).toURL();

        }

        return result;

    }

    private static File currentFolder;

}

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2011 Oracle and/or its affiliates. All rights reserved.

 *

 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.

 * Other names may be trademarks of their respective owners.

 *

 * The contents of this file are subject to the terms of either the GNU

 * General Public License Version 2 only ("GPL") or the Common

 * Development and Distribution License("CDDL") (collectively, the

 * "License"). You may not use this file except in compliance with the

 * License. You can obtain a copy of the License at

 * http://www.netbeans.org/cddl-gplv2.html

 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the

 * specific language governing permissions and limitations under the

 * License.  When distributing the software, include this License Header

 * Notice in each file and include the License file at

 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the GPL Version 2 section of the License file that

 * accompanied this code. If applicable, add the following below the

 * License Header, with the fields enclosed by brackets [] replaced by

 * your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * If you wish your version of this file to be governed by only the CDDL

 * or only the GPL Version 2, indicate your decision by adding

 * "[Contributor] elects to include this software in this distribution

 * under the [CDDL or GPL Version 2] license." If you do not indicate a

 * single choice of license, a recipient has the option to distribute

 * your version of this file under either the CDDL, the GPL Version 2 or

 * to extend the choice of license to its licensees as provided above.

 * However, if you add GPL Version 2 code and therefore, elected the GPL

 * Version 2 license, then the option applies only if the new code is

 * made subject to such option by the copyright holder.

 *

 * Contributor(s):

 *

 * Portions Copyrighted 2011 Sun Microsystems, Inc.

 */

package org.netbeans.modules.java.j2seplatform.queries;

import java.net.MalformedURLException;

import java.net.URL;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.Collection;

import java.util.Collections;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.prefs.BackingStoreException;

import java.util.prefs.Preferences;

import javax.swing.event.ChangeListener;

import org.netbeans.api.annotations.common.NonNull;

import org.netbeans.api.java.queries.JavadocForBinaryQuery;

import org.netbeans.spi.java.queries.SourceForBinaryQueryImplementation2;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.URLMapper;

import org.openide.util.ChangeSupport;

import org.openide.util.Exceptions;

import org.openide.util.NbPreferences;

/**

 *

 * @author Tomas Zezula

 */

final class QueriesCache<T extends QueriesCache.ResultBase> {

    private static QueriesCache<Javadoc> javadoc;

    private static QueriesCache<Sources> sources;

    private static final char SEP = '-';  //NOI18N

    private final Object lck = new Object();

    private final Class<T> clazz;

    //@GuardedBy("lck")

    private Map<URL,T> cache;

    private QueriesCache(@NonNull final Class<T> clazz){

        assert clazz != null;

        this.clazz = clazz;

    }

    @NonNull

    Map<URL,? extends T> getRoots() {

        return Collections.unmodifiableMap(loadRoots());

    }

    void updateRoot(final URL binaryRoot, final URL... rootsToAttach) {

        T currentMapping = null;

        synchronized (lck) {

            final Map<URL,T> currentRoots = loadRoots();

            currentMapping = currentRoots.get(binaryRoot);

            final Preferences root = NbPreferences.forModule(QueriesCache.class);

            final Preferences node = root.node(clazz.getSimpleName());

            final String binaryRootStr = binaryRoot.toExternalForm();

            try {

                for (String key : filterKeys(node.keys(),binaryRootStr)) {

                    node.remove(key);

                }

                for (int i=0; i < rootsToAttach.length; i++) {

                    node.put(String.format("%s-%d",binaryRootStr,i), rootsToAttach[i].toExternalForm());

                }

                node.flush();

            } catch (BackingStoreException bse) {

                Exceptions.printStackTrace(bse);

            }

            if (currentMapping == null) {

                try {

                    currentMapping = clazz.newInstance();

                    currentRoots.put(binaryRoot, currentMapping);

                } catch (InstantiationException ie) {

                    Exceptions.printStackTrace(ie);

                } catch (IllegalAccessException iae) {

                    Exceptions.printStackTrace(iae);

                }

            }

        }

        if (currentMapping != null) {

            currentMapping.update(Arrays.asList(rootsToAttach));

        }

    }

    @NonNull

    private Map<URL,T> loadRoots() {

        synchronized(lck) {

           if (cache == null) {

               Map<URL,T> result = new HashMap<URL, T>();

               final Preferences root = NbPreferences.forModule(QueriesCache.class);

               final String folder = clazz.getSimpleName();

               try {

                   if (root.nodeExists(folder)) {

                       final Preferences node = root.node(folder);

                       Map<URL,List<URL>> bindings = new HashMap<URL, List<URL>>();

                       for (String key : node.keys()) {

                           final String value = node.get(key, null);

                           if (value != null) {

                               final URL binUrl = getURL(key);

                               List<URL> binding = bindings.get(binUrl);

                               if(binding == null) {

                                   binding = new ArrayList<URL>();

                                   bindings.put(binUrl,binding);

                               }

                               binding.add(new URL(value));

                           }

                       }

                       for (Map.Entry<URL,List<URL>> e : bindings.entrySet()) {

                           final T instance = clazz.newInstance();

                           instance.update(e.getValue());

                           result.put(e.getKey(), instance);

                       }

                   }

               } catch (BackingStoreException bse) {

                   Exceptions.printStackTrace(bse);

               } catch (MalformedURLException mue) {

                   Exceptions.printStackTrace(mue);

               } catch (InstantiationException ie) {

                   Exceptions.printStackTrace(ie);

               } catch (IllegalAccessException iae) {

                   Exceptions.printStackTrace(iae);

               }

               cache = result;

           }

           return cache;

        }

    }

    private URL getURL(@NonNull final String pattern) throws MalformedURLException {

        final int index = pattern.lastIndexOf(SEP); //NOI18N

        assert index > 0;

        return new URL(pattern.substring(0, index));

    }

    private Iterable<? extends String> filterKeys(

            final String[] keys,

            final String binaryRoot) {

        final List<String> result = new ArrayList<String>();

        for (int i=0; i<keys.length; i++) {

            final int index = keys[i].lastIndexOf(SEP); //NOI18N

            if (index <=0) {

                continue;

            }

            final String root = keys[i].substring(0, index);

            if (root.equals(binaryRoot)) {

                result.add(keys[i]);

            }

        }

        return result;

    }

    @NonNull

    static synchronized QueriesCache<Javadoc> getJavadoc() {

        if (javadoc == null) {

            javadoc = new QueriesCache<Javadoc>(Javadoc.class);

        }

        return javadoc;

    }

    @NonNull

    static synchronized QueriesCache<Sources> getSources() {

        if (sources == null) {

            sources = new QueriesCache<Sources>(Sources.class);

        }

        return sources;

    }

    static abstract class ResultBase {

        private final ChangeSupport cs = new ChangeSupport(this);

        public void addChangeListener(@NonNull final ChangeListener l) {

            cs.addChangeListener(l);

        }

        public void removeChangeListener(@NonNull final ChangeListener l) {

            cs.removeChangeListener(l);

        }

        public final void update(final Collection<? extends URL> roots) {

            updateImpl(roots);

            cs.fireChange();

        }

        protected abstract void updateImpl(final Collection<? extends URL> roots);

    }

    static class Javadoc extends ResultBase implements JavadocForBinaryQuery.Result {

        private volatile URL[] roots;

        public URL[] getRoots() {

            final URL[] tmp = roots;

            return tmp == null ? new URL[0] : Arrays.copyOf(tmp, tmp.length);

        }

        @Override

        protected void updateImpl(final Collection<? extends URL> roots) {

            this.roots = roots.toArray(new URL[roots.size()]);

        }

    }

    static class Sources extends ResultBase implements SourceForBinaryQueryImplementation2.Result {

        private volatile FileObject[] roots;

        @Override

        public boolean preferSources() {

            return false;

        }

        @Override

        public FileObject[] getRoots() {

            final FileObject[] tmp = roots;

            return tmp == null ? new FileObject[0]: Arrays.copyOf(tmp, tmp.length);

        }

        @Override

        protected void updateImpl(final Collection<? extends URL> roots) {

            //Todo: replace by classpath to handle fo listening

            final List<FileObject> fos = new ArrayList<FileObject>(roots.size());

            for (URL url : roots) {

                final FileObject fo = URLMapper.findFileObject(url);

                if (fo != null) {

                    fos.add(fo);

                }

            }

            this.roots = fos.toArray(new FileObject[fos.size()]);

        }

    }

}

<?xml version="1.1" encoding="UTF-8" ?>

<Form version="1.5" maxVersion="1.8" type="org.netbeans.modules.form.forminfo.JPanelFormInfo">

  <NonVisualComponents>

    <Component class="javax.swing.ButtonGroup" name="javadocGroup">

    </Component>

  </NonVisualComponents>

  <AuxValues>

    <AuxValue name="FormSettings_autoResourcing" type="java.lang.Integer" value="1"/>

    <AuxValue name="FormSettings_autoSetComponentName" type="java.lang.Boolean" value="false"/>

    <AuxValue name="FormSettings_generateFQN" type="java.lang.Boolean" value="true"/>

    <AuxValue name="FormSettings_generateMnemonicsCode" type="java.lang.Boolean" value="false"/>

    <AuxValue name="FormSettings_i18nAutoMode" type="java.lang.Boolean" value="true"/>

    <AuxValue name="FormSettings_layoutCodeTarget" type="java.lang.Integer" value="1"/>

    <AuxValue name="FormSettings_listenerGenerationStyle" type="java.lang.Integer" value="0"/>

    <AuxValue name="FormSettings_variablesLocal" type="java.lang.Boolean" value="false"/>

    <AuxValue name="FormSettings_variablesModifier" type="java.lang.Integer" value="2"/>

  </AuxValues>

  <Layout>

    <DimensionLayout dim="0">

      <Group type="103" groupAlignment="0" attributes="0">

          <Group type="102" alignment="0" attributes="0">

              <EmptySpace max="-2" attributes="0"/>

              <Group type="103" groupAlignment="0" attributes="0">

                  <Component id="attachLbl" alignment="0" pref="498" max="32767" attributes="0"/>

                  <Group type="102" alignment="0" attributes="0">

                      <Group type="103" groupAlignment="0" attributes="0">

                          <Component id="remoteJavadoc" alignment="0" min="-2" max="-2" attributes="0"/>

                          <Component id="localJavadoc" alignment="0" min="-2" max="-2" attributes="0"/>

                      </Group>

                      <EmptySpace max="-2" attributes="0"/>

                      <Group type="103" groupAlignment="1" attributes="0">

                          <Group type="102" attributes="0">

                              <Component id="localField" pref="231" max="32767" attributes="0"/>

                              <EmptySpace max="-2" attributes="0"/>

                              <Component id="browse" min="-2" max="-2" attributes="0"/>

                          </Group>

                          <Component id="remoteField" pref="328" max="32767" attributes="0"/>

                      </Group>

                  </Group>

              </Group>

              <EmptySpace max="-2" attributes="0"/>

          </Group>

      </Group>

    </DimensionLayout>

    <DimensionLayout dim="1">

      <Group type="103" groupAlignment="0" attributes="0">

          <Group type="102" attributes="0">

              <EmptySpace max="-2" attributes="0"/>

              <Component id="attachLbl" min="-2" max="-2" attributes="0"/>

              <EmptySpace type="unrelated" max="-2" attributes="0"/>

              <Group type="103" groupAlignment="1" attributes="0">

                  <Component id="browse" min="-2" max="-2" attributes="0"/>

                  <Group type="103" alignment="1" groupAlignment="3" attributes="0">

                      <Component id="localJavadoc" alignment="3" min="-2" max="-2" attributes="0"/>

                      <Component id="localField" alignment="3" min="-2" max="-2" attributes="0"/>

                  </Group>

              </Group>

              <EmptySpace max="-2" attributes="0"/>

              <Group type="103" groupAlignment="3" attributes="0">

                  <Component id="remoteJavadoc" alignment="3" min="-2" max="-2" attributes="0"/>

                  <Component id="remoteField" alignment="3" min="-2" max="-2" attributes="0"/>

              </Group>

              <EmptySpace max="32767" attributes="0"/>

          </Group>

      </Group>

    </DimensionLayout>

  </Layout>

  <SubComponents>

    <Component class="javax.swing.JRadioButton" name="localJavadoc">

      <Properties>

        <Property name="buttonGroup" type="javax.swing.ButtonGroup" editor="org.netbeans.modules.form.RADComponent$ButtonGroupPropertyEditor">

          <ComponentRef name="javadocGroup"/>

        </Property>

        <Property name="text" type="java.lang.String" editor="org.netbeans.modules.i18n.form.FormI18nStringEditor">

          <ResourceString bundle="org/netbeans/modules/java/j2seplatform/queries/Bundle.properties" key="TXT_LocalJavadoc" replaceFormat="org.openide.util.NbBundle.getMessage({sourceFileName}.class, &quot;{key}&quot;)"/>

        </Property>

      </Properties>

      <AuxValues>

        <AuxValue name="generateMnemonicsCode" type="java.lang.Boolean" value="true"/>

      </AuxValues>

    </Component>

    <Component class="javax.swing.JTextField" name="localField">

      <Properties>

        <Property name="editable" type="boolean" value="false"/>

      </Properties>

    </Component>

    <Component class="javax.swing.JRadioButton" name="remoteJavadoc">

      <Properties>

        <Property name="buttonGroup" type="javax.swing.ButtonGroup" editor="org.netbeans.modules.form.RADComponent$ButtonGroupPropertyEditor">

          <ComponentRef name="javadocGroup"/>

        </Property>

        <Property name="text" type="java.lang.String" editor="org.netbeans.modules.i18n.form.FormI18nStringEditor">

          <ResourceString bundle="org/netbeans/modules/java/j2seplatform/queries/Bundle.properties" key="TXT_RemoteJavadoc" replaceFormat="org.openide.util.NbBundle.getMessage({sourceFileName}.class, &quot;{key}&quot;)"/>

        </Property>

      </Properties>

      <AuxValues>

        <AuxValue name="generateMnemonicsCode" type="java.lang.Boolean" value="true"/>

      </AuxValues>

    </Component>

    <Component class="javax.swing.JTextField" name="remoteField">

    </Component>

    <Component class="javax.swing.JButton" name="browse">

      <Properties>

        <Property name="text" type="java.lang.String" editor="org.netbeans.modules.i18n.form.FormI18nStringEditor">

          <ResourceString bundle="org/netbeans/modules/java/j2seplatform/queries/Bundle.properties" key="TXT_Browse" replaceFormat="org.openide.util.NbBundle.getMessage({sourceFileName}.class, &quot;{key}&quot;)"/>

        </Property>

      </Properties>

      <Events>

        <EventHandler event="actionPerformed" listener="java.awt.event.ActionListener" parameters="java.awt.event.ActionEvent" handler="browse"/>

      </Events>

      <AuxValues>

        <AuxValue name="generateMnemonicsCode" type="java.lang.Boolean" value="true"/>

      </AuxValues>

    </Component>

    <Component class="javax.swing.JLabel" name="attachLbl">

      <Properties>

        <Property name="text" type="java.lang.String" editor="org.netbeans.modules.form.RADConnectionPropertyEditor">

          <Connection code="NbBundle.getMessage(SelectJavadocPanel.class, &quot;TXT_AttachJavadocTo&quot;,fileName)" type="code"/>

        </Property>

      </Properties>

    </Component>

  </SubComponents>

</Form>