b3bbc4d76b98f3a02b5bfc91b0de5e10e52ea2fa convertAsProperties_155962_base

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

        boolean propertiesPersistence;

        try {

            SpecificationVersion current = model.getModuleInfo().getDependencyVersion("org.netbeans.modules.settings");

            propertiesPersistence = current.compareTo(new SpecificationVersion("1.18")) >= 0; // NOI18N

        } catch (IOException ex) {

            Logger.getLogger(NewTCIterator.class.getName()).log(Level.INFO, null, ex);

            propertiesPersistence = false;

        }

        if (propertiesPersistence) {

            fileChanges.add(fileChanges.addModuleDependency("org.netbeans.modules.settings")); //NOI18N

        }

<#assign licenseFirst = "/*">

<#assign licensePrefix = " * ">

<#assign licenseLast = " */">

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

package ${PACKAGENAME};

import java.util.logging.Logger;

import org.openide.util.NbBundle;

import org.openide.windows.TopComponent;

import org.openide.windows.WindowManager;

${COMMENTICON}import org.openide.util.ImageUtilities;

import org.netbeans.api.settings.ConvertAsProperties;

/**

 * Top component which displays something.

 */

@ConvertAsProperties(

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

    autostore=false

)

public final class ${TEMPLATENAME}TopComponent extends TopComponent {

    private static ${TEMPLATENAME}TopComponent instance;

    /** path to the icon used by the component and its open action */

${COMMENTICON}    static final String ICON_PATH = "${ICONPATH}";

    private static final String PREFERRED_ID = "${TEMPLATENAME}TopComponent";

    public ${TEMPLATENAME}TopComponent() {

        initComponents();

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

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

${COMMENTICON}        setIcon(ImageUtilities.loadImage(ICON_PATH, true));

        ${KEEPPREFSIZE}

    }

    /** 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() {

        org.jdesktop.layout.GroupLayout layout = new org.jdesktop.layout.GroupLayout(this);

        this.setLayout(layout);

        layout.setHorizontalGroup(

            layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)

            .add(0, 400, Short.MAX_VALUE)

        );

        layout.setVerticalGroup(

            layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)

            .add(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

    /**

     * Gets default instance. Do not use directly: reserved for *.settings files only,

     * i.e. deserialization routines; otherwise you could get a non-deserialized instance.

     * To obtain the singleton instance, use {@link #findInstance}.

     */

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

        if (instance == null) {

            instance = new ${TEMPLATENAME}TopComponent();

        }

        return instance;

    }

    /**

     * Obtain the ${TEMPLATENAME}TopComponent instance. Never call {@link #getDefault} directly!

     */

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

        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 getDefault();

        }

        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 getDefault();

    }

    @Override

    public int getPersistenceType() {

        return TopComponent.PERSISTENCE_ALWAYS;

    }

    @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) {

        ${TEMPLATENAME}TopComponent singleton = ${TEMPLATENAME}TopComponent.getDefault();

        singleton.readPropertiesImpl(p);

        return singleton;

    }

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

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

        // TODO read your settings according to their version

    }

    @Override

    protected String preferredID() {

        return PREFERRED_ID;

    }

}

<!--

DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

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

Contributor(s):

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

Software is Sun Microsystems, Inc. Portions Copyright 2002 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.

-->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<HTML>

  <HEAD>

    <TITLE>org.netbeans.api.settings package</TITLE>

  </HEAD>

  <BODY>

      This package provides annotations to simplify use of

      <a href="http://top/org/netbeans/spi/settings/doc-files/api.html">convertors</a>.

  </BODY>

