<change id="ProjectGroup">

            <api name="general"/>

            <summary>API to get current active project group and listen to project groups switching</summary>

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

            <date day="25" month="8" year="2012"/>

            <author login="mkleint"/>

            <compatibility addition="yes"/>

            <description>

                <p>

                    Added methods to 

                    <code>OpenProjects</code> to figure the currently active project group, access preferences related to it

                    and listen to changes in currently active group.

                </p>

            </description>

            <class package="org.netbeans.api.project.ui" name="OpenProjects"/>

            <class package="org.netbeans.api.project.ui" name="ProjectGroup"/>

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

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

            <issue number="91031"/>

        </change>

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

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

    /**

     * return the currently action project group

     * @return can be null if no group is active

     * @since 1.61

     */

    public @CheckForNull ProjectGroup getActiveProjectGroup() {

        return trampoline.getActiveProjectGroupAPI();

    /**

     * add listener to changes in active project group

     * @param listener 

     * @since 1.61

     */

    public void addProjectGroupChangeListener( @NonNull ProjectGroupChangeListener listener) {

        trampoline.addProjectGroupChangeListenerAPI(listener);

    }

    /**

     * remove listener to changes in active project group

     * @param listener 

     * @since 1.61

     */

    public void removeProjectGroupChangeListener( @NonNull ProjectGroupChangeListener listener) {

        trampoline.removeProjectGroupChangeListenerAPI(listener);

    }

}

/*

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

 *

 * Copyright 2012 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 2012 Sun Microsystems, Inc.

 */

package org.netbeans.api.project.ui;

import java.util.prefs.Preferences;

import org.netbeans.modules.project.uiapi.Utilities;

/**

 * Object describing a project group, in most cases the currently active project group.

 * @author mkleint

 * @since 1.61

 */

public final class ProjectGroup {

    private final Preferences prefs;

    private final String name;

    ProjectGroup(String name, Preferences prefs) {

        this.name = name;

        this.prefs = prefs;

    }

    /**

     * name of the project group as given by user

     * @return 

     */

    public String getName() {

        return name;

    }

    /**

     * use this method to store and retrieve preferences related to project groups.

     * @param clazz

     * @return 

     */

    public Preferences preferencesForPackage(Class clazz) {

        return prefs.node(clazz.getPackage().getName().replace(".", "/"));

    }

    @Override

    public int hashCode() {

        int hash = 7;

        hash = 11 * hash + (this.name != null ? this.name.hashCode() : 0);

        return hash;

    }

    @Override

    public boolean equals(Object obj) {

        if (obj == null) {

            return false;

        }

        if (getClass() != obj.getClass()) {

            return false;

        }

        final ProjectGroup other = (ProjectGroup) obj;

        if ((this.name == null) ? (other.name != null) : !this.name.equals(other.name)) {

            return false;

        }

        return true;

    }

    static {

        AccessorImpl impl = new AccessorImpl();

        impl.assign();

    }

    static class AccessorImpl extends Utilities.ProjectGroupAccessor {

         public void assign() {

             if (Utilities.ACCESSOR == null) {

                 Utilities.ACCESSOR = this;

             }

         }

        @Override

        public ProjectGroup createGroup(String name, Preferences prefs) {

            return new ProjectGroup(name, prefs);

        }

    }    

}

/*

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

 *

 * Copyright 2012 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 2012 Sun Microsystems, Inc.

 */

package org.netbeans.api.project.ui;

import java.util.EventObject;

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

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

/**

 * event describing the change of active project group by the user.

 * @author mkleint

 * @since 1.61

 */

public final class ProjectGroupChangeEvent extends EventObject {

    private final ProjectGroup newGroup;

    private final ProjectGroup oldGroup;

    public ProjectGroupChangeEvent(@NullAllowed ProjectGroup o, @NullAllowed ProjectGroup n) {

        super(OpenProjects.getDefault());

        this.oldGroup = o;

        this.newGroup = n;

    }

    /**

     * the newly current project group, can be null

     * @return 

     */

    public @CheckForNull ProjectGroup getNewGroup() {

        return newGroup;

    }

    /**

     * the previous active project group, can be null

     * @return 

     */

    public @CheckForNull ProjectGroup getOldGroup() {

        return oldGroup;

    }

}

/*

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

 *

 * Copyright 2012 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 2012 Sun Microsystems, Inc.

 */

package org.netbeans.api.project.ui;

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

/**

 * listeners that get notified when project group is changed.

 * added and removed from <code>OpenProjects</code>

 * @author mkleint

 * @since 1.61

 */

public interface ProjectGroupChangeListener {

    /**

     * called when the process of changing from old to new project group has started. Will be called before

     * the actual projects from old group get closed and the ones from new group get opened.

     * @param event 

     */

    void projectGroupChanging(@NonNull ProjectGroupChangeEvent event);

    /**

     * called when the process of changing from old to new project group has been completed. Only projects 

     * related to current group should be open now, or projects explicitly opened by the user.

     * @param event 

     */

    void projectGroupChanged(@NonNull ProjectGroupChangeEvent event);

}

import org.netbeans.api.project.ui.ProjectGroup;

import org.netbeans.api.project.ui.ProjectGroupChangeListener;

    public ProjectGroup getActiveProjectGroupAPI();

    public void addProjectGroupChangeListenerAPI(ProjectGroupChangeListener listener);

    public void removeProjectGroupChangeListenerAPI(ProjectGroupChangeListener listener);

import java.util.logging.Level;

import java.util.logging.Logger;

import java.util.prefs.Preferences;

import org.netbeans.api.project.ui.ProjectGroup;

import org.netbeans.api.project.ui.ProjectGroupChangeListener;

    private static final Logger LOG = Logger.getLogger(Utilities.class.getName());

            @Override

            public void addProjectGroupChangeListenerAPI(ProjectGroupChangeListener listener) {

            }

            @Override

            public void removeProjectGroupChangeListenerAPI(ProjectGroupChangeListener listener) {

            }

            @Override

            public ProjectGroup getActiveProjectGroupAPI() {

                return null;

            }

    @org.netbeans.api.annotations.common.SuppressWarnings("MS_SHOULD_BE_FINAL")

    public static ProjectGroupAccessor ACCESSOR = null;

    static {

        // invokes static initializer of ModelHandle.class

        // that will assign value to the ACCESSOR field above

        Class<?> c = ProjectGroup.class;

        try {

            Class.forName(c.getName(), true, c.getClassLoader());

        } catch (Exception ex) {

            LOG.log(Level.SEVERE, "very wrong, very wrong, yes indeed", ex);

        }

    }

    public static abstract class ProjectGroupAccessor {

        public abstract ProjectGroup createGroup(String name, Preferences prefs);

    }