<change id="UpdateAllResources">

         <api name="exec-property"/>

         <summary>Disable creation of resources cache</summary>

         <version major="1" minor="XXX"/>

         <date day="1" month="4" year="2013"/>

         <author login="jtulach"/>

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

         <description>

             <p>

                 New <a href="architecture-summary.html#branding-UpdateAllResources">branding API

                 </a> to control creation of <code>all-resources.data</code> cache

                 after start.

             </p>

         </description>

         <issue number="227802"/>

     </change>

      <api name="UpdateAllResources" category="devel" type="export" group="branding">

          <p>

          Some applications built on top of NetBeans Platform expressed

          an option that certain files in caches, namely <code>all-resources.dat</code>

          can be too big and that this is not good for multi-user installation.

          To give such applications control over creation of this file, there

          is a branding token (conditionally) disable the creation of the cache file.

          </p>

          <p>

          Rebrand value of <code>UpdateAllResources</code> key in

          <code>org.netbeans.core.startup.Bundle</code> resource bundle.

          Set it to <code>never</code>, <code>always</code> or <code>missing</code>.

          The default is to regenerate and update the cache <em>always</em>. 

          Value <em>missing</em> means to generate

          the cache only if it has not been previously available (even in 

          installation location). Setting the value to <em>never</em> will

          never disable the creation of the cache after start completely.

          </p>

      </api>

# possible values: always, never, missing

#NOI18N

UpdateAllResources=always

import java.util.MissingResourceException;

    static boolean updateAllResources() {

        String value = NbBundle.getMessage(Main.class, "UpdateAllResources"); // NOI18N

        if (!"never".equals(value)) { // NOI18N

            if ("missing".equals(value)) { // NOI18N

                if (!org.netbeans.JarClassLoader.isArchivePopulated()) {

                    org.netbeans.JarClassLoader.saveArchive();

                    return true;

                }

            } else {

                assert "always".equals(value); // NOI18N

                org.netbeans.JarClassLoader.saveArchive();

                return true;

            }

        }

        return false;

    }

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

#

# Copyright 1997-2010 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]"

#

# Contributor(s):

#

# The Original Software is NetBeans. The Initial Developer of the Original

# Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun

# Microsystems, Inc. All Rights Reserved.

#

# 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.

UpdateAllResources=missing

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

#

# Copyright 1997-2010 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]"

#

# Contributor(s):

#

# The Original Software is NetBeans. The Initial Developer of the Original

# Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun

# Microsystems, Inc. All Rights Reserved.

#

# 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.

UpdateAllResources=never

/*

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

 *

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

 */

package org.netbeans.core.startup;

import java.lang.reflect.Constructor;

import java.lang.reflect.Field;

import java.lang.reflect.Method;

import static junit.framework.Assert.assertTrue;

import org.netbeans.JarClassLoader;

import org.netbeans.Stamps;

import org.netbeans.junit.NbTestCase;

import org.openide.util.NbBundle;

/**

 *

 * @author Jaroslav Tulach <jtulach@netbeans.org>

 */

public class UpdateAllResourcesTest extends NbTestCase{

    public UpdateAllResourcesTest(String name) {

        super(name);

    }

    @Override

    protected void setUp() throws Exception {

        NbBundle.setBranding("any");

        clearWorkDir();

        System.setProperty("netbeans.user", getWorkDirPath());

        resetStamps();

    }

    public void testByDefaultTheArchiveIsUpdated() {

        assertTrue("Update was scheduled", Main.updateAllResources());

    }

    public void testNeverUpdate() {

        NbBundle.setBranding("ar_never");

        assertFalse("Update was not", Main.updateAllResources());

    }

    public void testUpdateAsNotPopulated() {

        NbBundle.setBranding("ar_missing");

        assertFalse("No previous all-resources.dat", JarClassLoader.isArchivePopulated());

        assertTrue("Performs the update", Main.updateAllResources());

    }

    public void testDontUpdateWhenPopulated() throws Exception {

        NbBundle.setBranding("ar_missing");

        populateCache();

        assertFalse("No need to update, everything is populated", Main.updateAllResources());

    }

    private static void populateCache() throws Exception {

        Method init = JarClassLoader.class.getDeclaredMethod("initializeCache");

        init.setAccessible(true);

        init.invoke(null);

        Field fld = JarClassLoader.class.getDeclaredField("archive");

        fld.setAccessible(true);

        Object obj = fld.get(null);

        assertNotNull("Archive is initialized", obj);

        Constructor<? extends Object> cnstr = obj.getClass().getDeclaredConstructor(boolean.class);

        cnstr.setAccessible(true);

        fld.set(null, cnstr.newInstance(true));

        assertTrue("Previous all-resources.dat", JarClassLoader.isArchivePopulated());

    }

    private static void resetStamps() throws Exception {

        final Method m = Stamps.class.getDeclaredMethod("main", String[].class);

        m.setAccessible(true);

        m.invoke(null, (Object) new String[]{"reset"});

    }

}

    Archive(boolean prep) {

        gathering = false;

        active = false;

        prepopulated = prep;

    }

    final boolean isPopulated() {

        return prepopulated;

    }

    /** Check whether the archive has already been populated during 

     * previous executions.

     * 

     * @return true, if the archive is ready and non-empty

     * @since 1.XXX

     */

    public static boolean isArchivePopulated() {

        return archive != null && archive.isPopulated();

    }