<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 javax.swing.SwingUtilities;

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

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

import org.openide.util.Exceptions;

import org.openide.util.Lookup;

/**

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

     * Has to be called by event dispatch thread as the SPI implementation may need to show

     * an UI to select source root(s).

     * @param root the binary root to attach sources to

     * @return true if the source root was successfully attached

     */

    public static boolean attachSources(@NonNull final URL root) {

        return attach(root,0);

    }

    /**

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

     * to given binary root.

     * Has to be called by event dispatch thread as the SPI implementation may need to show

     * an UI to select javadoc root(s).

     * @param root the binary root to attach javadoc to

     * @return true if the javadoc root was successfully attached

     */

    public static boolean attachJavadoc(@NonNull final URL root) {

        return attach(root,1);

    }

    private static boolean attach(final URL root, final int mode) {

        if (!SwingUtilities.isEventDispatchThread()) {

            throw new IllegalStateException("Has to be called by EDT.");    //NOI18N

        }

        try {

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

                final SourceJavadocAttacherImplementation.Result res =

                        mode == 0 ?

                            attacher.attachSources(root) :

                            attacher.attachJavadoc(root);

                if (res == SourceJavadocAttacherImplementation.Result.ATTACHED) {

                    return true;

                } else if (res == SourceJavadocAttacherImplementation.Result.CANCELED) {

                    return false;

                }

            }

        } catch (IOException ioe) {

            Exceptions.printStackTrace(ioe);

        }

        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.spi.java.queries;

import java.io.IOException;

import java.net.URL;

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

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

 * @since 1.35

 * @author Tomas Zezula

 * @since 1.35

 */

public interface SourceJavadocAttacherImplementation {

    /**

     * Result of the attaching sources (javadoc) to binary root.

     */

    enum Result {

        /**

         * The source (javadoc) root was successfully attached to

         * the binary root.

         */

        ATTACHED,

        /**

         * User canceled the attaching, no other SPI provider

         * is called and {@link SourceJavadocAttacher} returns false.

         */

        CANCELED,

        /**

         * The SPI is not able to attach sources (javadoc) to given

         * binary root (it does not handle it), next SPI provider is

         * called.

         */

        UNSUPPORTED

    }

    /**

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

     * Called by event dispatch thread, it's safe to show an UI to select source root(s).

     * @param root the binary root to attach sources to

     * @return {@link SourceJavadocAttacherImplementation.Result} the result of

     * attach operation.

     */

    @NonNull

    Result attachSources(@NonNull URL root) throws IOException;

    /**

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

     * Called by event dispatch thread, it's safe to show an UI to select javadoc root(s).

     * @param root the binary root to attach javadoc to

     * @return {@link SourceJavadocAttacherImplementation.Result} the result of

     * attach operation.

     */

    @NonNull

    Result attachJavadoc(@NonNull URL root) 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 org.netbeans.api.annotations.common.NonNull;

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

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

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 Result attachSources(@NonNull final URL root) throws IOException {

        return attach(root, J2SELibraryTypeProvider.VOLUME_TYPE_SRC);

    }

    @Override

    public Result attachJavadoc(@NonNull final URL root) throws IOException {

        return attach(root, J2SELibraryTypeProvider.VOLUME_TYPE_JAVADOC);

    }

    private Result attach(

            @NonNull final URL root,

            final String volume) {

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

        if (pair == null) {

            return Result.UNSUPPORTED;

        }

        final LibraryManager lm = pair.first;

        final Library lib = pair.second;

        assert lm != null;

        assert lib != null;

        try {

            final URL areaLocation = lm.getLocation();

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

            final URI[] uris = J2SEVolumeCustomizer.select(

                volume,

                lib.getName(),

                new File[1],

                null,

                baseFolder);

            if (uris != 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()+uris.length);

                        newContent.addAll(content);

                        newContent.addAll(Arrays.asList(uris));

                        content = newContent;

                    }

                    volumes.put(currentVolume,content);

                }

                lm.removeLibrary(lib);

                lm.createURILibrary(

                    J2SELibraryTypeProvider.LIBRARY_TYPE,

                    name,

                    displayName,

                    desc,

                    volumes);

