<change id="priority-io">

            <api name="masterfs"/>

            <summary><code>ProvidedExtensions.priorityIO</code> to suspend background refresh</summary>

            <version major="2" minor="25"/>

            <date day="12" month="5" year="2010"/>

            <author login="jtulach"/>

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

            <description>

                <p>

                    <code>ProvidedExtensions.priorityIO</code> allows

                    parsing API to suspend background I/O activity after refresh

                    of main window.

                </p>

            </description>

            <class package="org.netbeans.modules.masterfs.providers" name="ProvidedExtensions"/>

            <issue number="181684"/>

        </change>

import java.util.concurrent.Callable;

import java.util.concurrent.atomic.AtomicInteger;

    private static final AtomicInteger priorityIO = new AtomicInteger();

    public static <T> T priorityIO(Callable<T> callable) throws Exception {

        try {

            priorityIO.incrementAndGet();

            return callable.call();

        } finally {

            priorityIO.decrementAndGet();

        }

    }

import java.util.concurrent.Callable;

import org.netbeans.modules.masterfs.filebasedfs.utils.FileChangedManager;

    /** Allows registered exceptions to execute some I/O priority action.

     * This will stop all other "idle I/O" operations (like background refresh

     * after window is activated).

     *

     * @param callable the {@link Callable} to run

     * @throws Exception the exception thrown by the callable

     * @since 2.35

     */

    public static <T> T priorityIO(Callable<T> run) throws Exception {

        return FileChangedManager.priorityIO(run);

    }

/*

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

 *

 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.

 *

 * 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.  Sun designates this

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

 * by Sun 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 2009 Sun Microsystems, Inc.

 */

package org.netbeans.modules.masterfs;

import java.awt.event.ActionEvent;

import java.io.File;

import java.io.FileOutputStream;

import java.lang.ref.Reference;

import java.lang.ref.WeakReference;

import java.util.ArrayList;

import java.util.List;

import java.util.logging.Level;

import java.util.logging.Logger;

import org.netbeans.junit.NbTestCase;

import org.netbeans.junit.RandomlyFails;

import org.netbeans.modules.masterfs.filebasedfs.utils.FileChangedManager;

import org.openide.filesystems.FileChangeAdapter;

import org.openide.filesystems.FileEvent;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileUtil;

import org.openide.util.Exceptions;

import org.openide.util.RequestProcessor;

public class SlowRefreshAndPriorityIOTest extends NbTestCase {

    private Logger LOG;

    private FileObject testFolder;

    public SlowRefreshAndPriorityIOTest(String testName) {

        super(testName);

    }

    @Override

    protected Level logLevel() {

        return Level.FINE;

    }

    @Override

    protected void setUp() throws Exception {

        clearWorkDir();

        LOG = Logger.getLogger("test." + getName());

        Logger.getLogger("org.openide.util.Mutex").setUseParentHandlers(false);

        File dir = new File(getWorkDir(), "test");

        dir.mkdirs();

        testFolder = FileUtil.toFileObject(dir);

        assertNotNull("Test folder created", testFolder);

        System.setSecurityManager(new FileChangedManager());

    }

