<li><api name="encoding" category="stable" group="property" type="export"> contains <code>String</code> the file encoding of the template instance</api></li>

     <change id="templates.encoding">

        <api name="loaders"/>

        <summary>Templates may use ${encoding} property in their bodies</summary>

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

        <date day="1" month="8" year="2007"/>

        <author login="mfukala"/>

        <compatibility semantic="compatible"/>

        <description>

            <p>

                Templates may use ${encoding} property in their bodies to be substituted 

                to the real encoding of the template instance file.

            </p>

        </description>

        <issue number="110910"/>

    </change>

    private static final String ENCODING_PROPERTY_NAME = "encoding"; //NOI18N

        ScriptEngine eng = engine(template);

        Bindings bind = eng.getContext().getBindings(ScriptContext.ENGINE_SCOPE);

        bind.putAll(values);

        if(!values.containsKey(ENCODING_PROPERTY_NAME)) {

            bind.put(ENCODING_PROPERTY_NAME, targetEnc.name());

        }

/*

 * The contents of this file are subject to the terms of the Common Development

 * and Distribution License (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.html

 * or http://www.netbeans.org/cddl.txt.

 *

 * When distributing Covered Code, include this CDDL Header Notice in each file

 * and include the License file at http://www.netbeans.org/cddl.txt.

 * If applicable, add the following below the CDDL Header, with the fields

 * enclosed by brackets [] replaced by your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

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

 * Software is Sun Microsystems, Inc. 

 *

 * Portions Copyrighted 2007 Sun Microsystems, Inc.

 */

package org.netbeans.modules.templates;

import java.io.IOException;

import java.io.OutputStream;

import java.nio.charset.Charset;

import java.util.Collections;

import java.util.Collections;

import java.util.Map;

import org.netbeans.api.queries.FileEncodingQuery;

import org.netbeans.junit.MockServices;

import org.netbeans.junit.NbTestCase;

import org.openide.filesystems.FileObject;

import org.openide.filesystems.FileUtil;

import org.openide.loaders.DataFolder;

import org.openide.loaders.DataObject;

import org.openide.loaders.DataObjectExistsException;

import org.openide.loaders.FileEntry;

import org.openide.loaders.MultiDataObject;

import org.openide.loaders.MultiFileLoader;

/**

 *

 * @author Marek Fukala

 * @author Jaroslav Tulach

 */

public class ScriptingCreateFromTemplateTest extends NbTestCase {

    public ScriptingCreateFromTemplateTest(String testName) {

        super(testName);

    }

    @Override

    protected boolean runInEQ() {

        return true;

    }

    @Override

    protected void setUp() throws Exception {

        MockServices.setServices(SimpleLoader.class);

    }

    public void testCreateFromTemplateEndcodingProperty() throws Exception {

        FileObject root = FileUtil.createMemoryFileSystem().getRoot();

        FileObject fo = FileUtil.createData(root, "simpleObject.txt");

        OutputStream os = fo.getOutputStream();

        os.write("${encoding}".getBytes());

        os.close();

        fo.setAttribute ("template", Boolean.TRUE);

        fo.setAttribute("javax.script.ScriptEngine", "freemarker");

        DataObject obj = DataObject.find(fo);

        DataFolder folder = DataFolder.findFolder(FileUtil.createFolder(root, "target"));

        Map<String,String> parameters = Collections.emptyMap();

        DataObject inst = obj.createFromTemplate(folder, "complex", parameters);

        FileObject instFO = inst.getPrimaryFile();

        Charset targetEnc = FileEncodingQuery.getEncoding(instFO);

        assertNotNull("Template encoding is null", targetEnc);

        assertEquals("Encoding in template doesn't match", targetEnc.name(), readFile(instFO));

    }

    private static String readFile(FileObject fo) throws IOException {

        byte[] arr = new byte[(int)fo.getSize()];

        int len = fo.getInputStream().read(arr);

        assertEquals("Fully read", arr.length, len);

        return new String(arr);

    }

    public static final class SimpleLoader extends MultiFileLoader {

        public SimpleLoader() {

            super(SimpleObject.class.getName());

        }

        protected String displayName() {

            return "SimpleLoader";

        }

        protected FileObject findPrimaryFile(FileObject fo) {

            if (fo.hasExt("prima")) {

                return fo;

            }

            return null;

        }

        protected MultiDataObject createMultiObject(FileObject primaryFile) throws DataObjectExistsException, IOException {

            return new SimpleObject(this, primaryFile);

        }

        protected MultiDataObject.Entry createPrimaryEntry(MultiDataObject obj, FileObject primaryFile) {

            return new FE(obj, primaryFile);

        }

        protected MultiDataObject.Entry createSecondaryEntry(MultiDataObject obj, FileObject secondaryFile) {

            return new FileEntry(obj, secondaryFile);

        }

    }

    private static final class FE extends FileEntry {

        public FE(MultiDataObject mo, FileObject fo) {

            super(mo, fo);

        }

        @Override

        public FileObject createFromTemplate(FileObject f, String name) throws IOException {

            fail("I do not want to be called");

            return null;

        }

    }

    public static final class SimpleObject extends MultiDataObject {

        public SimpleObject(SimpleLoader l, FileObject fo) throws DataObjectExistsException {

            super(fo, l);

        }

        public String getName() {

            return getPrimaryFile().getNameExt();

        }

    }

}