/*
 * Copyright 2014 Red Hat, Inc.
 *
 *  All rights reserved. This program and the accompanying materials
 *  are made available under the terms of the Eclipse Public License v1.0
 *  and Apache License v2.0 which accompanies this distribution.
 *
 *  The Eclipse Public License is available at
 *  http://www.eclipse.org/legal/epl-v10.html
 *
 *  The Apache License v2.0 is available at
 *  http://www.opensource.org/licenses/apache2.0.php
 *
 *  You may elect to redistribute this code under either of these licenses.
 */

package io.vertx.ext.web.templ.mvel;

import io.vertx.codegen.annotations.Fluent;
import io.vertx.codegen.annotations.VertxGen;
import io.vertx.core.Vertx;
import io.vertx.ext.web.common.template.TemplateEngine;
import io.vertx.ext.web.templ.mvel.impl.MVELTemplateEngineImpl;

A template engine that uses the Handlebars library.
Author:
Tim Fox/**
 * A template engine that uses the Handlebars library.
 *
 * @author <a href="http://tfox.org">Tim Fox</a>
 */
@VertxGen
public interface MVELTemplateEngine extends TemplateEngine {

  
Default max number of templates to cache
/**
   * Default max number of templates to cache
   */
  int DEFAULT_MAX_CACHE_SIZE = 10000;

  
Default template extension
/**
   * Default template extension
   */
  @Deprecated
  String DEFAULT_TEMPLATE_EXTENSION = "templ";

  
Create a template engine using defaults
Returns:
 the engine/**
   * Create a template engine using defaults
   *
   * @return  the engine
   */
  static MVELTemplateEngine create(Vertx vertx) {
    return new MVELTemplateEngineImpl(vertx);
  }

  
Params:
extension –  the extension
Deprecated:
as a user you should use filename with extensions on the render method instead of relying
on this method to suffix your filenames. Using this method is quite an opinionated API and has the side
effect that you cannot use files without extensions as templates.
Set the extension for the engine
Returns:
a reference to this for fluency/**
   * @deprecated as a user you should use filename with extensions on the render method instead of relying
   * on this method to suffix your filenames. Using this method is quite an opinionated API and has the side
   * effect that you cannot use files without extensions as templates.
   *
   * Set the extension for the engine
   *
   * @param extension  the extension
   * @return a reference to this for fluency
   */
  @Fluent
  @Deprecated
  MVELTemplateEngine setExtension(String extension);

  
Set the max cache size for the engine
Params:
maxCacheSize –  the maxCacheSize
Returns:
a reference to this for fluency/**
   * Set the max cache size for the engine
   *
   * @param maxCacheSize  the maxCacheSize
   * @return a reference to this for fluency
   */
  @Fluent
  MVELTemplateEngine setMaxCacheSize(int maxCacheSize);
}