                return Result.ATTACHED;

            }

        } catch (IOException ioe) {

            Exceptions.printStackTrace(ioe);

        } catch (URISyntaxException use) {

            Exceptions.printStackTrace(use);

        }

        return Result.CANCELED;

    }

    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);

        }

    }

}

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 URI[] 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 pathsToURIs (

                        chooser.getSelectedPaths(),

                        volumeType,

                        baseFolder);

            } catch (MalformedURLException mue) {

                Exceptions.printStackTrace(mue);

            } catch (URISyntaxException ue) {

                Exceptions.printStackTrace(ue);

            } catch (IOException ex) {

                Exceptions.printStackTrace(ex);

            }

        }

        return null;

    }

    static boolean select(

            final PathModel model,

            final File[] currentDir,

            final Component parentComponent) {

        final JFileChooser chooser = new JFileChooser ();

        chooser.setMultiSelectionEnabled (true);

        String title = null;

        String message = null;

        String approveButtonName = null;

        String approveButtonNameMne = null;

        if (model.type == SOURCES) {

            title = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_OpenSources");

            message = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_Sources");

            approveButtonName = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_OpenSources");

            approveButtonNameMne = NbBundle.getMessage (J2SEPlatformCustomizer.class,"MNE_OpenSources");

        } else if (model.type == JAVADOC) {

            title = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_OpenJavadoc");

            message = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_Javadoc");

            approveButtonName = NbBundle.getMessage (J2SEPlatformCustomizer.class,"TXT_OpenJavadoc");

            approveButtonNameMne = NbBundle.getMessage (J2SEPlatformCustomizer.class,"MNE_OpenJavadoc");

        }

        chooser.setDialogTitle(title);

        chooser.setApproveButtonText(approveButtonName);

        chooser.setApproveButtonMnemonic (approveButtonNameMne.charAt(0));

        chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

        if (Utilities.isMac()) {

            //New JDKs and JREs are bundled into package, allow JFileChooser to navigate in

            chooser.putClientProperty("JFileChooser.packageIsTraversable", "always");   //NOI18N

        }

        //#61789 on old macosx (jdk 1.4.1) these two method need to be called in this order.

        chooser.setAcceptAllFileFilterUsed( false );

        chooser.setFileFilter (new ArchiveFileFilter(message,new String[] {"ZIP","JAR"}));   //NOI18N

        if (currentDir[0] != null) {

            chooser.setCurrentDirectory(currentDir[0]);

        }

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

            File[] fs = chooser.getSelectedFiles();

            boolean addingFailed = false;

            for (File f : fs) {

                //XXX: JFileChooser workaround (JDK bug #5075580), double click on folder returns wrong file

                // E.g. for /foo/src it returns /foo/src/src

                // Try to convert it back by removing last invalid name component

                if (!f.exists()) {

                    File parent = f.getParentFile();

                    if (parent != null && f.getName().equals(parent.getName()) && parent.exists()) {

                        f = parent;

                    }

                }

                if (f.exists()) {

                    addingFailed|=!model.addPath (f);

                }

            }

            if (addingFailed) {

                new NotifyDescriptor.Message (NbBundle.getMessage(J2SEPlatformCustomizer.class,"TXT_CanNotAddResolve"),

                        NotifyDescriptor.ERROR_MESSAGE);

            }

            currentDir[0] = FileUtil.normalizeFile(chooser.getCurrentDirectory());

            return true;

        }

        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.URL;

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.spi.java.queries.SourceJavadocAttacherImplementation;

import org.openide.util.lookup.ServiceProvider;

/**

 *

 * @author Tomas Zezula

 */

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

public class J2SEPlatformSourceJavadocAttacher implements SourceJavadocAttacherImplementation {

    @Override

    public Result attachSources(final URL root) throws IOException {

        return attach(root, J2SEPlatformCustomizer.SOURCES);

    }

    @Override

    public Result attachJavadoc(final URL root) throws IOException {

        return attach(root, J2SEPlatformCustomizer.JAVADOC);

    }

    private Result attach(final URL root, int mode) {

        final J2SEPlatformImpl platform = findOwner(root);

        if (platform == null) {

            return Result.UNSUPPORTED;

        }

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

        if (J2SEPlatformCustomizer.select(model,new File[1],null)) {

            return Result.ATTACHED;

        }

        return Result.CANCELED;

    }

    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;

    }

}

