<file name="templateTopComponent637.java" url="../wizard/winsys/templateTopComponent637.javx"/>

        boolean xmlLessTC;

            xmlLessTC = current == null || current.compareTo(new SpecificationVersion("6.37")) >= 0; // NOI18N

            xmlLessTC = false;

<#assign licenseFirst = "/*">

<#assign licensePrefix = " * ">

<#assign licenseLast = " */">

<#include "../Licenses/license-${project.license}.txt">

package ${PACKAGENAME};

import org.openide.util.NbBundle;

import org.openide.windows.TopComponent;

import org.openide.windows.WindowManager;

import org.netbeans.api.settings.ConvertAsProperties;

import org.openide.awt.ActionID;

import org.openide.awt.ActionReference;

<#assign PREFFERED_ID="${TEMPLATENAME}TopComponent"/>

/**

 * Top component which displays something.

 */

@ConvertAsProperties(

    dtd="-//${PACKAGENAME}//${TEMPLATENAME}//EN",

    autostore=false

)

@TopComponent.Description(

    preferredID="${PREFFERED_ID}", 

    ${COMMENTICON}iconBase="${ICONPATH}", 

    persistenceType=TopComponent.PERSISTENCE_ALWAYS

)

public final class ${TEMPLATENAME}TopComponent extends TopComponent {

    private static ${TEMPLATENAME}TopComponent instance;

    public ${TEMPLATENAME}TopComponent() {

        initComponents();

        setName(NbBundle.getMessage(${TEMPLATENAME}TopComponent.class, "CTL_${TEMPLATENAME}TopComponent"));

        setToolTipText(NbBundle.getMessage(${TEMPLATENAME}TopComponent.class, "HINT_${TEMPLATENAME}TopComponent"));

${WINSYSBEHAVIOR}

    }

    /** This method is called from within the constructor to

     * initialize the form.

     * WARNING: Do NOT modify this code. The content of this method is

     * always regenerated by the Form Editor.

     */

    // <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents

    private void initComponents() {

        javax.swing.GroupLayout layout = new javax.swing.GroupLayout(this);

        this.setLayout(layout);

        layout.setHorizontalGroup(

            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)

            .addGap(0, 400, Short.MAX_VALUE)

        );

        layout.setVerticalGroup(

            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)

            .addGap(0, 300, Short.MAX_VALUE)

        );

    }// </editor-fold>//GEN-END:initComponents

    // Variables declaration - do not modify//GEN-BEGIN:variables

    // End of variables declaration//GEN-END:variables

    @TopComponent.Registration(mode = "${MODE}", openAtStartup = ${OPENED})

    @ActionID(category = "Windows", id = "${PACKAGENAME}.${TEMPLATENAME}TopComponent")

    @ActionReference(path = "Menu/Window"

        //, position = 333

    )

    @TopComponent.OpenActionRegistration(

        displayName = "#CTL_${TEMPLATENAME}Action",

        preferredID="${PREFFERED_ID}"

    )

    private static synchronized ${TEMPLATENAME}TopComponent create() {

        if (instance == null) {

            instance = new ${TEMPLATENAME}TopComponent();

        }

        return instance;

    }

    /** Search logic for the ${TEMPLATENAME}TopComponent instance. 

    public static synchronized ${TEMPLATENAME}TopComponent findInstance() {

        final String PREFERRED_ID = ${TEMPLATENAME}TopComponent.class.getAnnotation(TopComponent.Description.class).preferredID();

        TopComponent win = WindowManager.getDefault().findTopComponent(PREFERRED_ID);

        if (win == null) {

            Logger.getLogger(${TEMPLATENAME}TopComponent.class.getName()).warning(

                    "Cannot find " + PREFERRED_ID + " component. It will not be located properly in the window system.");

            return create();

        }

        if (win instanceof ${TEMPLATENAME}TopComponent) {

            return (${TEMPLATENAME}TopComponent)win;

        }

        Logger.getLogger(${TEMPLATENAME}TopComponent.class.getName()).warning(

                "There seem to be multiple components with the '" + PREFERRED_ID +

                "' ID. That is a potential source of errors and unexpected behavior.");

        return create();

    }

    */

    @Override

    public void componentOpened() {

        // TODO add custom code on component opening

    }

    @Override

    public void componentClosed() {

        // TODO add custom code on component closing

    }

    void writeProperties(java.util.Properties p) {

        // better to version settings since initial version as advocated at

        // http://wiki.apidesign.org/wiki/PropertyFiles

        p.setProperty("version", "1.0");

        // TODO store your settings

    }

    Object readProperties(java.util.Properties p) {

        if (instance == null) {

            instance = this;

        }

        instance.readPropertiesImpl(p);

        return instance;

    }

    private void readPropertiesImpl(java.util.Properties p) {

        String version = p.getProperty("version");

        // TODO read your settings according to their version

    }

}

