jknack-handlebars.java 프로젝트 README.md 한국어 번역

handlebars에 대한 공부를 하던 도중, jknack/handlebars.java 프로젝트의 README.md에 handlebars.java에 대한 설명이 매우 잘 나와있어 이를 한국어로 번역했습니다.

---

Handlebars.java

Logic-less and semantic Mustache templates with Java

Handlebars handlebars = new Handlebars();

Template template = handlebars.compileInline("Hello {{this}}!");

System.out.println(template.apply("Handlebars.java"));

Output:

Hello Handlebars.java!

Handlebars.java는 Java를 위한 handlebars 입니다.

Handlebars는 효과적으로 시맨틱 템플릿을 구축하는데 필요한 기능을 제공합니다.

Mustache 템플릿은 핸들바와 호환되므로 Mustache 템플릿을 가져와서 사용할 수 있습니다. 추가 핸들바 기능을 활용하십시오.

Requirements

• Handlebars 4.3+는 Java 8 이상의 버전을 요구합니다.

Getting Started

일반적으로 Handlebars 템플릿의 구문은 Mustache 템플릿의 상위 집합입니다. 기본 구문은 Mustache manpage를 확인하세요.

Handlebars.java blog도 시작하기에 좋은 곳입니다. Javadoc은 javadoc.io에서 사용할 수 있습니다.

Maven

Stable version:

  <dependency>
    <groupId>com.github.jknack</groupId>
    <artifactId>handlebars</artifactId>
    <version>${handlebars-version}</version>
  </dependency>

templates 로딩

템플릿은 TemplateLoader 클래스를 사용하여 로드됩니다. Handlebars.java는 TemplateLoader의 세 가지 구현을 제공합니다.

• ClassPathTemplateLoader (default)
• FileTemplateLoader
• SpringTemplateLoader (handlebars-springmvc module 참고)

이 예제는 클래스 경로의 루트에서 mytemplate.hbs를 로드합니다.

mytemplate.hbs:

Hello {{this}}!

Handlebars handlebars = new Handlebars();

Template template = handlebars.compile("mytemplate");

System.out.println(template.apply("Handlebars.java"));

Output:

Hello Handlebars.java!

다음과 같이 다른 TemplateLoader를 지정할 수 있습니다.

TemplateLoader loader = ...;
Handlebars handlebars = new Handlebars(loader);

Templates 접두사 및 접미사

'TemplateLoader'는 두 가지 중요한 속성을 제공합니다.

• prefix: 템플릿이 저장되는 기본 접두사를 설정하는 데 유용합니다.
• suffix: 템플릿의 기본 접미사 또는 파일 확장자를 설정하는 데 유용합니다. 기본값은 .hbs입니다.

Example:

TemplateLoader loader = new ClassPathTemplateLoader();
loader.setPrefix("/templates");
loader.setSuffix(".html");
Handlebars handlebars = new Handlebars(loader);

Template template = handlebars.compile("mytemplate");

System.out.println(template.apply("Handlebars.java"));

Handlebars.java는 mytemplate을 /templates/mytemplate.html로 해석하고 로드합니다.

The Handlebars.java 서버

handlebars.java 서버는 Mustache/Handlebars 템플릿을 작성하고 데이터와 병합할 수 있는 작은 애플리케이션입니다.

웹 디자이너에게 유용한 도구입니다.

Maven Central에서 다운로드:

1. here 클릭
2. Download 섹션에서 jar를 클릭합니다.

Maven:

<dependency>
  <groupId>com.github.jknack</groupId>
  <artifactId>handlebars-proto</artifactId>
  <version>${current-version}</version>
</dependency>

Usage:
java -jar handlebars-proto-${current-version}.jar -dir myTemplates

Example:

myTemplates/home.hbs