/*

 * 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.URL;

import java.util.ArrayList;

import java.util.List;

import javax.swing.JFileChooser;

import javax.swing.filechooser.FileFilter;

import org.netbeans.spi.java.project.support.JavadocAndSourceRootDetection;

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

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileStateInvalidException;

import org.openide.filesystems.FileUtil;

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 Result attachSources(URL root) throws IOException {

        final URL[] sources = selectRoots(0);

        if (sources != null) {

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

            return Result.ATTACHED;

        }

        return Result.CANCELED;

    }

    @Override

    public Result attachJavadoc(URL root) throws IOException {

        final URL[] javadoc = selectRoots(1);

        if (javadoc != null) {

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

            return Result.ATTACHED;

        }

        return Result.CANCELED;

    }

    @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)",

        "TXT_Select=Add ZIP/Folder",

        "MNE_Select=A"

    })

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

        final JFileChooser chooser = new JFileChooser();

        chooser.setMultiSelectionEnabled (true);

        chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

        chooser.setDialogTitle(Bundle.TXT_Title());

        chooser.setFileFilter (new FileFilter() {

            @Override

            public boolean accept(File f) {

                try {

                    return f.isDirectory() ||

                        FileUtil.isArchiveFile(f.toURI().toURL());

                } catch (MalformedURLException ex) {

                    return false;

                }

            }

            @Override

            public String getDescription() {

                return mode == 0 ? Bundle.TXT_Sources() : Bundle.TXT_Javadoc();

            }

        });

        chooser.setApproveButtonText(Bundle.TXT_Select());

        chooser.setApproveButtonMnemonic(Bundle.MNE_Select().charAt(0));

        if (currentFolder != null) {

            chooser.setCurrentDirectory(currentFolder);

        }

        if (chooser.showOpenDialog(null) == chooser.APPROVE_OPTION) {

            currentFolder = chooser.getCurrentDirectory();

            final File[] files = chooser.getSelectedFiles();

            final List<URL> result = new ArrayList<URL>(files.length);

            for (File f : files) {

                FileObject fo = FileUtil.toFileObject(f);

                if (fo.isData()) {

                    fo = FileUtil.getArchiveRoot(fo);

                }

                fo = mode == 0 ?

                    JavadocAndSourceRootDetection.findSourceRoot(fo) :

                    JavadocAndSourceRootDetection.findJavadocRoot(fo);

                result.add(fo.getURL());

            }

            return result.toArray(new URL[result.size()]);

        }

        return null;

    }

    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">

  <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 min="-2" pref="20" max="-2" attributes="0"/>

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

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

              <Component id="jLabel2" pref="430" max="32767" attributes="0"/>

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

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

              <EmptySpace min="-2" pref="17" max="-2" attributes="0"/>

          </Group>

      </Group>

    </DimensionLayout>

    <DimensionLayout dim="1">

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

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

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

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

              <Component id="jButton1" alignment="3" min="-2" pref="25" max="-2" attributes="0"/>

          </Group>

      </Group>

    </DimensionLayout>

  </Layout>

  <SubComponents>

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

      <Properties>

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

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

        </Property>

      </Properties>

    </Component>

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

      <Properties>

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

          <ResourceString bundle="org/netbeans/modules/java/classfile/Bundle.properties" key="AttachSourcePanel.jButton1.text" 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="attachSources"/>

      </Events>

    </Component>

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

      <Properties>

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

          <Connection code="getFileDisplayName()" type="code"/>

        </Property>

      </Properties>

    </Component>

  </SubComponents>

</Form>

/*

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

 */

/*

 * AttachSourcePanel.java

 *

 * Created on Aug 1, 2011, 4:54:38 PM

 */

package org.netbeans.modules.java.classfile;

import java.net.URL;

import org.netbeans.api.actions.Openable;

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

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

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

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

import org.netbeans.spi.java.classpath.support.ClassPathSupport;

import org.openide.cookies.EditorCookie;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileUtil;

import org.openide.filesystems.URLMapper;

import org.openide.loaders.DataObject;

import org.openide.loaders.DataObjectNotFoundException;

import org.openide.util.Exceptions;

import org.openide.util.NbBundle;