<change id="topcomponent.registration">

    <api name="winsys"/>

    <summary>Register default TopComponent location via annotations</summary>

    <version major="6" minor="37"/>

    <date day="30" month="11" year="2010"/>

    <author login="jtulach"/>

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

    <description>

        Use <a href="@TOP@/org/openide/windows/TopComponent.Registration.html">TopComponent.Registration</a>,

        <a href="@TOP@/org/openide/windows/TopComponent.Description.html">TopComponent.Description</a> and

        <a href="@TOP@/org/openide/windows/TopComponent.OpenActionRegistration.html">TopComponent.OpenActionRegistration</a>

        to register default location of a 

        <a href="@TOP@/org/openide/windows/TopComponent.html">TopComponent</a>,

        some of its properties and action to open it.

    </description>

    <class package="org.openide.windows" name="TopComponent"/>

    <issue number="191407"/>

</change>

                    <code-name-base>org.openide.filesystems</code-name-base>

                    <build-prerequisite/>

                    <compile-dependency/>

                </dependency>

                <dependency>

/*

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

 *

 * Copyright 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]"

 *

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

import java.util.HashSet;

import java.util.Set;

import javax.annotation.processing.Processor;

import javax.annotation.processing.RoundEnvironment;

import javax.annotation.processing.SupportedSourceVersion;

import javax.lang.model.SourceVersion;

import javax.lang.model.element.Element;

import javax.lang.model.element.TypeElement;

import javax.lang.model.type.DeclaredType;

import javax.lang.model.type.ExecutableType;

import org.openide.awt.ActionID;

import org.openide.filesystems.annotations.LayerBuilder.File;

import org.openide.filesystems.annotations.LayerGeneratingProcessor;

import org.openide.filesystems.annotations.LayerGenerationException;

import org.openide.util.lookup.ServiceProvider;

import org.openide.windows.TopComponent;

import org.openide.windows.TopComponent.Description;

@SupportedSourceVersion(SourceVersion.RELEASE_6)

@ServiceProvider(service=Processor.class)

public final class TopComponentProcessor extends LayerGeneratingProcessor {

    public TopComponentProcessor() {

    }

    @Override

    public Set<String> getSupportedAnnotationTypes() {

        Set<String> hash = new HashSet<String>();

        hash.add(TopComponent.Registration.class.getCanonicalName());

        hash.add(TopComponent.OpenActionRegistration.class.getCanonicalName());

        hash.add(TopComponent.Description.class.getCanonicalName());

        return hash;

    }

    @Override

    protected boolean handleProcess(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) throws LayerGenerationException {

        for (Element e : roundEnv.getElementsAnnotatedWith(TopComponent.Registration.class)) {

            TopComponent.Registration reg = e.getAnnotation(TopComponent.Registration.class);

            assert reg != null;

            Description info = findInfo(e);

            String id = info.preferredID().replace('.', '-');

            File settingsFile = layer(e).

                file("Windows2/Components/" + id + ".settings").

                contents(settingsFile(e));

            settingsFile.write();

            File modeFile = layer(e).

                file("Windows2/Modes/" + reg.mode() + "/" + id + ".wstcref").

                contents(modeFile(info.preferredID(), reg.openAtStartup()));

            modeFile.write();

        }

        for (Element e : roundEnv.getElementsAnnotatedWith(TopComponent.OpenActionRegistration.class)) {

            TopComponent.OpenActionRegistration reg = e.getAnnotation(TopComponent.OpenActionRegistration.class);

            assert reg != null;

            Description info = findInfo(e);

            ActionID aid = e.getAnnotation(ActionID.class);

            if (aid != null) {

                File actionFile = layer(e).

                    file("Actions/" + aid.category() + "/" + aid.id().replace('.', '-') + ".instance").

                    methodvalue("instanceCreate", "org.openide.windows.TopComponent", "openAction");

                actionFile.instanceAttribute("component", TopComponent.class);

                if (reg.preferredID().length() > 0) {

                    actionFile.stringvalue("preferredID", reg.preferredID());

                }

                actionFile.bundlevalue("displayName", reg.displayName());

                if (info != null && info.iconBase().length() > 0) {

                    actionFile.stringvalue("iconBase", info.iconBase());

                }

                actionFile.write();

            }

        }

        return true;

    }

    private Description findInfo(Element e) throws LayerGenerationException {

        Element type;

        switch (e.asType().getKind()) {

            case DECLARED: type = e; break;

            case EXECUTABLE: type = ((DeclaredType)((ExecutableType)e.asType()).getReturnType()).asElement(); break;

            default: throw new LayerGenerationException("" + e.asType().getKind(), e);    

        }

        TopComponent.Description info = type.getAnnotation(TopComponent.Description.class);

        return info;

    }

    private static String settingsFile(Element e) throws LayerGenerationException {

        String clazz, method;

        switch (e.getKind()) {

            case CLASS: clazz = e.toString(); method = null; break;

            case METHOD: clazz = e.getEnclosingElement().toString(); method = e.getSimpleName().toString(); break;

            default:

                throw new LayerGenerationException("Cannot work on given element", e);

        }

        StringBuilder sb = new StringBuilder();

        sb.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");

        sb.append("<!DOCTYPE settings PUBLIC \"-//NetBeans//DTD Session settings 1.0//EN\" \"http://www.netbeans.org/dtds/sessionsettings-1_0.dtd\">\n");

        sb.append("<settings version=\"1.0\">\n");

        sb.append("  <instance class=\"").append(clazz).append("\"");

        if (method != null) {

            sb.append(" method=\"").append(method).append("\"");

        }

        sb.append("/>\n");

        sb.append("</settings>\n");

        return sb.toString();

    }

    private static String modeFile(String id, boolean openAtStart) 

    throws LayerGenerationException {

        StringBuilder sb = new StringBuilder();

        sb.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");

        sb.append("<!DOCTYPE tc-ref PUBLIC \"-//NetBeans//DTD Top Component in Mode Properties 2.0//EN\" \"http://www.netbeans.org/dtds/tc-ref2_0.dtd\">\n");

        sb.append("<tc-ref version=\"2.0\">\n");

        sb.append("  <tc-id id=\"").append(id).append("\"/>\n");

        sb.append("  <state opened=\"").append(openAtStart).append("\"/>\n");

        sb.append("</tc-ref>\n");

        return sb.toString();

    }

}

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

import org.openide.awt.ActionID;

import org.openide.util.ImageUtilities;

     * Rather than overriding this method, consider using {@link Description}.

        Description info = getClass().getAnnotation(Description.class); 

        if (info != null) {

            return info.persistenceType();

        }

     *   <!-- if desired: <attr name="preferredID" stringvalue="id.of.your.tc"/> -->

     * The <code>preferredID</code> attribute is supported since version

     * 6.37. If specified the action first seeks for existing <code>preferredID</code>

     * component and if found, it opens and activates it.

     * <p>

     * Rather than doing all this in XML, consider using {@link OpenActionRegistration}.

     * 

     * @see OpenActionRegistration

     * Rather than overriding this method, consider using {@link Description}.

        Description id;

        if (icon == null && (id = getClass().getAnnotation(Description.class)) != null) {

            icon = ImageUtilities.loadImage(id.iconBase(), true);

        }

    /** Provides basic information about the persistence of a {@link TopComponent}.

     * Using this annotation is preferred to overriding {@link #preferredID()}

     * or calling {@link #setIcon(java.awt.Image)}.

     * @since 6.37

     */

    @Retention(RetentionPolicy.RUNTIME)

    @Target(ElementType.TYPE)

    public static @interface Description {

        /** The default value for {@link TopComponent#preferredID()}.

         */

        public String preferredID();

        /** The icon to load for {@link TopComponent#getIcon()}.

         */

        public String iconBase() default "";

        /** Default value for {@link TopComponent#getPersistenceType()}. 

         * 

         * @return one of {@link TopComponent#PERSISTENCE_ALWAYS}, 

         * {@link TopComponent#PERSISTENCE_NEVER}, 

         * {@link TopComponent#PERSISTENCE_ONLY_OPENED}

         * 

         */

        public int persistenceType() default PERSISTENCE_ALWAYS;

    }

    /** Registers {@link TopComponent} into specified location among

     * existing {@link Mode window system modes}. The mode itself needs 

     * to be created by other means, this just adds reference to the

     * component to it.

     * 

     * @since 6.37

     */

    @Retention(RetentionPolicy.SOURCE)

    @Target({ ElementType.TYPE, ElementType.METHOD })

    public static @interface Registration {

        /** Name of the mode the component shall be opened in */

        String mode();

        /** Shall the component be opened at start */

        boolean openAtStartup();

    }

    /** Creates an action that can open the component.

     * The action is generated only

     * if {@link ActionID} annotation is used on the same element, otherwise

     * a compilation error is raised. Also the {@link Description} shall be

     * present.

     * @since 6.37

     */

    @Retention(RetentionPolicy.SOURCE)

    @Target({ ElementType.TYPE, ElementType.METHOD })

    public static @interface OpenActionRegistration {

        /** Display name of the action, usually can refer to value from a

         * <code>Bundle.properties</code> using <code>#KEY</code>.

         */

        String displayName();

        /** The identification of an existing component to seek for.

         */

        String preferredID() default "";

    }

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

