<change id="convenience-access-to-sfs-folders">

            <api name="filesystems"/>

            <summary>Convenience system filesystem accessor methods on FileUtil</summary>

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

            <date day="20" month="3" year="2007"/>

            <author login="tboudreau"/>

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

            <description>

                <p>

                    Convenience methods added for looking up files/folders in

                    the system filesystem.  Rather than having to call

                    <code>Respository.getDefault().getDefaultFileSystem().getRoot().getFileObject(&quot;foo/bar&quot;)</code>,

                    you can simply call <code>FileUtil.getConfigurationFolder (&quot;foo/bar&quot;, false)</code>.

                    <a href="@TOP@/org/openide/filesystems/FileUtil.html#getConfigurationFolder(java.lang.String, boolean)">FileUtil.getConfigurationFolder(path)</a>s

                    and 

                    <a href="@TOP@/org/openide/filesystems/FileUtil.html#getConfigurationFile(java.lang.String, boolean)">FileUtil.getConfigurationFile(path)</a>

                    were added to the API.

                </p>

            </description>

            <class package="org.openide.filesystems" name="Repository"/>

            <issue number="91534"/>

        </change>

    /**

     * Get a data file or folder from the System (configuration) Filesystem 

     * with the specified file path.

     * 

     * @param path The path from the root of the System Filesystem to the file,

     *        including its name and extension.  

     * @return A FileObject for that file in the system filesystem

     */ 

    public static FileObject getConfigurationFile (String path) {

        if (path == null) {

            throw new NullPointerException ("Null path to file"); //NOI18N

        }

        FileSystem sfs = Repository.getDefault().getDefaultFileSystem();

        FileObject root = sfs.getRoot();

        FileObject result = root.getFileObject(path);

        assert result == null || result.isData() : "Not a data file: " + path; //NOI18N

        return result;

    }

    /**

     * Get a data file or folder from the System (configuration) Filesystem 

     * with the specified file path, creating a new empty file if the specified

     * file does not exist.

     * 

     * @param path The path from the root of the System Filesystem to the file,

     *        including its name and extension.  

     * @return A FileObject for that file in the system filesystem

     * @throws IOException if the file did not previously exist and could not be

     *        created for some reason

     */ 

    public static FileObject getOrCreateConfigurationFile (String path) throws 

                                                                   IOException {

        FileObject result = getConfigurationFile (path);

        if (result == null) {

            FileSystem sfs = Repository.getDefault().getDefaultFileSystem();

            FileObject root = sfs.getRoot();

            result = createData(root, path);

        }

        return result;

    }

    /**

     * Get a folder in the System (configuration) Filesystem with the

     * specified file path.

     * 

     * @param path The path from the root of the System Filesystem to the folder.

     *        If the path is the empty string, returns the root of the 

     *        system filesystem (do not use "/" for the root).

     * @return A FileObject representing a new file created with the specified

     *        path, or one representing the existing file if the file already

     *        was present, or null if an I/O error occurred when trying to

     *        create a non-existent folder

     */ 

    public static FileObject getConfigurationFolder (String path) {

        if (path == null) {

            throw new NullPointerException ("Null path"); //NOI18N

        }

        FileSystem sfs = Repository.getDefault().getDefaultFileSystem();

        FileObject root = sfs.getRoot();

        FileObject result = path.length() == 0 ? //NOI18N

            root : root.getFileObject(path);

        assert result == null || result.isFolder() : "Not a folder: " + path; //NOI18N

        return result;

    }

    /**

     * Get a folder in the System (configuration) Filesystem with the

     * specified file path, creating it if necessary.

     * 

     * @param path The path from the root of the System Filesystem to the folder.

     *        If the path is the empty string, returns the root of the 

     *        system filesystem (do not use "/" for the root).

     * @return A FileObject representing a new file created with the specified

     *        path, or one representing the existing file if the file already

     *        was present, or null if an I/O error occurred when trying to

     *        create a non-existent folder

     * @throws IOException if an error occurs creating the folder

     */ 

    public static FileObject getOrCreateConfigurationFolder (String path) throws IOException {

        FileObject result = getConfigurationFolder(path);

        if (result == null) {

            FileSystem sfs = Repository.getDefault().getDefaultFileSystem();

            FileObject root = sfs.getRoot();

            result = createFolder (root, path);

        }

        return result;

    }

import java.io.IOException;

import org.netbeans.junit.MockServices;

    protected String[] getResources(String testName) {

        return new String[] { "somefolder/somefile.txt" };

    }

    public void testGetConfigurationData() throws Exception {

        System.out.println("testGetConfigurationData");

        FileObject f = FileUtil.getOrCreateConfigurationFolder("folder");

        assertNotNull (f);

        FileObject f1 = FileUtil.getOrCreateConfigurationFile ("folder/file.txt");

        assertNotNull (f1);

        assertEquals (f1, f.getFileObject ("file.txt"));

    }

    public void testCreateConfigurationFile() throws Exception {

        System.out.println("testCreateConfigurationFile");

        FileObject f = FileUtil.getOrCreateConfigurationFile("somewhere/file2.txt");

        assertNotNull (f);

        FileObject f1 = FileUtil.getOrCreateConfigurationFile ("somewhere/file2.txt");

        assertNotNull (f1);

        assertEquals (f, f1);

            f = FileUtil.getOrCreateConfigurationFolder ("somewhere");

        assertEquals (f, f1.getParent());

        f = FileUtil.getOrCreateConfigurationFolder("folder");

        FileObject nue = f.createData ("hello.txt");

        assertEquals (nue, FileUtil.getOrCreateConfigurationFile("folder/hello.txt"));

        assertNotNull (f.getFileObject ("hello.txt"));

        assertTrue (f.getFileObject ("hello.txt").isData());

        assertFalse (f.getFileObject ("hello.txt").isFolder());

    }

    public void testCreateConfigurationFolder() throws Exception {

        System.out.println("testCreateConfigurationFolder");

        FileObject f = FileUtil.getOrCreateConfigurationFolder ("other");

        assertNotNull (f);

        FileObject f1 = FileUtil.getOrCreateConfigurationFolder("other");

        assertEquals (f, f1);

    }

    public static class MyRepo extends Repository {

        static FileSystem sysfs;

        public MyRepo () {

            super(sysfs = FileUtil.createMemoryFileSystem());

            try {

                FileObject fld = sysfs.getRoot().createFolder("folder");

                fld.createData("file.txt");

            } catch (IOException ioe) {

                throw new Error (ioe);

            }

        }

    }