</HTML>

    <change id="readResolveBehaviour">

        <api name="settings_spi"/>

        <summary>readProperties can designate its replace</summary>

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

        <date day="10" month="1" year="2009"/>

        <author login="jtulach"/>

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

        <description>

            Semantics of <code>readProperties</code> method has been extended

            to allow the method to return an object. Read

            <a href="@TOP@/org/netbeans/spi/settings/doc-files/api.html#xmlprops">more</a>.

        </description>

        <issue number="155962"/>

    </change>

    <change id="convertor.propertyannotation">

        <api name="settings_spi"/>

        <summary>@ConvertAsProperties annotation</summary>

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

        <date day="10" month="1" year="2009"/>

        <author login="jtulach"/>

        <compatibility addition="yes"/>

        <description>

            Human friendly way to register XML property based convertor via

            the <code>@ConvertAsProperties</code> annotation.

        </description>

        <class package="org.netbeans.api.settings" name="ConvertAsProperties"/>

        <issue number="155962"/>

    </change>

                <package>org.netbeans.api.settings</package>

package org.netbeans.api.settings;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

import java.util.Properties;

/** Annotation to attach to object that is wishing to support conversion from

 * and to {@link Properties}. More info about the format and protocol

 * <a href="../../spi/settings/doc-files/api.html#xmlprops">is available</a> in separate document,

 * here is the shortest possible howto:

 * <pre>

 * <code>@</code>ConvertAsProperties(dtd="-//Your Org//Your Setting//EN")

 * <font class="type">public class</font> YourObject {

 *   <font class="type">public</font> YourObject() {} // public constructor is a must

 *   <font class="type">void</font> <font class="function-name">readProperties</font>(java.util.<font class="type">Properties</font> <font class="variable-name">p</font>) {

 *     // do the read

 *   }

 *   <font class="type">void</font> <font class="function-name">writeProperties</font>(java.util.<font class="type">Properties</font> <font class="variable-name">p</font>) {

 *     // handle the store

 *   }

 * }

 * </pre>

 *

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

 * @since 1.18

 */

@Retention(RetentionPolicy.SOURCE)

@Target(ElementType.TYPE)

public @interface ConvertAsProperties {

    /** constant to return from {@link #ignoreChanges()} to signal that all

     * property changes shall be ignored.

     */

    public static final String IGNORE_ALL_CHANGES = "all";

    /** Public ID of the XML file that results in creation of the

     * annotated type and to which the annotated type can be converted.

     * @return public ID of the file's DTD

     */

    String dtd();

    /** Shall every change in the object result in save? Or shall the

     * object just be marked as dirty?

     */

    boolean autostore() default true;

    /** An array of properties that are ignored without marking the object

     * as dirty or saving it.

     * @return array of property names or {@link #IGNORE_ALL_CHANGES} to ignore all properties

     */

    String[] ignoreChanges() default {};

}

/*

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

 *

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

 *

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

 */

package org.netbeans.modules.settings.convertors;

import java.util.Set;

import javax.annotation.processing.Processor;

import javax.annotation.processing.RoundEnvironment;

import javax.annotation.processing.SupportedAnnotationTypes;

import javax.annotation.processing.SupportedSourceVersion;

import javax.lang.model.SourceVersion;

import javax.lang.model.element.Element;

import javax.lang.model.element.ExecutableElement;

import javax.lang.model.element.Modifier;

import javax.lang.model.element.TypeElement;

import javax.lang.model.type.TypeKind;

import javax.lang.model.type.TypeMirror;

import javax.lang.model.util.ElementFilter;

import org.netbeans.api.settings.ConvertAsProperties;

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;

/** Processor to hide all the complexities of settings layer registration.

 *

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

 */

@ServiceProvider(service=Processor.class)

@SupportedSourceVersion(SourceVersion.RELEASE_6)

@SupportedAnnotationTypes("org.netbeans.api.settings.ConvertAsProperties")//NOI18N

public class ConvertorProcessor extends LayerGeneratingProcessor {

    @Override

