import org.openide.modules.InstalledFileLocator;

            InstalledFileLocator ifl = InstalledFileLocator.getDefault();

            String arch = System.getProperty("os.arch"); // NOI18N

            String system = System.getProperty("os.name").toLowerCase(); // NOI18N

/*

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

 * 

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

 */

package org.netbeans;

import java.io.File;

import java.io.IOException;

import java.util.HashMap;

import java.util.Map;

import java.util.StringTokenizer;

import org.netbeans.junit.NbTestCase;

import org.netbeans.junit.MockServices;

import org.openide.modules.InstalledFileLocator;

import org.openide.util.lookup.ServiceProvider;

/**

 * A test covering native library lookup mechanism.

 * @see http://bits.netbeans.org/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/api.html#jni

 *

 * @author Petr Nejedly <pnejedly@netbeans.org>

 */

public class NativeLibraryTest extends NbTestCase {

    private File userdir;

    private File ide;

    private File platform;

    private File install;

    private File jar;

    private Module module;

    File fullLib;

    File archLib;

    File commonLib;

    public NativeLibraryTest(String testName) {

        super(testName);

    }            

    @Override

    protected void setUp() throws Exception {

//        MockServices.setServices(TestLocator.class);

        clearWorkDir();

        String arch = System.getProperty("os.arch"); // NOI18N

        String system = System.getProperty("os.name").toLowerCase(); // NOI18N

        install = new File(getWorkDir(), "install");

        platform = new File(install, "platform");

        ide = new File(install, "ide");

        userdir = new File(getWorkDir(), "tmp");

        System.setProperty("netbeans.home", platform.getPath());

        System.setProperty("netbeans.dirs", ide.getPath());

        System.setProperty("netbeans.user", userdir.getPath());

        jar = createModule("org.openide.sample", platform,

            "OpenIDE-Module-Public-Packages", "-",

            "OpenIDE-Module", "org.openide.sample"

        );

        root = jar.getParentFile().getParentFile();

        // now create 3 libraries, full, arch and common

        fullLib = createFakeLibrary(jar, arch, system, System.mapLibraryName("full"));

        archLib = createFakeLibrary(jar, arch, System.mapLibraryName("arch"));

        commonLib = createFakeLibrary(jar, System.mapLibraryName("common"));

        // and create some honeypots for validating the search order

        createFakeLibrary(jar, arch, system, System.mapLibraryName("arch"));

        createFakeLibrary(jar, arch, system, System.mapLibraryName("common"));

        createFakeLibrary(jar, arch, System.mapLibraryName("common"));

        MockModuleInstaller installer = new MockModuleInstaller();

        MockEvents ev = new MockEvents();

        ModuleManager mgr = new ModuleManager(installer, ev);

        mgr.mutexPrivileged().enterWriteAccess();

        module = mgr.create(jar, null, false, false, false);

        mgr.enable(module);

        mgr.mutexPrivileged().exitWriteAccess();

    }

    public void testLocateLibrary() {

        // testing 

        StandardModule.OneModuleClassLoader ldr = (StandardModule.OneModuleClassLoader)module.getClassLoader();

        assertEquals(fullLib.getAbsolutePath(), ldr.findLibrary("full"));

        assertEquals(archLib.getAbsolutePath(), ldr.findLibrary("arch"));

        assertEquals(commonLib.getAbsolutePath(), ldr.findLibrary("common"));

        assertNull(ldr.findLibrary("none"));

    }

    private File createFakeLibrary(File jar, String... path) throws IOException {

        File out = new File(jar.getParentFile(), "lib");

        for(String component : path) out = new File(out, component);

        // prepare the path

        out.getParentFile().mkdirs();

        out.createNewFile();

        return out;

    }

    private File createModule(String cnb, File cluster, String... attr) throws IOException {

        String dashes = cnb.replace('.', '-');

        File tmp = new File(new File(cluster, "modules"), dashes + ".jar");

        Map<String,String> attribs = new HashMap<String, String>();

        for (int i = 0; i < attr.length; i += 2) {

            attribs.put(attr[i], attr[i + 1]);

        }

        Map<String,String> files = new HashMap<String, String>();

        files.put("fake/" + cnb, cnb);

        tmp.getParentFile().mkdirs();

        SetupHid.createJar(tmp, files, attribs);

        return tmp;

    }

    static File root;

    @ServiceProvider(service=InstalledFileLocator.class)

    public static final class TestLocator extends InstalledFileLocator {

        public TestLocator() {

        }

        public File locate(String relativePath, String codeNameBase, boolean localized) {

            StringTokenizer tk = new StringTokenizer(relativePath,"/");

            File f = root;

            while (tk.hasMoreTokens()) {

                String part = tk.nextToken();

                f = new File (f,part);

                if (!f.exists()) {

                    return null;

                }

            }

            return f;

        }

    }

}

    <change id="ClassLoader.findLibrary">

        <api name="modules"/>

        <summary>Documented the new native library lookup mechanism</summary>

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

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

        <author login="pnejedly"/>

        <compatibility addition="yes"/>

        <description>

            <p>

                You can now distribute native libraries into architecture

                and OS specific directories under <samp>modules/lib</samp>

                as documented in the <a href="@TOP@/org/openide/modules/doc-files/api.html#jni">documentation</a>.

                The functionality is actually provided by the

                org.netbeans.bootstrap module as of version 2.33, which will be

                part of NetBeans 6.9 release.

            </p>

        </description>

        <issue number="186000"/>

    </change>