<ul>
 {{#items}}
 {{name}}
 {{/items}}
</ul>

myTemplates/home.json

{
  "items": [
    {
      "name": "Handlebars.java rocks!"
    }
  ]
}

또는 YAML myTemplates/home.yml을 선호하는 경우:

items:
  - name: Handlebars.java rocks!

다음 주소의 브라우저를 엽니다.

http://localhost:6780/home.hbs

추가 옵션:

• -dir: 템플릿 디렉토리 설정
• -prefix: 템플릿의 접두사를 설정합니다. 기본값은 /입니다.
• -suffix: 템플릿의 접미사를 설정합니다. 기본값은 .hbs입니다.
• -context: 컨텍스트의 경로를 설정합니다. 기본값은 /입니다.
• -port: 포트 번호 설정, 기본값은 6780
  --content-type: 컨텐츠 유형 헤더를 설정합니다. 기본값은 text/html입니다.

template 당 다수의 data sources

단일 템플릿에 대해 다수의 데이터셋을 테스트해야 하거나 테스트하려는 경우 요청 URI에서 'data' 매개변수를 설정하여 수행할 수 있습니다.

Example:

http://localhost:6780/home.hbs?data=mytestdata

확장 파일을 지정할 필요가 없습니다.

Helpers

Built-in helpers:

• with
• each
• if
• unless
• log
• block
• partial
• precompile
• embedded
• i18n and i18nJs
• string helpers
• conditional helpers

with, each, if, unless:

built-in helper documentation를 참조하세요.

block and partial

Block and partial helpers가 함께 작동하여 Template Inheritance을 제공합니다.

Usage:

  {{#block "title"}}
    ...
  {{/block}}

context: region의 이름을 정의하는 문자열 리터럴.

Usage:

  {{#partial "title"}}
    ...
  {{/partial}}

context: region의 이름을 정의하는 문자열 리터럴.

precompile

handlebars.js를 사용하여 Handlebars.java 템플릿을 JavaScript로 Precompile

user.hbs

Hello {{this}}!

home.hbs

<script type="text/javascript">
  {{precompile "user"}}
</script>

Output:

<script type="text/javascript">
  (function () {
    var template = Handlebars.template,
      templates = (Handlebars.templates = Handlebars.templates || {});
    templates["user"] = template(function (
      Handlebars,
      depth0,
      helpers,
      partials,
      data
    ) {
      helpers = helpers || Handlebars.helpers;
      var buffer = "",
        functionType = "function",
        escapeExpression = this.escapeExpression;

      buffer += "Hi ";
      depth0 = typeof depth0 === functionType ? depth0() : depth0;
      buffer += escapeExpression(depth0) + "!";
      return buffer;
    });
  })();
</script>

다음을 사용하여 미리 컴파일된 템플릿에 액세스할 수 있습니다.

var template = Handlebars.templates["user"];

기본적으로 /handlebars-v1.3.0.js를 사용하여 템플릿을 컴파일합니다. handlebars.java 2.x부터 handlebars.js 2.x를 사용할 수도 있습니다.

Handlebars handlebars = new Handlebars();
handlebars.handlebarsJsFile("/handlebars-v2.0.0.js");

더 자세한 정보는 Precompiling Templates 문서에서 확인할 수 있습니다.

Usage:

{{precompile "template" [wrapper="anonymous, amd or none"]}}

context: 필수로 들어가야하는 template의 이름입니다.

wrapper: "anonymous", "amd" or "none" 중 하나입니다. 기본값은 "anonymous"

maven plugin도 사용 가능합니다.

embedded

The embedded helper를 사용하면 <script> HTML 태그 안에 핸들바 템플릿을 "포함"할 수 있습니다.

user.hbs

<tr>
  <td>{{firstName}}</td>
  <td>{{lastName}}</td>
</tr>

home.hbs

<html>
  ... {{embedded "user"}} ...
</html>

Output:

<html>
  ...
  <script id="user-hbs" type="text/x-handlebars">
    <tr>
      <td>{{firstName}}</td>
      <td>{{lastName}}</td>
    </tr>
  </script>
  ...
</html>

Usage:

{{embedded "template"}}

context: 필수로 들어가야하는 template의 이름입니다.

i18n

{@link ResourceBundle} 위에 구축된 helper입니다. {@link ResourceBundle}은 Java에서 가장 잘 알려진 국제화(i18n) 메커니즘입니다.

Usage:

{{i18n "hello"}}

이를 위해서는 classpath의 루트에 messages.properties가 필요합니다.

Using a locale:

{{i18n "hello" locale="es_AR"}}

이를 위해서는 classpath의 루트에 messages_es_AR.properties가 필요합니다.

다른 bundle 사용:

{{i18n "hello" bundle="myMessages"}}

이를 위해서는 클래스 경로의 루트에 'myMessages.properties'가 필요합니다.

message format 사용:

{{i18n "hello" "Handlebars.java"}}

hello가 Hola {0}!인 경우 결과는 Hola Handlebars.java!입니다.

i18nJs

'ResourceBundle'을 JavaScript 코드로 번역합니다. 생성된 코드는 애플리케이션에 I18n이 있다고 가정합니다.

Usage:

{{i18nJs [locale] [bundle=messages]}}

locale 인수가 있으면 해당 로케일을 JavaScript로 변환합니다. 그렇지 않으면 기본 locale을 사용합니다.

생성된 코드는 다음과 같습니다:

<script type="text/javascript">
  I18n.defaultLocale = 'es_AR';
  I18n.locale = 'es_AR';
  I18n.translations = I18n.translations || {};
  // Spanish (Argentina)
  I18n.translations['es_AR'] = {
    "hello": "Hi {{arg0}}!"
  }
</script>

마지막으로 Hi {0}와 같은 메시지 패턴을 Hi {{arg0}}로 변환합니다. 이것은 I18n JS 라이브러리가 변수를 보간하는 것을 가능하게 합니다.

string helpers

StringHelpers에서 약어, 대문자, 조인, dateFormat, yesno 등의 기능을 사용할 수 있습니다. github/jknack/handlebars/helper/StringHelpers.java).

NOTE: string helpers를 등록해야 합니다(기본적으로 추가되지 않음).

conditional helpers

eq, neq, lt, gt, and, or, not 등과 같은 기능은 [ConditionalHelpers](https://github.com/jknack/handlebars.java/blob/master/handlebars/src/main/ java/com/github/jknack/handlebars/helper/ConditionalHelpers.java)에서 사용할 수 있습니다.

NOTE: conditional helpers를 등록해야 합니다(기본적으로 추가되지 않음).

TypeSafe Templates

TypeSafe Templates는 TypeSafeTemplate interface를 확장하여 생성됩니다. 예를 들어:

// 1
public static interface UserTemplate extends TypeSafeTemplate<User> {

  // 2
  public UserTemplate setAge(int age);

  public UserTemplate setRole(String role);

}

// 3
UserTemplate userTmpl = handlebars.compileInline("{{name}} is {{age}} years old!")
  .as(UserTemplate.class);

userTmpl.setAge(32);

assertEquals("Edgar is 32 years old!", userTmpl.apply(new User("Edgar")));

1. TypeSafeTemplate interface를 확장합니다.
2. 필요한 모든 설정 방법을 추가합니다. set 메소드는 'void' 또는 'TypeSafeTemplate' 객체를 반환할 수 있습니다.
3. as() 메서드를 사용하여 새로운 유형 안전 템플릿을 만듭니다.

Registering Helpers

Registering Helpers를 등록하는 방법은 두 가지가 있습니다.

Helper interface를 사용

handlebars.registerHelper("blog", new Helper<Blog>() {
  public CharSequence apply(Blog blog, Options options) {
    return options.fn(blog);
  }
});

handlebars.registerHelper("blog-list", new Helper<List<Blog>>() {
  public CharSequence apply(List<Blog> list, Options options) {
    String ret = "<ul>";
    for (Blog blog: list) {
      ret += "<li>" + options.fn(blog) + "</li>";
    }
    return new Handlebars.SafeString(ret + "</ul>");
  }
});

HelperSource를 사용

helper source는 "CharSequence"의 인스턴스를 반환하는 공용 메서드를 사용하는 모든 클래스입니다.

  public static? CharSequence methodName(context?, parameter*, options?) {
  }

위치:

• 메서드는 정적일 수도 아닐 수도 있습니다.
• 메서드의 이름이 helper의 이름이 됩니다.
• 컨텍스트, 매개 변수 및 옵션은 모두 선택 사항입니다.
• 컨텍스트 및 옵션이 있는 경우 메서드의 첫 번째 및 마지막 인수여야 합니다.

다음은 모두 helper 메서드의 유효한 정의입니다.

public class HelperSource {
  public String blog(Blog blog, Options options) {
    return options.fn(blog);
  }

  public static String now() {
    return new Date().toString();
  }

  public String render(Blog context, String param0, int param1, boolean param2, Options options) {
    return ...
  }
}

...

handlebars.registerHelpers(new HelperSource());

또는 정적 메서드만 선호하는 경우:

handlebars.registerHelpers(HelperSource.class);

With plain JavaScript

1.1.0부터는 자바스크립트로 helper를 작성할 수 있습니다.

helpers.js:

Handlebars.registerHelper("hello", function (context) {
  return "Hello " + context;
});

handlebars.registerHelpers(new File("helpers.js"));

멋지지 않아요?

Helper 옵션

매개 변수

handlebars.registerHelper("blog-list", new Helper<Blog>() {
  public CharSequence apply(List<Blog> list, Options options) {
    String p0 = options.param(0);
    assertEquals("param0", p0);
    Integer p1 = options.param(1);
    assertEquals(123, p1);
    ...
  }
});

Bean bean = new Bean();
bean.setParam1(123);

Template template = handlebars.compileInline("{{#blog-list blogs \"param0\" param1}}{{/blog-list}}");
template.apply(bean);

기본 매개 변수

handlebars.registerHelper("blog-list", new Helper<Blog>() {
  public CharSequence apply(List<Blog> list, Options options) {
    String p0 = options.param(0, "param0");
    assertEquals("param0", p0);
    Integer p1 = options.param(1, 123);
    assertEquals(123, p1);
    ...
  }
});

Template template = handlebars.compileInline("{{#blog-list blogs}}{{/blog-list}}");

Hash

handlebars.registerHelper("blog-list", new Helper<Blog>() {
  public CharSequence apply(List<Blog> list, Options options) {
    String class = options.hash("class");
    assertEquals("blog-css", class);
    ...
  }
});

handlebars.compileInline("{{#blog-list blogs class=\"blog-css\"}}{{/blog-list}}");

기본 hash

handlebars.registerHelper("blog-list", new Helper<Blog>() {
  public CharSequence apply(List<Blog> list, Options options) {
    String class = options.hash("class", "blog-css");
    assertEquals("blog-css", class);
    ...
  }
});

handlebars.compileInline("{{#blog-list blogs}}{{/blog-list}}");

Error 보고

구문 errors

file:line:column: message
   evidence
   ^
[at file:line:column]

Examples:

template.hbs

{{value

/templates.hbs:1:8: found 'eof', expected: 'id', 'parameter', 'hash' or '}'
    {{value
           ^

partial을 찾을 수 없거나 오류가 있는 경우 호출 스택이 추가됩니다:

/deep1.hbs:1:5: The partial '/deep2.hbs' could not be found
    {{> deep2
        ^
at /deep1.hbs:1:10
at /deep.hbs:1:10

Helper/Runtime errors

Helper나 runtime errors 는 rnans errors에 두가지를 제외하고 비슷합니다:

1. 문제의 위치가 정확할 수도 있고 아닐 수도 있습니다.
2. stack-trace를 사용할 수 없습니다.

Examples:

Block helper:

public CharSequence apply(final Object context, final Options options) throws IOException {
  if (context == null) {
    throw new IllegalArgumentException(
        "found 'null', expected 'string'");
  }
  if (!(context instanceof String)) {
    throw new IllegalArgumentException(
        "found '" + context + "', expected 'string'");
  }
  ...
}

base.hbs

{{#block}} {{/block}}

Handlebars.java reports:

/base.hbs:2:4: found 'null', expected 'string'
    {{#block}} ... {{/block}}

간단히 말해서 helper에서 예외를 던질 수 있고 Handlebars.java는 파일 이름, 줄, 열 및 증거를 추가합니다.

Advanced Usage

Context stack 확장

모든 단일 보기/페이지에서 현재 로그인한 사용자에 액세스해야 한다고 가정해 보겠습니다.
Context-stack에 연결하여 현재 로그인한 사용자를 게시할 수 있습니다. 소스 코드를 확인해보세요:

 hookContextStack(Object model, Template template) {
   User user = ....;// 로그인한 사용자 가져오기
   Map moreData = ...;
   Context context = Context
     .newBuilder(model)
       .combine("user", user)
       .combine(moreData)
       .build();
   template.apply(context);
   context.destroy();
 }

'hookContextStack' 메소드는 어디에 있을까요? 그것은 당신의 애플리케이션 아키텍처에 달려 있습니다.

Using the ValueResolver

기본적으로 Handlebars.java는 JavaBean 메소드(즉, public getXxx 및 isXxx 메소드)와 Map로 값을 해석합니다.

값을 해석하는 것을 바꿀 수 있습니다. 이 섹션에서는 이 작업을 수행하는 방법을 설명합니다.

The JavaBeanValueResolver

"get/is" 접두사가 붙은 public 메서드의 값을 확인합니다.

Context context = Context
  .newBuilder(model)
  .resolver(JavaBeanValueResolver.INSTANCE)
  .build();

The FieldValueResolver

no-static 필드의 값을 확인합니다.

Context context = Context
  .newBuilder(model)
  .resolver(FieldValueResolver.INSTANCE)
  .build();

The MapValueResolver

java.util.Map 객체의 값을 확인합니다.

Context context = Context
  .newBuilder(model)
  .resolver(MapValueResolver.INSTANCE)
  .build();

The MethodValueResolver

public 메서드의 값을 확인합니다.

Context context = Context
  .newBuilder(model)
  .resolver(MethodValueResolver.INSTANCE)
  .build();

The JsonNodeValueResolver

'JsonNode' 객체의 값을 확인합니다.

Context context = Context
  .newBuilder(model)
  .resolver(JsonNodeValueResolver.INSTANCE)
  .build();

Jackson 1.x과 Jackson 2.x 모듈에서 사용 가능합니다.

Multiples value resolvers 사용

Context context = Context
  .newBuilder(model)
  .resolver(
      MapValueResolver.INSTANCE,
      JavaBeanValueResolver.INSTANCE,
      FieldValueResolver.INSTANCE
  ).build();

 

The Cache System

Cache System은 확장성과 유연성을 제공하도록 설계되었습니다. 다음은 TemplateCache 시스템에 대한 간략한 보기입니다.

 public interface TemplateCache {

  /**
   * 캐시에서 모든 매핑을 제거합니다.
   */
  void clear();

  /**
   * 이 캐시가 있는 경우 이 소스에 대한 매핑을 제거합니다.
   *
   * @param source 매핑이 캐시에서 제거될 소스
   */
  void evict(TemplateSource source);

  /**
   * 이 캐시가 지정된 키를 매핑하는 값을 반환합니다.
   *
   * @param source 연결된 템플릿이 반환될 소스입니다.
   * @param parser Handlebars 파서
   * @return A template.
   * @throws IOException input이 파싱되지 않는 경우
   */
  Template get(TemplateSource source, Parser parser) throws IOException;
}

보시다시피 put 메소드가 없습니다. 모든 무거운 작업은 기본적으로 캐시 시스템의 핵심인 get 메소드에서 수행됩니다.

기본적으로 Handlebars.java는 다음과 같은 null 캐시 구현(일명 no cache at all)을 사용합니다.

Template get(TemplateSource source, Parser parser) throws IOException {
  return parser.parse(source);
}

'null' 캐시 외에도 Handlebars.java는 세 가지 구현을 더 제공합니다:

1. ConcurrentMapTemplateCache: 파일의 변경 사항을 자동으로 감지하는 ConcurrentMap 위에 구축된 템플릿 캐시 구현입니다.
   이 구현은 일반적으로 매우 잘 작동하지만 둘 이상의 스레드가 동일한 템플릿을 컴파일할 수 있는 작은 여지가 있습니다. 컴파일러가 매우 빠르기 때문에 Handlebars.java에서 큰 문제가 되지 않습니다.
   그러나 이 구현을 원하지 않는다면 HighConcurrencyTemplateCache 템플릿 캐시를 사용할 수 있습니다.
2. HighConcurrencyTemplateCache: 파일의 변경 사항을 자동으로 감지하는 ConcurrentMap 위에 구축된 템플릿 캐시 구현입니다.
   이 캐시 구현은 ConcurrentMapTemplateCache에 의해 생성된 창을 0으로 제거합니다.
   이것은 Java Concurrency in Practice에서 설명한 패턴을 따르며 스레드 수에 관계없이 템플릿이 한 번만 컴파일되도록 합니다.
3. GuavaTemplateCache: Google Guava를 기반으로 구축된 템플릿 캐시 구현입니다. handlebars-guava-cache module에서 사용 가능 합니다.

다음을 통해 캐시를 사용하도록 Handlebars.java를 구성할 수 있습니다:

Handlebars hbs = new Handlebars()
  .with(new MyCache());

MissingValueResolver 사용 (@deprecated)

NOTE: MissingValueResolver는 <= 1.3.0에서 사용할 수 있습니다. > 1.3.0의 경우 helper 누락을 사용하세요.

MissingValueResolver를 사용하면 null로 확인된 {{변수}} 표현식에 기본값을 사용할 수 있습니다.

  MissingValueResolver missingValueResolver = new MissingValueResolver() {
    public String resolve(Object context, String name) {
      //기본값을 반환하거나 예외를 던집니다.
      ...;
    }
  };
  Handlebars handlebars = new Handlebars().with(missingValueResolver);

Helper Missing

기본적으로 Handlebars.java는 helper를 확인할 수 없는 경우 java.lang.IllegalArgumentException()을 발생시킵니다.
special helper인 helperMissing을 제공하여 기본 동작을 재정의할 수 있습니다. 예시:

  handlebars.registerHelperMissing(new Helper<Object>() {
    @Override
    public CharSequence apply(final Object context, final Options options) throws IOException {
      return options.fn.text();
    }
  });

문자열 형식 매개변수

stringParams: true를 설정하면 매개변수 이름에 액세스할 수 있습니다. 예시:

{{sayHi this edgar}}

  Handlebars handlebars = new Handlebars()
    .stringParams(true);

  handlebars.registerHelper("sayHi", new Helper<Object>() {
    public Object apply(Object context, Options options) {
      return "Hello " + options.param(0) + "!";
    }
  });

결과:

Hello edgar!

어떻게 작동합니까? stringParams: true는 값이 컨텍스트 스택에 없으면 이름에 대한 매개변수를 확인하도록 Handlebars.java에 지시합니다.

무한 루프 허용

기본적으로 Handlebars.java는 부분 호출이 직접 또는 간접적으로 허용되지 않습니다.
Handlebars.inifiteLoops(true)를 설정하여 이를 변경할 수 있지만 StackOverflowError에 주의하세요.

Pretty Print

Mustache Spec에는 공백과 새 줄을 제거하기 위한 몇 가지 규칙이 있습니다. 이 기능은 기본적으로 비활성화되어 있습니다.
Handlebars.prettyPrint(true)를 설정하여 이 기능을 켤 수 있습니다.

Modules

Jackson 1.x

Maven:

 <dependency>
   <groupId>com.github.jknack</groupId>
   <artifactId>handlebars-json</artifactId>
   <version>${handlebars-version}</version>
 </dependency>

Usage:

 handlebars.registerHelper("json", JacksonHelper.INSTANCE);

 {{json context [view="foo.MyFullyQualifiedClassName"] [escapeHTML=false] [pretty=false]}}

대안:

 handlebars.registerHelper("json", new JacksonHelper().viewAlias("myView",
   foo.MyFullyQualifiedClassName.class);

 {{json context [view="myView"] [escapeHTML=false] [pretty=false]}}

context: 객체는 null일 수 있습니다.

view: Jackson View의 이름이며 선택 사항입니다.

escapeHTML: True, JSON 콘텐츠에 HTML 문자가 포함되어 있고 이 문자를 이스케이프해야 하는 경우. 기본값: false.

pretty: True, JSON 콘텐츠의 형식을 지정해야 하는 경우. 기본값: false.

Jackson 2.x

Maven:

 <dependency>
   <groupId>com.github.jknack</groupId>
   <artifactId>handlebars-jackson2</artifactId>
   <version>${handlebars-version}</version>
 </dependency>

helper 이름을 제외하고 Jackson1.x와 동일: Jackson2Helper

Markdown

Maven:

 <dependency>
   <groupId>com.github.jknack</groupId>
   <artifactId>handlebars-markdown</artifactId>
   <version>${handlebars-version}</version>
 </dependency>

Usage:

 handlebars.registerHelper("md", new MarkdownHelper());

 {{md context}}

context: 필수적으로 개체 또는 null 입니다.

Humanize

Maven:

 <dependency>
   <groupId>com.github.jknack</groupId>
   <artifactId>handlebars-humanize</artifactId>
   <version>${handlebars-version}</version>
 </dependency>

Usage:

 // Humanize helper를 모두 등록
 HumanizeHelper.register(handlebars);

추가 정보는 [HumanizeHelper] (https://github.com/jknack/handlebars.java/blob/master/handlebars-humanize/src/main/java/com/github/jknack/handlebars/HumanizeHelper.java)의 JavaDoc을 참조하세요.

SpringMVC

Maven:

 <dependency>
   <groupId>com.github.jknack</groupId>
   <artifactId>handlebars-springmvc</artifactId>
   <version>${handlebars-version}</version>
 </dependency>

Value resolvers 사용:

 HandlebarsViewResolver viewResolver = ...;

 viewResolver.setValueResolvers(...);

또한 HandlebarsViewResolver는 Spring의 MessageSource 클래스를 사용하는 message helper를 추가합니다.

{{message "code" [arg]* [default="default message"]}}

설명:

• code: 필수인 메시지의 코드
• arg: 선택 사항인 메시지의 인수
• default: 선택 사항인 기본값의 메시지

HandlebarsViewResolver를 확인하세요.

성능

Handlebars.java는 현대적이고 완전한 기능을 갖춘 템플릿 엔진이지만 매우 우수한 성능(Hbs)도 가지고 있습니다.

벤치마크 소스 코드는 여기입니다: https://github.com/mbosecke/template-benchmark

아키텍처 및 API 설계

• Handlebars.java follows the JavaScript API with some minors exceptions due to the nature of the Java language.
• Handlebars.java는 Java 언어의 특성으로 인해 JavaScript API의 일부 minors exceptions를 따릅니다.
• 파서는 ANTLR v4 위에 구축됩니다.
• 데이터는 기본 유형(int, boolean, double 등), 문자열, 맵, 목록 또는 JavaBeans 개체로 제공됩니다.
• Helper는 type-safe 입니다.
• Handlebars.java는 thread-safe 입니다.

Handlebars.java와 Handlebars.js의 차이점

Handlebars.java의 scope resolution은 Mustache Spec을 따릅니다. 예를 들어:

Given:

{
  "value": "parent",
  "child": {}
}

and

Hello {{#child}}{{value}}{{/child}}

will be:

Hello parent

이제 Handlebars.js가 있는 동일한 모델 및 템플릿은:

Hello

이는 Handlebars.js가 컨텍스트 스택에서 current scope에서 누락된 속성을 찾지 않기 때문입니다(이는 Mustache 사양과 일치함).

this.로 속성을 한정하여 Handlebars.java에서 컨텍스트 스택 lookup을 하는 것을 권장합니다:

Hello {{#child}}{{this.value}}{{/child}}

Handlebars.java와 Mustache.js의 차이점

• partial을 ​​로드할 수 없는 경우 Handlebars.java에서 java.io.FileNotFoundException이 발생합니다.

Status

Mustache 1.0 Compliant

• Mustache Spec의 123개 테스트 통과
• 테스트는 다음 목록에서 확인할 수 있습니다. comments.yml, delimiters.yml, interpolation.yml, inverted.yml, lambdas.yml, partials.yml, sections.yml

Handlebars.js Compliant

• Handlebars.js tests의 모든 테스트 통과
• 테스트는 다음 목록에서 확인할 수 있습니다. basic context, string literals, inverted sections, blocks, block helper missing, helper hash, partials

Dependencies

+- org.slf4j:slf4j-api:jar:1.6.4

FAQ

Contribute를 하고 싶으신가요?

• 이 project를 Fork 합니다.
• 어떤 작업을 해야 할지 궁금하세요? 작업/버그 목록을 보고 작업하고 싶은 것을 선택하십시오.
• 하나 이상의 helper를 donate 하시겠습니까? 커뮤니티 helper를 위한 저장소 handlebars=helpers를 참조하세요.
• issue나 fix는 issues list에서 만드세요.
• mailing list에 게시된 질문에 대한 답변을 알고 있다면 주저하지 말고 답장을 작성하세요.
• mailing list에서 아이디어를 공유하거나 질문을 하세요. 주저하지 말고 답장을 작성하세요. 그러면 javadocs/FAQ를 개선하는 데 도움이 됩니다.
• 특정 기능을 놓치면 mailing list를 찾아보거나 문의하세요. 주저하지 말고 답장을 작성하고 샘플 코드를 보여주세요. 문제를 설명합니다.
• handlebars.java를 사용하거나 확장하는 방법에 대한 블로그 게시물을 작성하십시오.
• 불분명한 것을 발견하면 javadoc/예외 메시지에 대한 변경 사항을 제안하십시오.
• 문서에 문제가 있는 경우 직관적이지 않거나 따르기 어렵습니다. - 알려주시면 제안에 따라 개선하도록 노력하겠습니다. 어떤 건설적인 비판도 매우 감사드립니다. 이것은 여가 시간에 개발되고 문서화된 오픈 소스 프로젝트라는 것을 잊지 마십시오.

도움말 및 지원

도움말 및 토론

버그와 Issues, Features

기부

Edgar 맥주를 사세요!

관련 프로젝트

• Handlebars.js
• Try Handlebars.js
• Mustache
• Humanize
• ANTLRv4

저작자

Edgar Espina

라이센스

Apache License 2

 

 

 

출처 :  jknack/handlebars.java