    protected boolean handleProcess(

        Set<? extends TypeElement> annotations,

        RoundEnvironment env

    ) throws LayerGenerationException {

        if (env.processingOver()) {

            return false;

        }

        for (Element e : env.getElementsAnnotatedWith(ConvertAsProperties.class)) {

            ConvertAsProperties reg = e.getAnnotation(ConvertAsProperties.class);

            String convElem = instantiableClassOrMethod(e);

            final String dtd = reg.dtd();

            String dtdCode = convertPublicId(dtd);

                /*

            <folder name="xml">

             <folder name="entities">

              <folder name="NetBeans_org_netbeans_modules_settings_xtest">

                <file name="DTD_XML_FooSetting_1_0" url="nbres:/org/netbeans/modules/settings/resources/properties-1_0.dtd">

                    <attr name="hint.originalPublicID" stringvalue="-//NetBeans org.netbeans.modules.settings.xtest//DTD XML FooSetting 1.0//EN"/>

                 */

            layer(e).file("xml/entities" + dtdCode).

                url("nbres:/org/netbeans/modules/settings/resources/properties-1_0.dtd").

                stringvalue("hint.originalPublicID", dtd).write();

       /*

        <folder name="memory">

            <folder name="org">

                <folder name="netbeans">

                    <folder name="modules">

                        <folder name="settings">

                            <folder name="convertors">

                                <file name="FooSetting">

                                    <attr name="settings.providerPath"

                                    stringvalue="xml/lookups/NetBeans_org_netbeans_modules_settings_xtest/DTD_XML_FooSetting_1_0.instance"/>

           */

            layer(e).file("xml/memory/" + convElem.replace('.', '/')).

                stringvalue("settings.providerPath", "xml/lookups/" + dtdCode + ".instance").

                write();

       /*

        <folder name="lookups">

            <folder name="NetBeans_org_netbeans_modules_settings_xtest">

                <file name="DTD_XML_FooSetting_1_0.instance">

                    <attr name="instanceCreate" methodvalue="org.netbeans.api.settings.Factory.create"/>

                    <attr name="settings.convertor" methodvalue="org.netbeans.api.settings.Factory.properties"/>

                    <attr name="settings.instanceClass" stringvalue="org.netbeans.modules.settings.convertors.FooSetting"/>

                    <attr name="settings.instanceOf" stringvalue="org.netbeans.modules.settings.convertors.FooSetting"/>

                </file>

            </folder>

        */

            File f = layer(e).file("xml/lookups" + dtdCode + ".instance").

                methodvalue("instanceCreate", "org.netbeans.api.settings.Factory", "create").

                methodvalue("settings.convertor", "org.netbeans.api.settings.Factory", "properties").

                stringvalue("settings.instanceClass", convElem).

                stringvalue("settings.instanceOf", convElem).

                boolvalue("xmlproperties.preventStoring", !reg.autostore());

            commaSeparated(f, reg.ignoreChanges()).write();

        }

        return false;

    }

    /** Copied from FileEntityResolver from o.n.core module.

     */

    @SuppressWarnings("fallthrough")

    private static String convertPublicId (String publicID) {

        char[] arr = publicID.toCharArray ();

        int numberofslashes = 0;

        int state = 0;

        int write = 0;

        OUT: for (int i = 0; i < arr.length; i++) {

            char ch = arr[i];

            switch (state) {

            case 0:

                // initial state

                if (ch == '+' || ch == '-' || ch == 'I' || ch == 'S' || ch == 'O') {

                    // do not write that char

                    continue;

                }

                // switch to regular state

                state = 1;

                // fallthru

            case 1:

                // regular state expecting any character

                if (ch == '/') {

                    state = 2;

                    if (++numberofslashes == 3) {

                        // last part of the ID, exit

                        break OUT;

                    }

                    arr[write++] = '/';

                    continue;

                }

                break;

            case 2:

                // previous character was /

                if (ch == '/') {

                    // ignore second / and write nothing

                    continue;

                }

                state = 1;

                break;

            }

            // write the char into the array

            if (ch >= 'A' && ch <= 'Z' || ch >= 'a' && ch <= 'z' || ch >= '0' && ch <= '9') {

                arr[write++] = ch;

            } else {

                arr[write++] = '_';

            }

        }

        return new String (arr, 0, write);

    }

    private static File commaSeparated(File f, String[] arr) {

        if (arr.length == 0) {

            return f;

        }

        StringBuilder sb = new StringBuilder();

        String sep = "";

        for (String s : arr) {

            sb.append(sep);

            sb.append(s);

            sep = ",";

        }

        return f.stringvalue("xmlproperties.ignoreChanges", sb.toString());

    }

