+ API allows to create new files based on templates. Scripting engines can be specified for + processing the template, or custom Handlers may be registered to process certain templates. +
++ A template can use places substituable with parameter values; certain well-known parameters are + predefined, if the caller does not provide its custom values. +
++ The feature will be fully covered by unit tests. +
++ October 2014 +
++ An existing file can be used as a boilerplate for creation of a new file. + The boiler plate can contain necessary skeleton, comments, content. As the + boilerplate resides on config filesystem, it is also customizable by the user + and the user can eventually develop custom templates. +
+
+ In previous NetBeans versions, templating system was built into
+
+ Often many people require ability to create a "clever" template - e.g. + write piece of simple text and at the time of its + + processing + + do some advanced changes to it using either + scripting or templating languages. +
+
+ This traditionally used to be a bit complicated task (hacking into DataObject implementation), however since
+ version 6.1 there are interface in
+
+ Runtime or project-related values may be supplied by
+
+ The CreateFromTemplateAttribute implementation + knows which template is being used, where the outcome should be placed, so it can derive appropriate values for both + the template and the target location. +
+
+ There is a built in support for scripting languages in
+ the standard NetBeans IDE. If a template is annotated with
+ ScriptEngine interface or
+ a String name of the engine that is then used to
+ search for it in the javax.script.ScriptEngineManager.
+ Usually the freemarker engine is the one that is
+ supported by the NetBeans IDE - if your module wants to use it
+ then include a token dependency OpenIDE-Module-Needs: javax.script.ScriptEngine.freemarker
+ in your manifest file (also accessible through project customizer GUI)
+ to indicate to the system that you need it.
+
String representing the current day like 23. 3. 2007String the current time like 17:18:30java.util.Date representing current data and time likeString the file encoding of the template instance
+ Other properties can indeed be provided by
+ CreateFromTemplateAttributess.
+ After processing, the output is also sent to appropriate
+ org.openide.text.IndentEngine associated
+ with the mime type of the template, for formating.
+
+ Smart Templating Quick How-To
+
+
+ First of all create a file in your module layer located somewhere
+ under the Templates/ folder. Make it a template by
+ adding <attr name="template" boolvalue="true"/>. Associate
+ this template with a scripting language, for example by
+ <attr name="javax.script.ScriptEngine" stringvalue="freemarker"/>.
+ Now make sure that the scripting language integration is also available
+ by requesting a token in standard format, for freemarker just put
+ OpenIDE-Module-Needs: javax.script.ScriptEngine.freemarker
+ in your manifest. This tells the NetBeans module system that a
+ module providing integration with such scripting engine has to be
+ enabled. Now you can use regular script language tags inside of
+ your template file. When you write your instantiate
+ method in your wizard, you can create a Map<String,Object> and
+ fill it with parameters collected from your wizard and then pass it
+ to
+
+ createFromTemplate(targetFolder, targetName, mapWithParameters)
+ . This will invoke the scripting language and make the
+ mapWithParameters values available to it. Beyond this
+ there is few standard parameters predefined including name, user, date, time, etc.
+ and also additional parameters are collected from all registered
+ CreateFromTemplateAttributesProviders.
+
+ A CreateFromTemplateHandler + should be able to create multiple files, one of them important so it will open after user + initiates the creation action. The template of set of related files may be represented by a folder with + a handler attached, and the operation deploys multiple files in the target directory. +
++ This utility standardizes the process to use files as blueprints to create new files. +
++ This module replaces some implementation in DataSystem APIs so the implementation + is usable even without DataSystems API itself. DataSystems API will use this + library. +
++ Yes. +
++ No. +
++ Yes. +
++ Requires JRE 7, for implementation reasons (AutoCloseable). +
++ JRE +
++ None. +
++ No native platform dependencies. +
++ No specific deploy dependencies. +
++ JARs only. +
++ Yes. +
++ Yes, except API. +
++ Anywhere. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
+
+ org.netbeans.api.templates.IndentEngine".
+ The only attribute property passed to the ScriptContext is mimeType of the
+ text being formatted.
+
+
+
+ No. +
++ Yes. +
++ None. +
++ None. +
++ None. +
++ Yes, looks up CreateFromTemplateAttributes + and CreateFromTemplateHandler. +
+
+ Registers handler, which integrates scripting engines using javax.script API. Provides an annotation
+ processor, so it is easy to register - see
+ TemplateRegistration annotation.
+
+ No. +
++ No. +
++ No UI. +
++ Files are processed in-memory in documents; practical limits are imposed + by the platform's Document implementation. +
++ See 'perf-limit' +
++ No UI. +
++ No. +
++ XXX no answer for perf-scale +
++ No practical enforcement. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
++ No. +
+Templates.SimpleTargetChooserBuilder.freeFileExtension
+ */
+ public static final String FREE_FILE_EXTENSION = "freeFileExtension"; // NOI18N
+
+ /**
+ * Specifies that no formatting or indentation should be performed on the template.
+ * The parameter can be specified as parameter to the template (possibly through layer registration
+ * of the template. Value is kept for backwards compatibility, but the attribute does not apply
+ * just to java templates.
+ *
+ * It's responsibility of {@link CreateFromTemplateHandler} to pay attention to this value.
+ */
+ public static final String PREFORMATTED_TEMPLATE = "org-netbeans-modules-java-preformattedSource"; // NOI18N
+
+
+ private final FileObject template;
+ private final FileObject target;
+
+ /**
+ * The originally specified name for the new file
+ */
+ @SuppressWarnings("PackageVisibleField")
+ String name;
+
+ /**
+ * The proposed name - either specified, or computed
+ */
+ @SuppressWarnings("PackageVisibleField")
+ String proposedName;
+
+ /**
+ * Template parameters
+ */
+ @SuppressWarnings("PackageVisibleField")
+ Mapsmart templating. + * Implementations of this class can be registered in the global {@link org.openide.util.Lookup} + * and allows anyone provide additional parameters to each {@link CreateFromTemplateHandler}s + * when a template is instantiating. + * + * Implementations are called in the order of appearance in Lookup. The positions less than 0 are + * reserved for the platform. Implementations called later can see and override + * values defined by earlier CreateFromTemplateAttributes. + * + * Read more in the howto document. + * + * This interface supersedes {@code CreateFromTemplateAttributesProvider} in {@code openide.loaders} module. + * + * @author Svata Dedic + */ +public interface CreateFromTemplateAttributes { + /** Called when a template is about to be instantiated to provide additional + * values to the {@link CreateFromTemplateHandler} that will handle the + * template instantiation. + * + * If the returned Map defines the same value as some {@link CreateFromTemplateAttributes} registered + * earlier, the Map's value takes precedence. Parameters supplied by the {@link FileBuilder} cannot be + * overriden. + * + * @param desc the creation request + * @return map of named objects, or null + */ + Map
org.netbeans.spi.project.ui.templates.support
+ */
+@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PACKAGE})
+@Retention(RetentionPolicy.SOURCE)
+public @interface TemplateRegistration {
+
+ /**
+ * Subfolder in which to place the template, such as {@code Other} or {@code Project/Standard}.
+ */
+ String folder();
+
+ /**
+ * Optional position within {@link #folder}.
+ */
+ int position() default Integer.MAX_VALUE;
+
+ /**
+ * Special file basename to use rather than inferring one from the declaring element,
+ * when {@link #content} is empty.
+ * Useful for pure templates referenced from {@code PrivilegedTemplates}.
+ */
+ String id() default "";
+
+ /**
+ * File contents, as resources relative to the package of this declaration.
+ * A nonempty list is mandatory for a template registered on a package.
+ * For a template with a custom iterator, the content may be omitted, though it may still be specified.
+ * Normally only a single file is specified, but for a multifile data object, list the primary entry first. + *
The file basenames (incl. extension) of the actual template files (as in {@link TemplateWizard#getTemplate}) + * will be taken from the basename of the content resources, though a {@code .template} suffix + * may be appended to prevent template resources in a source project from being misinterpreted. + * For a "pure" custom iterator with no specified content, the template basename + * defaults to the FQN of the class or method defining it but with {@code -} for {@code .} characters, + * e.g. {@code pkg-Class-method}, but may be overridden with {@link #id}. + *
Example usage for a simple, single-file template (with or without custom iterator): + *
content="resources/empty.php"+ *
For a form template: + *
content={"Login.java.template", "Login.form.template"}
+ */
+ String[] content() default {};
+
+ /**
+ * Localized label for the template.
+ * Mandatory unless {@link #content} is specified, in which case it would be defaulted by the data node.
+ * May use the usual {@code #key} syntax.
+ */
+ String displayName() default "";
+
+ /**
+ * Icon to use for the template.
+ * Should be an absolute resource path (no initial slash).
+ * Mandatory unless {@link #content} is specified, in which case it would be defaulted by the data node.
+ */
+ String iconBase() default "";
+
+ /**
+ * Optional but recommended relative resource path to an HTML description of the template.
+ * @see TemplateWizard#getDescription
+ */
+ String description() default "";
+
+ /**
+ * Optional name of a script engine to use when processing file content, such as {@code freemarker}.
+ * @see ScriptEngineFactory#getNames
+ */
+ String scriptEngine() default "";
+
+ /**
+ * Optional list of categories interpreted by the project system.
+ */
+ String[] category() default {};
+
+ /**
+ * Set to false if the template can be instantiated without a project.
+ * @since 7.46
+ */
+ boolean requireProject() default true;
+
+ /**
+ * Default (pre-filled) target name for the template, without extension. May
+ * use the usual {@code #key} syntax for localization or branding.
+ *
+ * @since 7.56
+ */
+ String targetName() default "";
+}
diff --git a/api.templates/src/org/netbeans/api/templates/TemplateRegistrations.java b/api.templates/src/org/netbeans/api/templates/TemplateRegistrations.java
new file mode 100644
--- /dev/null
+++ b/api.templates/src/org/netbeans/api/templates/TemplateRegistrations.java
@@ -0,0 +1,56 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright 2011 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 2011 Sun Microsystems, Inc.
+ */
+
+package org.netbeans.api.templates;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * May be used to register multiple plain-file {@link TemplateRegistration}s.
+ * Use on a package for simple templates, or on an iterator for multiple variants of a template
+ * with different {@link TemplateRegistration#content}.
+ * @since 7.29
+ */
+@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PACKAGE})
+@Retention(RetentionPolicy.SOURCE)
+public @interface TemplateRegistrations {
+ TemplateRegistration[] value();
+}
diff --git a/api.templates/src/org/netbeans/modules/templates/Bundle.properties b/api.templates/src/org/netbeans/modules/templates/Bundle.properties
new file mode 100644
--- /dev/null
+++ b/api.templates/src/org/netbeans/modules/templates/Bundle.properties
@@ -0,0 +1,7 @@
+OpenIDE-Module-Display-Category=Infrastructure
+OpenIDE-Module-Long-Description=\
+ Provides API to create files based on templates. Supports scripting in templates \
+ and allows to plug in code that handles file creation, or supplies project or \
+ environment data for template creation.
+OpenIDE-Module-Name=File Templates
+OpenIDE-Module-Short-Description=Supports file creation based on templates
diff --git a/api.templates/src/org/netbeans/modules/templates/ScriptingCreateFromTemplateHandler.java b/api.templates/src/org/netbeans/modules/templates/ScriptingCreateFromTemplateHandler.java
new file mode 100644
--- /dev/null
+++ b/api.templates/src/org/netbeans/modules/templates/ScriptingCreateFromTemplateHandler.java
@@ -0,0 +1,180 @@
+/*
+ * 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 Copyrighted 2007 Sun Microsystems, Inc.
+ */
+
+package org.netbeans.modules.templates;
+
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
+import java.io.PrintWriter;
+import java.io.Reader;
+import java.io.StringReader;
+import java.io.StringWriter;
+import java.io.Writer;
+import java.nio.charset.Charset;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import javax.script.Bindings;
+import javax.script.ScriptContext;
+import javax.script.ScriptEngine;
+import javax.script.ScriptEngineManager;
+import javax.script.ScriptException;
+import org.netbeans.api.queries.FileEncodingQuery;
+import org.netbeans.api.templates.CreateDescriptor;
+import org.netbeans.api.templates.CreateFromTemplateHandler;
+import org.openide.filesystems.FileObject;
+import org.openide.filesystems.FileUtil;
+import org.openide.util.Lookup;
+import org.openide.util.lookup.ServiceProvider;
+
+
+/** Processes templates that have associated attribute
+* with name of the scripting engine.
+*
+* @author Jaroslav Tulach
+*/
+@ServiceProvider(service=CreateFromTemplateHandler.class)
+public class ScriptingCreateFromTemplateHandler extends CreateFromTemplateHandler {
+
+ public static final String SCRIPT_ENGINE_ATTR = "javax.script.ScriptEngine";
+
+ private static ScriptEngineManager manager;
+
+ private static final String ENCODING_PROPERTY_NAME = "encoding"; //NOI18N
+
+ @Override
+ public boolean accept(CreateDescriptor desc) {
+ return engine(desc.getTemplate()) != null;
+ }
+
+ @Override
+ public Listopenide.filesystems.templates module; see javadoc for
+
+ FileBuilder for details.
+ - Often many people require ability to create a "clever" template - e.g. - write piece of simple text and at the time of its - - processing - - do some advanced changes to it using either - scripting or templating languages. -
- -
- This traditionally used to be a bit complicated task, however since
- version 6.1 there are new interfaces
-
- Smart Templating Quick How-To
-
-
- First of all create a file in your module layer located somewhere
- under the Templates/ folder. Make it a template by
- adding <attr name="template" boolvalue="true"/>. Associate
- this template with a scripting language, for example by
- <attr name="javax.script.ScriptEngine" stringvalue="freemarker"/>.
- Now make sure that the scripting language integration is also available
- by requesting a token in standard format, for freemarker just put
- OpenIDE-Module-Needs: javax.script.ScriptEngine.freemarker
- in your manifest. This tells the NetBeans module system that a
- module providing integration with such scripting engine has to be
- enabled. Now you can use regular script language tags inside of
- your template file. When you write your instantiate
- method in your wizard, you can create a Map<String,Object> and
- fill it with parameters collected from your wizard and then pass it
- to
-
- createFromTemplate(targetFolder, targetName, mapWithParameters)
- . This will invoke the scripting language and make the
- mapWithParameters values available to it. Beyond this
- there is few standard parameters predefined including name, user, date, time, etc.
- and also additional parameters are collected from all registered
- CreateFromTemplateAttributesProviders.
-
- Moreover there is a built in support for scripting languages in
- the standard NetBeans IDE. If a template is annotated with
- ScriptEngine interface or
- a String name of the engine that is then used to
- search for it in the javax.script.ScriptEngineManager.
- Usually the freemarker engine is the one that is
- supported by the NetBeans IDE - if your module wants to use it
- then include a token dependency OpenIDE-Module-Needs: javax.script.ScriptEngine.freemarker
- in your manifest file (also accessible through project customizer GUI)
- to indicate to the system that you need it.
-
String representing the current day like 23. 3. 2007String the current time like 17:18:30java.util.Date representing current data and time likeString the file encoding of the template instance
- Other properties can indeed be provided by
- CreateFromTemplateAttributesProviders.
- After processing, the output is also sent to appropriate
- org.openide.text.IndentEngine associated
- with the mime type of the template, for formating.
-
org.netbeans.spi.project.ui.templates.support
- */
-@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PACKAGE})
-@Retention(RetentionPolicy.SOURCE)
-public @interface TemplateRegistration {
-
- /**
- * Subfolder in which to place the template, such as {@code Other} or {@code Project/Standard}.
- */
- String folder();
-
- /**
- * Optional position within {@link #folder}.
- */
- int position() default Integer.MAX_VALUE;
-
- /**
- * Special file basename to use rather than inferring one from the declaring element,
- * when {@link #content} is empty.
- * Useful for pure templates referenced from {@code PrivilegedTemplates}.
- */
- String id() default "";
-
- /**
- * File contents, as resources relative to the package of this declaration.
- * A nonempty list is mandatory for a template registered on a package.
- * For a template with a custom iterator, the content may be omitted, though it may still be specified.
- * Normally only a single file is specified, but for a multifile data object, list the primary entry first. - *
The file basenames (incl. extension) of the actual template files (as in {@link TemplateWizard#getTemplate}) - * will be taken from the basename of the content resources, though a {@code .template} suffix - * may be appended to prevent template resources in a source project from being misinterpreted. - * For a "pure" custom iterator with no specified content, the template basename - * defaults to the FQN of the class or method defining it but with {@code -} for {@code .} characters, - * e.g. {@code pkg-Class-method}, but may be overridden with {@link #id}. - *
Example usage for a simple, single-file template (with or without custom iterator): - *
content="resources/empty.php"- *
For a form template: - *
content={"Login.java.template", "Login.form.template"}
- */
- String[] content() default {};
-
- /**
- * Localized label for the template.
- * Mandatory unless {@link #content} is specified, in which case it would be defaulted by the data node.
- * May use the usual {@code #key} syntax.
- */
- String displayName() default "";
-
- /**
- * Icon to use for the template.
- * Should be an absolute resource path (no initial slash).
- * Mandatory unless {@link #content} is specified, in which case it would be defaulted by the data node.
- */
- String iconBase() default "";
-
- /**
- * Optional but recommended relative resource path to an HTML description of the template.
- * @see TemplateWizard#getDescription
- */
- String description() default "";
-
- /**
- * Optional name of a script engine to use when processing file content, such as {@code freemarker}.
- * @see ScriptEngineFactory#getNames
- */
- String scriptEngine() default "";
-
- /**
- * Optional list of categories interpreted by the project system.
- */
- String[] category() default {};
-
- /**
- * Set to false if the template can be instantiated without a project.
- * @since 7.46
- */
- boolean requireProject() default true;
-
- /**
- * Default (pre-filled) target name for the template, without extension. May
- * use the usual {@code #key} syntax for localization or branding.
- *
- * @since 7.56
- */
- String targetName() default "";
-}
diff --git a/openide.loaders/src/org/netbeans/api/templates/TemplateRegistrations.java b/openide.loaders/src/org/netbeans/api/templates/TemplateRegistrations.java
deleted file mode 100644
--- a/openide.loaders/src/org/netbeans/api/templates/TemplateRegistrations.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
- *
- * Copyright 2011 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 2011 Sun Microsystems, Inc.
- */
-
-package org.netbeans.api.templates;
-
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-import java.lang.annotation.Target;
-
-/**
- * May be used to register multiple plain-file {@link TemplateRegistration}s.
- * Use on a package for simple templates, or on an iterator for multiple variants of a template
- * with different {@link TemplateRegistration#content}.
- * @since 7.29
- */
-@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PACKAGE})
-@Retention(RetentionPolicy.SOURCE)
-public @interface TemplateRegistrations {
- TemplateRegistration[] value();
-}
diff --git a/openide.loaders/src/org/netbeans/modules/templates/DesktopTemplateAttributes.java b/openide.loaders/src/org/netbeans/modules/templates/DesktopTemplateAttributes.java
new file mode 100644
--- /dev/null
+++ b/openide.loaders/src/org/netbeans/modules/templates/DesktopTemplateAttributes.java
@@ -0,0 +1,76 @@
+/*
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+ *
+ * Copyright 2014 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 2014 Sun Microsystems, Inc.
+ */
+package org.netbeans.modules.templates;
+
+import java.text.DateFormat;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.Map;
+import org.netbeans.api.templates.CreateDescriptor;
+import org.netbeans.api.templates.CreateFromTemplateAttributes;
+import org.openide.util.lookup.ServiceProvider;
+
+/**
+ * Compatible implementation for desktop applications. Provides username and
+ * date/time format based on JRE properties/defaults.
+ *
+ * @author sdedic
+ */
+@ServiceProvider(service = CreateFromTemplateAttributes.class, position = Integer.MIN_VALUE)
+public class DesktopTemplateAttributes implements CreateFromTemplateAttributes {
+ @Override
+ public Mapsmart templatingthat allows @@ -43,11 +46,34 @@ * and handle them themselves. The NetBeans IDE provides default * implementation that allows use of Freemarker templating engine. * Read more in the howto document. - * + * + * This SPI is now deprecated and serves just a backward compatilibity SPI adapter + * which allows the template API to work with legacy handlers. The templating SPI is delegated + * to the original handler methods. + * * @author Jaroslav Tulach * @since 6.1 + * @deprecated in 7.59. Use {@link org.netbeans.api.templates.CreateFromTemplateHandler} instead. */ -public abstract class CreateFromTemplateHandler { +public abstract class CreateFromTemplateHandler extends org.netbeans.api.templates.CreateFromTemplateHandler { + + @Override + public boolean accept(CreateDescriptor desc) { + return accept(desc.getTemplate()); + } + + @Override + protected List