/*
 * 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.rocker;

import io.vertx.codegen.annotations.Fluent;
import io.vertx.codegen.annotations.VertxGen;
import io.vertx.ext.web.common.template.TemplateEngine;
import io.vertx.ext.web.templ.rocker.impl.RockerTemplateEngineImpl;

A template engine that uses the Rocker library.
Author:
Xianguang Zhou/**
 * A template engine that uses the Rocker library.
 *
 * @author <a href="mailto:xianguang.zhou@outlook.com">Xianguang Zhou</a>
 */
@VertxGen
public interface RockerTemplateEngine 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 = "rocker.html";

  
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.
Create a template engine using defaults
Returns:
the engine/**
   * @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.
   *
   * Create a template engine using defaults
   *
   * @return the engine
   */
  static RockerTemplateEngine create() {
    return new RockerTemplateEngineImpl();
  }

  
Set the extension for the engine
Params:
extension – 
         the extension
Returns:
a reference to this for fluency/**
   * Set the extension for the engine
   *
   * @param extension
   *          the extension
   * @return a reference to this for fluency
   */
  @Fluent
  @Deprecated
  RockerTemplateEngine 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
  RockerTemplateEngine setMaxCacheSize(int maxCacheSize);
}