    private String instantiableClassOrMethod(Element e) throws IllegalArgumentException, LayerGenerationException {

        switch (e.getKind()) {

            case CLASS: {

                String clazz = processingEnv.getElementUtils().getBinaryName((TypeElement) e).toString();

                if (e.getModifiers().contains(Modifier.ABSTRACT)) {

                    throw new LayerGenerationException(clazz + " must not be abstract", e);

                }

                {

                    boolean hasDefaultCtor = false;

                    for (ExecutableElement constructor : ElementFilter.constructorsIn(e.getEnclosedElements())) {

                        if (constructor.getParameters().isEmpty()) {

                            hasDefaultCtor = true;

                            break;

                        }

                    }

                    if (!hasDefaultCtor) {

                        throw new LayerGenerationException(clazz + " must have a no-argument constructor", e);

                    }

                }

                TypeMirror propType;

                propType = processingEnv.getElementUtils().getTypeElement("java.util.Properties").asType();

                {

                    boolean hasRead = false;

                    boolean hasWrite = false;

                    for (ExecutableElement m : ElementFilter.methodsIn(e.getEnclosedElements())) {

                        if (

                            m.getParameters().size() == 1 && 

                            m.getSimpleName().contentEquals("readProperties") &&

                            m.getParameters().get(0).asType().equals(propType)

                        ) {

                            hasRead = true;

                        }

                        if (

                            m.getParameters().size() == 1 &&

                            m.getSimpleName().contentEquals("writeProperties") &&

                            m.getParameters().get(0).asType().equals(propType) &&

                            m.getReturnType().getKind() == TypeKind.VOID

                        ) {

                            hasWrite = true;

                        }

                    }

                    if (!hasRead) {

                        throw new LayerGenerationException(clazz + " must have proper readProperties method", e);

                    }

                    if (!hasWrite) {

                        throw new LayerGenerationException(clazz + " must have proper writeProperties method", e);

                    }

                }

                return clazz;

            }

            default:

                throw new IllegalArgumentException("Annotated element is not loadable as an instance: " + e);

        }

    }

}

        @Override

        @Override

/*

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

 *

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

 *

 * Contributor(s):

 *

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

 * Software is Sun Microsystems, Inc. Portions Copyright 2002 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.

 */

package org.netbeans.modules.settings.convertors;

import java.io.*;

import java.util.Properties;

import org.netbeans.junit.NbTestCase;

import org.netbeans.api.settings.ConvertAsProperties;

import org.netbeans.spi.settings.Convertor;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.Repository;

import org.openide.util.test.AnnotationProcessorTestUtils;

/** Checks usage of annotation to assign XML properties convertor.

 *

 * @author Jaroslav Tulach

 */

public final class XMLPropertiesConvertorAnnotationTest extends NbTestCase {

    /** Creates a new instance of XMLPropertiesConvertorTest */

    public XMLPropertiesConvertorAnnotationTest(String name) {

        super(name);

    }

    @Override

    protected void setUp() throws Exception {

        clearWorkDir();

    }

    public void testReadWrite() throws Exception {

        FileObject dtdFO = Repository.getDefault().getDefaultFileSystem().

            findResource("/xml/lookups/NetBeans_org_netbeans_modules_settings_xtest/DTD_XML_FooSetting_2_0.instance");

        assertNotNull("Provider not found", dtdFO);

        Convertor c = XMLPropertiesConvertor.create(dtdFO);

        AnnoFoo foo = new AnnoFoo();

        foo.setProperty1("xxx");

        CharArrayWriter caw = new CharArrayWriter(1024);

        c.write(caw, foo);

        caw.flush();

        caw.close();

        CharArrayReader car = new CharArrayReader(caw.toCharArray());

        Object obj = c.read(car);

        assertEquals(foo, obj);

        assertEquals("HooFoo is the class", HooFoo.class, obj.getClass());

    }

