* Attempts to discover locations for migrated files in configuration.

     * 

     * 

     * @see Utilities#translate

            if (target == null) {

                FileObject cfgRoot = FileUtil.getConfigRoot();

                URI cfgURI = cfgRoot.toURI();

                String prefix = cfgURI.toString();

                String urlText = u.toString();

                // try to recover a broken shadow by translation, but only for 

                // configuration

                if (urlText.startsWith(prefix)) {

                    String rootPathFragment = cfgURI.getRawPath();

                    // get the file part with all the URL escaping, escapes e.g. # and = characters.

                    String cfgPart = u.getRawPath().substring(rootPathFragment.length());

                    String translated = Utilities.translate(cfgPart);

                    if (!translated.equals(cfgPart)) {

                        String translatedPath = rootPathFragment + translated;

                        URI newURI;

                        try {

                            // have URI parse the text, we'll extract the path component

                            URI temp = URI.create("scheme://host" + translatedPath); // NOI18N

                            newURI = new URI(u.getScheme(), u.getAuthority(), temp.getPath(), u.getFragment());

                            target = URLMapper.findFileObject(newURI.toURL());

                        } catch (URISyntaxException ex) {

                            LOG.log(Level.WARNING, "Could not form URI from {0}: {1}", new Object[] { translatedPath, ex });

                        }

                    }

                }

            }

            boolean sfs;

                sfs = true;

                sfs = false;

                sfs = true;

            // defect #208779 - if target is not found on SFS, try to translate the path:

            if (sfs && target == null) {

                // encode the path:

                URI cfgRootURI = FileUtil.getConfigRoot().toURI();

                try {

                    URI uri = new URI(null, null, "/" + path, null, null); // NOI18N

                    String rawPath = uri.toASCIIString().substring(1);

                    String translated = Utilities.translate(rawPath);

                    if (!rawPath.equals(translated)) {

                        // decode translated path back:

                        URI translatedUri = cfgRootURI.relativize(cfgRootURI.resolve(translated));

                        target = FileUtil.getConfigFile(translatedUri.getPath());

                    }

                } catch (URISyntaxException ex) {

                    LOG.log(Level.WARNING, "Could not form URI from {0}: {1}", new Object[] { path, ex });

                }

            }

origFolder/regularFileName.txt.old=origFolder/regularFileName.txt

%C5%BDlu%C5%A5ou%C4%8Dk%C3%BD%20p%C5%99em%C3%ADst%C4%9Bn%C3%BD%20soubor%23333:ee.e=origFolder2/%C4%8Cesk%C3%A1%20%C5%BElu%C5%A5ou%C4%8Dk%C3%A1%20akce%20%23234:bubu.txt

%C5%BDlu%C5%A5ou%C4%8Dk%C3%BD%20p%C5%99em%C3%ADst%C4%9Bn%C3%BD%20soubor%23333:ee.e3=origFolder3/%C4%8Cesk%C3%A1%20%C5%BElu%C5%A5ou%C4%8Dk%C3%A1%20akce%20%23234:bubu.txt

/*

 * 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.modules.openide.loaders;

import java.io.*;

import java.net.URI;

import java.net.URL;

import java.net.URLClassLoader;

import org.netbeans.junit.NbTestCase;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileSystem.AtomicAction;

import org.openide.filesystems.FileUtil;

import org.openide.loaders.DataObject;

import org.openide.loaders.DataShadow;

import org.openide.util.Lookup;

import org.openide.util.test.MockLookup;

import org.openide.util.test.TestFileUtils;

/**

 * See defect #208779 - DataShadows should update themselves iff they could not find 

 * the target.

 * 

 * @author sdedic

 */

public class DataShadowTranslateTest extends NbTestCase {

    public DataShadowTranslateTest(String name) {

        super(name);

    }

    /**

     * Checks that file with just regular characters in name is translated OK

     * @throws Exception 

     */

    public void testRegularURI() throws Exception {

        FileObject fo = FileUtil.getConfigRoot();

        FileObject origDir = fo.createFolder("origFolder");

        FileObject newFile = origDir.createData("regularFileName.txt");

        final FileObject d = fo.createFolder("subfolder");

        OutputStream ostm = d.createAndOpen("regularShadowURI.shadow");

        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(ostm));

        URI uri = newFile.toURI();

        String urlString = newFile.toURI().toASCIIString();

        bw.write(urlString + ".old");

        bw.newLine();

        bw.newLine();

        bw.close();

        FileObject fob = d.getFileObject("regularShadowURI.shadow");

        DataObject dd = DataObject.find(fob);

        assertTrue("Shadow must be translated, not broken", dd instanceof DataShadow);

        DataShadow ds = (DataShadow)dd;