    public void testRefreshCanBeSuspendedByPriorityIO() throws Exception {

        long lm = System.currentTimeMillis();

        LOG.info("starting testRefreshCanBeSuspended " + lm);

        FileObject fileObject1 = testFolder.createData("fileObject1");

        assertNotNull("Just to initialize the stamp", lm);

        FileObject[] arr = testFolder.getChildren();

        assertEquals("One child", 1, arr.length);

        assertEquals("Right child", fileObject1, arr[0]);

        File file = FileUtil.toFile(fileObject1);

        assertNotNull("File found", file);

        Reference<FileObject> ref = new WeakReference<FileObject>(fileObject1);

        arr = null;

        fileObject1 = null;

        assertGC("File Object can disappear", ref);

        class L extends FileChangeAdapter {

            int cnt;

            FileEvent event;

            @Override

            public void fileChanged(FileEvent fe) {

                LOG.info("file change " + fe.getFile());

                cnt++;

                event = fe;

            }

        }

        L listener = new L();

        testFolder.addRecursiveListener(listener);

        Thread.sleep(1000);

        FileOutputStream os = new FileOutputStream(file);

        os.write(10);

        os.close();

        if (lm > file.lastModified() - 50) {

            fail("New modification time shall be at last 50ms after the original one: " + (file.lastModified() - lm));

        }

        Object obj = testFolder.getFileSystem().getRoot().getAttribute("refreshSlow");

        assertNotNull("Refresh attribute found", obj);

        assertTrue("It is instance of runnable:  " + obj, obj instanceof Runnable);

        Runnable r = (Runnable)obj;

        class AE extends ActionEvent implements Runnable {

            List<FileObject> files = new ArrayList<FileObject>();

            boolean boosted;

            boolean finished;

            int goingIdle;

            public AE() {

                super("", 0, "");

            }

            @Override

            public void setSource(Object newSource) {

                LOG.log(Level.INFO, "Set source called: {0}", newSource);

                assertTrue(newSource instanceof Object[]);

                Object[] arr = (Object[])newSource;

                assertTrue("Three elements at leat ", 3 <= arr.length);

                assertTrue("first is int", arr[0] instanceof Integer);

                assertTrue("2nd is int", arr[1] instanceof Integer);

                assertTrue("3rd is fileobject", arr[2] instanceof FileObject);

                files.add((FileObject)arr[2]);

                super.setSource(newSource);

            }

            @Override

            public void run() {

                goingIdle++;

            }

            public synchronized void waitBoosted() throws Exception {

                while (!boosted) {

                    wait();

                }

            }

            public synchronized void notifyBoosted() {

                boosted = true;

                notifyAll();

            }

        }

        final AE counter = new AE();

        LOG.info("Posting AE into RP");

        // starts 5s of disk checking

        RequestProcessor.Task task = RequestProcessor.getDefault().post(new Runnable() {

            boolean snd;

            @Override

            public void run() {

                if (!snd) {

                    snd = true;

                    FileChangedManager.priorityIO(this);

                } else {

                    counter.notifyBoosted();

                    try {

                        Thread.sleep(5000);

                        counter.finished = true;

                    } catch (InterruptedException ex) {

                        Exceptions.printStackTrace(ex);

                    }

                }

            }

        });

        // connect together

        r.equals(counter);

        LOG.info("Waiting for I/O boost");

        counter.waitBoosted();

        LOG.info("Starting refresh");

        // do the refresh

        r.run();

        LOG.info("Refresh finished");

        assertTrue("Background I/O access needs to stop before we finish our task", counter.finished);

        assertEquals("Change notified", 1, listener.cnt);

        assertEquals("Right file", file, FileUtil.toFile(listener.event.getFile()));

        assertEquals("Right source", file.getParentFile(), FileUtil.toFile((FileObject)listener.event.getSource()));

        if (counter.goingIdle == 0) {

            fail("The I/O subsystem shall notify the action that it went idle at least once");

        }

    }

}

import java.util.concurrent.Callable;

import java.util.concurrent.Callable;

import org.netbeans.modules.masterfs.providers.ProvidedExtensions;

    //MasterFS bridge

    public static <T> T runPriorityIO (final Callable<T> r) throws Exception {

        assert r != null;

        return ProvidedExtensions.priorityIO(r);

    }

import java.util.concurrent.Callable;

import org.netbeans.modules.parsing.impl.Utilities;

import org.openide.util.Exceptions;

        try {

            return Utilities.runPriorityIO(new Callable<Collection<? extends IndexResult>>() {

                    final List<IndexResult> result = new LinkedList<IndexResult>();

                    for (Pair<URL, IndexImpl> pair : indices) {

                        final IndexImpl index = pair.second;

                        final URL root = pair.first;

                        final Collection<? extends IndexDocumentImpl> pr = index.query(fieldName, fieldValue, kind, fieldsToLoad);

                        if (LOG.isLoggable(Level.FINE)) {

                            LOG.fine("query(\"" + fieldName + "\", \"" + fieldValue + "\", " + kind + ", " + printFiledToLoad(fieldsToLoad) + ") invoked at " + getClass().getSimpleName() + "@" + Integer.toHexString(System.identityHashCode(this)) + "[indexer=" + indexerQuery.getIndexerId() + "]:"); //NOI18N

                            for (IndexDocumentImpl idi : pr) {

                                LOG.fine(" " + idi); //NOI18N

                            }

                            LOG.fine("----"); //NOI18N

                        }

                        for (IndexDocumentImpl di : pr) {

                            result.add(new IndexResult(di, root));

                        }

                    }

                    return result;

import java.util.concurrent.Callable;

import org.netbeans.modules.masterfs.providers.ProvidedExtensions;

            boolean active = false;

                filteredStackTrace.add(e);