public class AttachSourcePanel extends javax.swing.JPanel {

    private final URL root;

    private final URL file;

    private final String binaryName;

    public AttachSourcePanel(

            @NonNull final URL root,

            @NonNull final URL file,

            @NonNull final String binaryName) {

        assert root != null;

        assert file != null;

        assert binaryName != null;

        this.root = root;

        this.file = file;

        this.binaryName = binaryName;

        initComponents();

    }

    @NbBundle.Messages({

        "TXT_UnknownRoot=<unknown-root>"

    })

    private String getFileDisplayName() {

        final FileObject rootFo = URLMapper.findFileObject(root);

        return rootFo == null ? Bundle.TXT_UnknownRoot() : FileUtil.getFileDisplayName(rootFo);

    }

    /** This method is called from within the constructor to

     * initialize the form.

     * WARNING: Do NOT modify this code. The content of this method is

     * always regenerated by the Form Editor.

     */

    @SuppressWarnings("unchecked")

    // <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents

    private void initComponents() {

        jLabel1 = new javax.swing.JLabel();

        jButton1 = new javax.swing.JButton();

        jLabel2 = new javax.swing.JLabel();

        jLabel1.setText(org.openide.util.NbBundle.getMessage(AttachSourcePanel.class, "AttachSourcePanel.jLabel1.text")); // NOI18N

        jButton1.setText(org.openide.util.NbBundle.getMessage(AttachSourcePanel.class, "AttachSourcePanel.jButton1.text")); // NOI18N

        jButton1.addActionListener(new java.awt.event.ActionListener() {

            public void actionPerformed(java.awt.event.ActionEvent evt) {

                attachSources(evt);

            }

        });

        jLabel2.setText(getFileDisplayName());

        javax.swing.GroupLayout layout = new javax.swing.GroupLayout(this);

        this.setLayout(layout);

        layout.setHorizontalGroup(

            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)

            .addGroup(layout.createSequentialGroup()

                .addGap(20, 20, 20)

                .addComponent(jLabel1)

                .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)

                .addComponent(jLabel2, javax.swing.GroupLayout.DEFAULT_SIZE, 430, Short.MAX_VALUE)

                .addPreferredGap(javax.swing.LayoutStyle.ComponentPlacement.RELATED)

                .addComponent(jButton1)

                .addGap(17, 17, 17))

        );

        layout.setVerticalGroup(

            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)

            .addGroup(layout.createParallelGroup(javax.swing.GroupLayout.Alignment.BASELINE)

                .addComponent(jLabel1)

                .addComponent(jLabel2)

                .addComponent(jButton1, javax.swing.GroupLayout.PREFERRED_SIZE, 25, javax.swing.GroupLayout.PREFERRED_SIZE))

        );

    }// </editor-fold>//GEN-END:initComponents

private void attachSources(java.awt.event.ActionEvent evt) {//GEN-FIRST:event_attachSources

        if (SourceJavadocAttacher.attachSources(root)) {

            final FileObject rootFo = URLMapper.findFileObject(root);

            final FileObject fileFo = URLMapper.findFileObject(file);

            if (rootFo != null && fileFo != null) {

                final FileObject[] fos = SourceForBinaryQuery.findSourceRoots(root).getRoots();

                if (fos.length > 0) {

                    final ClassPath cp = ClassPathSupport.createClassPath(fos);

                    final FileObject newFileFo = cp.findResource(binaryName + ".java"); //NOI18N

                    if (newFileFo != null) {

                        try {

                            final EditorCookie ec = DataObject.find(fileFo).getLookup().lookup(EditorCookie.class);

                            final Openable open = DataObject.find(newFileFo).getLookup().lookup(Openable.class);

                            if (ec != null && open != null) {

                                ec.close();

                                open.open();

                            }

                        } catch (DataObjectNotFoundException ex) {

                            Exceptions.printStackTrace(ex);

                        }

                    }

                }

            }

        }

}//GEN-LAST:event_attachSources

    // Variables declaration - do not modify//GEN-BEGIN:variables

    private javax.swing.JButton jButton1;

    private javax.swing.JLabel jLabel1;

    private javax.swing.JLabel jLabel2;

    // End of variables declaration//GEN-END:variables

}