        assertEquals("Shadow's original must be on the translated location", newFile, ds.getOriginal().getPrimaryFile());

    }

    /**

     * Checks that file with national and special characters in name is processed OK

     * 

     * @throws Exception 

     */

    public void testUriWithSpecialChars() throws Exception {

        FileObject fo = FileUtil.getConfigRoot();

        FileObject origDir = fo.createFolder("origFolder2");

        // create empty real file with special and non-ASCII chars

        FileObject newFile = origDir.createData("Česká žluťoučká akce #234:bubu.txt");

        // createa a fake file, just to get its URI right:

        FileObject fake = fo.createData("Žluťoučký přemístěný soubor#333:ee.e");

        String deprecatedURI = fake.toURI().toASCIIString();

        fake.delete();

        final FileObject d = fo.createFolder("subfolder2");

        OutputStream ostm = d.createAndOpen("regularShadowURI.shadow");

        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(ostm));

        URI uri = newFile.toURI();

        bw.write(deprecatedURI);

        bw.newLine();

        bw.newLine();

        bw.close();

        FileObject fob = d.getFileObject("regularShadowURI.shadow");

        DataObject dd = DataObject.find(fob);

        assertTrue("Shadow must be translated, not broken", dd instanceof DataShadow);

        DataShadow ds = (DataShadow)dd;

        assertEquals("Shadow's original must be on the translated location", newFile, ds.getOriginal().getPrimaryFile());

    }

    public void testFSNameAndPath() throws Exception {

        FileObject fo = FileUtil.getConfigRoot();

        FileObject origDir = fo.createFolder("origFolder3");

        // create empty real file with special and non-ASCII chars

        FileObject newFile = origDir.createData("Česká žluťoučká akce #234:bubu.txt");

        // createa a fake file, just to get its URI right:

        FileObject fake = fo.createData("Žluťoučký přemístěný soubor#333:ee.e3");

        final FileObject d = fo.createFolder("subfolder3");

        OutputStream ostm = d.createAndOpen("regularShadowURI.shadow");

        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(ostm));

        bw.write(fake.getPath());

        bw.newLine();

        bw.write(fake.getFileSystem().getSystemName());

        bw.newLine();

        fake.delete();

        bw.close();

        FileObject fob = d.getFileObject("regularShadowURI.shadow");

        DataObject dd = DataObject.find(fob);

        assertTrue("Shadow must be translated, not broken", dd instanceof DataShadow);

        DataShadow ds = (DataShadow)dd;

        assertEquals("Shadow's original must be on the translated location", newFile, ds.getOriginal().getPrimaryFile());

    }

    /**

     * Checks that DataShadows to regular (non-SFS) files are not translated

     * even if a translation is defined for their path

     * 

     * @throws Exception 

     */

    public void testNonSFSUriNotAffected() throws Exception {

        File wd = getWorkDir();

        clearWorkDir();

        FileObject origDir = FileUtil.toFileObject(wd);

        FileObject dirWithSpace = origDir.createFolder("Space Dir");

        FileObject newFile = dirWithSpace.createData("testFile.txt");

        File subDir = new File(wd, "translate");

        subDir.mkdirs();

        File metaTranslate = new File(subDir, "META-INF/netbeans");

        metaTranslate.mkdirs();

        String workPath = newFile.toURI().getRawPath();

        FileWriter wr = new FileWriter(new File(metaTranslate, "translate.names"));

        BufferedWriter bw = new BufferedWriter(wr);

        bw.write(workPath.substring(1) + "/testFile.txt=" + workPath.substring(1) + "/moved/testFile.txt");

        bw.close();

        FileObject fo = FileUtil.toFileObject(wd);

        ClassLoader orig = Lookup.getDefault().lookup(ClassLoader.class);

        ClassLoader my = new URLClassLoader(new URL[] {

            subDir.toURL()

        }, orig);

        MockLookup.setInstances(my);

        FileObject cfgRoot = FileUtil.getConfigRoot();

        OutputStream ostm = cfgRoot.createAndOpen("nonSFSFile.shadow");

        bw = new BufferedWriter(new OutputStreamWriter(ostm));

        bw.write(newFile.toURI().toASCIIString());

        bw.newLine();

        bw.newLine();

        newFile.delete();

        bw.close();

        FileObject fob = cfgRoot.getFileObject("nonSFSFile.shadow");

        DataObject dd = DataObject.find(fob);

        assertFalse("Shadow must be still broken", dd instanceof DataShadow);

    }

}

     * <p/>

     * Similar behaviour applies to <b>filenames</b> provided by layers (system filesystem). Filenames

     * can be also translated to adapt to location changes e.g. in action registrations.

     *

     * <pre>

     * # registration ID has changed

     * Actions/Refactoring/RefactoringWhereUsed.instance=Actions/Refactoring/org-netbeans-modules-refactoring-api-ui-WhereUsedAction.instance

     * </pre>