<change id="lookups.execute">

        <api name="lookup"/>

        <summary>A way to control Lookup.getDefault</summary>

        <version major="8" minor="30"/>

        <date day="22" month="10" year="2014"/>

        <author login="jtulach"/>

        <compatibility

            addition="yes"

            binary="compatible" deletion="no" deprecation="no"

            modification="no" semantic="incompatible" source="compatible"

        >

            The clients of <a href="@TOP@/org/openide/util/Lookup.html#getDefault()">

            Lookup.getDefault()</a> are mostly unaffected by this change,

            just they need to be ready for the fact that the return 

            value of the method may no longer be fixed one, but can mutate

            over time.

        </compatibility>

        <description>

            <p>

                One can use <a href="@TOP@/org/openide/util/lookup/Lookups.html#execute(org.openide.util.Lookup, java.lang.Runnable)">

                Lookups.execute(yourLookup, yourRunnable)

                </a> to temporarily influence return value from

                <a href="@TOP@/org/openide/util/Lookup.html#getDefault()">

                Lookup.getDefault()</a>. 

            </p>

        </description>

        <class package="org.openide.util.lookup" name="Lookups"/>

        <issue number="247930"/>

    </change>

/*

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

 *

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

 */

package org.netbeans.modules.openide.util;

import org.openide.util.Lookup;

public class GlobalLookup {

    private static ThreadLocal<Lookup> CURRENT = new ThreadLocal<Lookup>();

    private GlobalLookup() {

    }

    public static void execute(Lookup defaultLookup, Runnable r) {

        Lookup prev = CURRENT.get();

        try {

            CURRENT.set(defaultLookup);

            r.run();

        } finally {

            CURRENT.set(prev);

        }

    }

    public static Lookup current() {

        return CURRENT.get();

    }

}

import org.netbeans.modules.openide.util.GlobalLookup;

        Lookup current = GlobalLookup.current();

        if (current != null) {

            return current;

        }

import org.netbeans.modules.openide.util.GlobalLookup;

    /** Temporarily (while the <code>code</code> is running) changes value

     * of {@link Lookup#getDefault()} to here-in provided lookup. Useful in a

     * multi user environment where different users and their requests should

     * be associated with different content of default lookup.

     * 

     * @param defaultLookup the lookup to be come default while code is running

     * @param code the code to execute (synchronously) before the method returns

     * @since 8.30

     */

    public static void execute(Lookup defaultLookup, Runnable code) {

        GlobalLookup.execute(defaultLookup, code);

    }

/*

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

 *

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

 */

package org.openide.util.lookup;

import org.netbeans.junit.NbTestCase;

import org.openide.util.Lookup;

public class LookupGetDefaultTest extends NbTestCase {

    public LookupGetDefaultTest(String name) {

        super(name);

    }

    public void testCanChangeDefaultLookup() throws Exception {

        Lookup prev = Lookup.getDefault();

        final Lookup my = new AbstractLookup();

        final Thread myThread = Thread.currentThread();

        final boolean[] ok = { false };

        Lookups.execute(my, new Runnable() {

            @Override

            public void run() {

                assertSame("Default lookup has been changed", my, Lookup.getDefault());

                assertSame("We are being executed in the same thread", myThread, Thread.currentThread());

                ok[0] = true;

            }

        });

        assertTrue("In my lookup code executed OK", ok[0]);

        assertEquals("Current lookup back to normal", prev, Lookup.getDefault());

    }

}

    <change id="lookups.execute.and.rp">

        <api name="util"/>

        <summary>RequestProcessor tasks remember correct lookup</summary>

        <version major="8" minor="41"/>

        <date year="2014" month="10" day="22"/>

        <author login="jtulach"/>

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

        <description>

            <p>

            <a href="@TOP@/org/openide/util/RequestProcessor.html">RequestProcessor</a>

            is now <a href="@org-openide-util-lookup@/org/openide/util/lookup/Lookups.html#execute(org.openide.util.Lookup, java.lang.Runnable)">

            Lookups.execute</a> aware and makes sure the executed task

            uses the same default lookup as at the time of its 

            initial creation.

            </p>

        </description>

        <class package="org.openide.util" name="RequestProcessor"/>

        <issue number="247930"/>

    </change>

import org.openide.util.lookup.Lookups;

            lkp[0] = i.current;

        final Lookup current;

            current = Lookup.getDefault();

                    Lookup[] lkp = new Lookup[1];

/*

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

 *

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

 */

package org.openide.util;

import java.util.concurrent.TimeUnit;

import org.netbeans.junit.NbTestCase;

import org.openide.util.Lookup;

import org.openide.util.lookup.AbstractLookup;

import org.openide.util.lookup.InstanceContent;

import org.openide.util.lookup.Lookups;

public class RequestProcessorLookupGetDefaultTest extends NbTestCase {

    public RequestProcessorLookupGetDefaultTest(String name) {

        super(name);

    }

    public void testChangeOfDefaultLookupAppliedToRPTask() throws Exception {

        Lookup prev = Lookup.getDefault();

        final Lookup my = new AbstractLookup(new InstanceContent());

        final Thread myThread = Thread.currentThread();

        final RequestProcessor.Task[] task = { null };

        final boolean[] ok = { false };

        Lookups.execute(my, new Runnable() {

            @Override

            public void run() {

                assertSame("Default lookup has been changed", my, Lookup.getDefault());

                if (task[0] == null) {

                    assertSame("We are being executed in the same thread", myThread, Thread.currentThread());

                    // once again in the RP

                    task[0] = RequestProcessor.getDefault().post(this, 500);

                } else {

                    ok[0] = true;

                }

            }

        });

        assertNotNull("In my lookup code executed OK", task[0]);

        assertEquals("Current lookup back to normal", prev, Lookup.getDefault());

        task[0].waitFinished();

        assertTrue("Even RP task had the right lookup", ok[0]);

    }

}