TEST_ACTION=Hello TC!

/*

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

 *

 * Copyright 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]"

 *

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

import java.awt.EventQueue;

import java.awt.event.ActionEvent;

import java.io.ByteArrayInputStream;

import java.util.Arrays;

import javax.swing.Action;

import javax.xml.parsers.DocumentBuilder;

import javax.xml.parsers.DocumentBuilderFactory;

import org.netbeans.junit.NbTestCase;

import org.openide.awt.ActionID;

import org.openide.awt.ActionReference;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileUtil;

import org.openide.windows.TopComponent;

import org.w3c.dom.Document;

public class TopComponentProcessorTest extends  NbTestCase {

    public TopComponentProcessorTest(String n) {

        super(n);

    }

    @Override

    protected boolean runInEQ() {

        return getName().contains("InEQ");

    }

    public void testTCRegisteredFine() throws Exception {

        FileObject set = FileUtil.getConfigFile("Windows2/Components/my-tc.settings");

        assertNotNull("Settings file found", set);

        assertValidate(set.asText());

    }

    public void testModeIsOK() throws Exception {

        FileObject set = FileUtil.getConfigFile("Windows2/Modes/output/my-tc.wstcref");

        assertNotNull("Mode file found", set);

        final String t = set.asText();

        assertValidate(t);

        assertEquals("not opened, no true in there", -1, t.indexOf("true"));

    }

    public void testFactoryRegisteredFine() throws Exception {

        FileObject set = FileUtil.getConfigFile("Windows2/Components/factory-tc.settings");

        assertNotNull("Settings file found", set);

        assertValidate(set.asText());

    }

    public void testFactoryModeIsOK() throws Exception {

        FileObject set = FileUtil.getConfigFile("Windows2/Modes/explorer/factory-tc.wstcref");

        assertNotNull("Mode file found", set);

        final String t = set.asText();

        assertValidate(t);

        assertTrue("opened, no true in there", t.indexOf("true") > 0);

    }

    public void testFactoryActionIsOKInEQ() throws Exception {

        assertTrue("This one needs to run in EQT", EventQueue.isDispatchThread());

        FileObject fo = FileUtil.getConfigFile("Actions/Windows/open-factory-tc.instance");

        assertNotNull("Action generated", fo);

        Action a = (Action)fo.getAttribute("instanceCreate");

        assertNotNull("Action found", a);

        assertEquals("Not created yet", 0, TC.cnt);

        a.actionPerformed(new ActionEvent(this, 0, ""));

        assertEquals("Created", 1, TC.cnt);

        assertEquals("Hello TC!", a.getValue(Action.NAME));

        assertEquals("any/iconbase.png", a.getValue("iconBase"));

        assertEquals("preferredID found", "factory.tc", fo.getAttribute("preferredID"));

        FileObject dir = FileUtil.getConfigFile("Kuk/Huk");

        assertNotNull("Kuk/Huk found", dir);

        FileObject ref = dir.getFileObject("open-factory-tc.shadow");

        assertNotNull("Reference found: " + Arrays.toString(dir.getChildren()), ref);

        assertEquals(fo.getPath(), ref.getAttribute("originalFile"));

    }

    private static void assertValidate(String xml) throws Exception {

        DocumentBuilderFactory f = DocumentBuilderFactory.newInstance();

        f.setValidating(true);

        DocumentBuilder b = f.newDocumentBuilder();

        Document res = b.parse(new ByteArrayInputStream(xml.getBytes("UTF-8")));

        assertNotNull("Parsed OK", res);

    }

    @TopComponent.Registration(

        mode="output",

        openAtStartup=false

    )

    @TopComponent.Description(

        preferredID="my-tc", iconBase="org/openide/windows/Icon.png"

    )

    public static class TC1 extends TopComponent {

    }

    @TopComponent.Registration(

        mode="explorer",

        openAtStartup=true

    )

    @TopComponent.Description(

        preferredID="factory.tc", iconBase="any/iconbase.png"

    )

    public static class TC extends TopComponent {

        static int cnt;

        @ActionID(category="Windows", id="open.factory.tc")

        @TopComponent.OpenActionRegistration(displayName="#TEST_ACTION",preferredID="factory.tc")

        @ActionReference(path="Kuk/Huk")

        public static TC create() {

            cnt++;

            return new TC();

        }

    }

}

import java.awt.Image;

import org.openide.util.ImageUtilities;

    public void testPreferredIDAndIconTakenFromAnnotation() {

        @TopComponent.Description(

            preferredID="my.id", iconBase="org/openide/windows/icon.png",

            persistenceType=TopComponent.PERSISTENCE_ONLY_OPENED    

        )

        class MyTC extends TopComponent {

        }

        TopComponent tc = new MyTC();

        assertEquals("ID is OK", "my.id", tc.preferredID());

        Image image = ImageUtilities.loadImage("org/openide/windows/icon.png");

        assertEquals("Image is OK", image, tc.getIcon());

        assertEquals("Only opened", TopComponent.PERSISTENCE_ONLY_OPENED, tc.getPersistenceType());

    }

    <change id="private.factories">

        <api name="settings_spi"/>

        <summary>Factory methods can be private</summary>

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

        <date day="30" month="11" year="2010"/>

        <author login="jtulach"/>

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

        <description>

            To be consistent with behavior of methodvalue attribute of

            <a href="@org-openide-filesystems@/org/openide/filesystems/XMLFileSystem.html">XMLFileSystem</a>,

            now the factory methods referenced from settings files can be <code> private static</code>

            as well.

        </description>

    </change>