    @ConvertAsProperties(

        dtd="-//NetBeans org.netbeans.modules.settings.xtest//DTD XML FooSetting 2.0//EN"

    )

    public static class AnnoFoo extends FooSetting {

        public Object readProperties(Properties p) {

            HooFoo n = new HooFoo();

            n.setProperty1(p.getProperty("p1"));

            return n;

        }

        public void writeProperties(Properties p) {

            p.setProperty("p1", this.getProperty1());

        }

    }

    public static class HooFoo extends AnnoFoo {

    }

    public void testVerifyHaveDefaultConstructor() throws Exception {

        AnnotationProcessorTestUtils.makeSource(getWorkDir(), "x.y.Kuk",

            "import org.netbeans.api.settings.ConvertAsProperties;\n" +

            "@ConvertAsProperties(dtd=\"-//x.y//Kuk//EN\")\n" +

            "public class Kuk {\n" +

            "  public Kuk(int i) {}\n" +

            "}\n"

        );

        ByteArrayOutputStream err = new ByteArrayOutputStream();

        boolean res = AnnotationProcessorTestUtils.runJavac(getWorkDir(), null, getWorkDir(), null, err);

        assertFalse("Should fail", res);

        if (err.toString().indexOf("x.y.Kuk must have a no-argument constructor") == -1) {

            fail("Wrong error message:\n" + err.toString());

        }

    }

    public void testVerifyReadProperties() throws Exception {

        AnnotationProcessorTestUtils.makeSource(getWorkDir(), "x.y.Kuk",

            "import org.netbeans.api.settings.ConvertAsProperties;\n" +

            "@ConvertAsProperties(dtd=\"-//x.y//Kuk//EN\")\n" +

            "public class Kuk {\n" +

            "  public Kuk() {}\n" +

            "  public void writeProperties(java.util.Properties p){}\n" +

            "}\n"

        );

        ByteArrayOutputStream err = new ByteArrayOutputStream();

        boolean res = AnnotationProcessorTestUtils.runJavac(getWorkDir(), null, getWorkDir(), null, err);

        assertFalse("Should fail", res);

        if (err.toString().indexOf("x.y.Kuk must have proper readProperties method") == -1) {

            fail("Wrong error message:\n" + err.toString());

        }

    }

    public void testVerifyWriteProperties() throws Exception {

        AnnotationProcessorTestUtils.makeSource(getWorkDir(), "x.y.Kuk",

            "import org.netbeans.api.settings.ConvertAsProperties;\n" +

            "@ConvertAsProperties(dtd=\"-//x.y//Kuk//EN\")\n" +

            "public class Kuk {\n" +

            "  public Kuk() {}\n" +

            "  public void readProperties(java.util.Properties p){}\n" +

            "}\n"

        );

        ByteArrayOutputStream err = new ByteArrayOutputStream();

        boolean res = AnnotationProcessorTestUtils.runJavac(getWorkDir(), null, getWorkDir(), null, err);

        assertFalse("Should fail", res);

        if (err.toString().indexOf("x.y.Kuk must have proper writeProperties method") == -1) {

            fail("Wrong error message:\n" + err.toString());

        }

    }

    public void testVerifyWritePropertiesReturnsVoid() throws Exception {

        AnnotationProcessorTestUtils.makeSource(getWorkDir(), "x.y.Kuk",

            "import org.netbeans.api.settings.ConvertAsProperties;\n" +

            "@ConvertAsProperties(dtd=\"-//x.y//Kuk//EN\")\n" +

            "public class Kuk {\n" +

            "  public Kuk() {}\n" +

            "  public void readProperties(java.util.Properties p){}\n" +

            "  public int writeProperties(java.util.Properties p){}\n" +

            "}\n"

        );

        ByteArrayOutputStream err = new ByteArrayOutputStream();

        boolean res = AnnotationProcessorTestUtils.runJavac(getWorkDir(), null, getWorkDir(), null, err);

        assertFalse("Should fail", res);

        if (err.toString().indexOf("x.y.Kuk must have proper writeProperties method") == -1) {

            fail("Wrong error message:\n" + err.toString());

        }

    }

}