xyz.cofe.text.template

Class TemplateParser

java.lang.Object

xyz.cofe.text.template.TemplateParser

public class TemplateParser
extends Object

Парсер шаблонов.
Синтаксис:

 Правила
 start ::= startAnyChar
         | startCodeBegin
         | startEscape
         .
 
 startAnyChar ::= startText start
                | startText
                .
 
 startText ::= anyChar | blockBegin | blockEnd .
 
 startCodeBegin ::= code start
                  | code
                  .
 
 startEscape ::= escape start
               | escape
               .
 
 code ::= codeBegin blockBody blockEnd .
 
 blockBody ::= anyChar blockBody
             | anyChar
             | escape blockBody
             | escape
             | block blockBody
             | block
             .
 
 block ::= blockBegin blockBody blockEnd .
 
 Лексемы
 Лексемы перечисле в порядке уменьшения приоритета
 
 escape ::= \$  # интерпретирует как $
          | \\  # интерпретирует как \
          | \${ # интерпретирует как ${
          .
 
 codeBegin  ::= ${ .
 blockBegin ::= { .
 blockEnd   ::= } .
 
 anyChar # любой символ кроме выше указанных лексем
 

Author:

Kamnev Georgiy (nt.gocha@gmail.com)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	TemplateParser.Mapping<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
protected String[]	blockBeginLexems
protected String[]	blockEndLexems
protected String[]	codeBeginLexems
protected LinkedHashMap<String,String>	currentEscapeRewriteMap
protected String[]	escapeLexems
protected LinkedHashMap<String,String>	escapeRewriteMap
protected Func1<AstNode,Pointer<Token>>	start_any
protected Func1<AstNode,Pointer<Token>>	start_code
protected Func1<AstNode,Pointer<Token>>	start_escape
protected Map<String,Func1<AstNode,Pointer<Token>>>	start_patterns

Constructor Summary

Constructors

Constructor and Description
TemplateParser()

Method Summary

Modifier and Type	Method and Description
protected LinkedHashMap<String,String>	createEscapeRewriteMap()
<ResultType,EvalCode,EvalText> Func0<ResultType>	eval(AstNode tree, Func1<EvalText,String> evalText, Func1<EvalCode,String> evalCode, Func0<ResultType> initResult, Func2<ResultType,ResultType,EvalText> appendText, Func2<ResultType,ResultType,EvalCode> appendCode) Обход шаблона (AST дерева) и форматирование сообщения
Func0<String>	evalAndPrint(AstNode tree, Func1<String,String> evalCode) Обход шаблона (AST дерева) и форматирование сообщения
Func0<String>	evalAndPrint(AstNode tree, Func1<String,String> evalText, Func1<String,String> evalCode) Обход шаблона (AST дерева) и форматирование сообщения
protected String[]	getBlockBeginLexems()
protected String[]	getBlockEndLexems()
protected String[]	getCodeBeginLexems()
protected String[]	getEscapeLexems()
protected LinkedHashMap<String,String>	getEscapeRewriteMap()
protected <K,V> TemplateParser.Mapping<K,V>	map(K k, V v)
AstNode	parse(String source) Парсинг шаблона и формирование соответ AST дерева
protected AstNode	start(Pointer<Token> ptr)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

escapeRewriteMap

protected LinkedHashMap<String,String> escapeRewriteMap

codeBeginLexems

protected String[] codeBeginLexems

escapeLexems

protected String[] escapeLexems

blockBeginLexems

protected String[] blockBeginLexems

blockEndLexems

protected String[] blockEndLexems

currentEscapeRewriteMap

protected LinkedHashMap<String,String> currentEscapeRewriteMap

start_code

protected final Func1<AstNode,Pointer<Token>> start_code

start_any

protected final Func1<AstNode,Pointer<Token>> start_any

start_escape

protected final Func1<AstNode,Pointer<Token>> start_escape

start_patterns

protected final Map<String,Func1<AstNode,Pointer<Token>>> start_patterns

Constructor Detail

TemplateParser

public TemplateParser()

Method Detail

getEscapeRewriteMap

protected LinkedHashMap<String,String> getEscapeRewriteMap()

createEscapeRewriteMap

protected LinkedHashMap<String,String> createEscapeRewriteMap()

getCodeBeginLexems

protected String[] getCodeBeginLexems()

getEscapeLexems

protected String[] getEscapeLexems()

getBlockBeginLexems

protected String[] getBlockBeginLexems()

getBlockEndLexems

protected String[] getBlockEndLexems()

eval

public <ResultType,EvalCode,EvalText> Func0<ResultType> eval(AstNode tree,
                                                             Func1<EvalText,String> evalText,
                                                             Func1<EvalCode,String> evalCode,
                                                             Func0<ResultType> initResult,
                                                             Func2<ResultType,ResultType,EvalText> appendText,
                                                             Func2<ResultType,ResultType,EvalCode> appendCode)

Обход шаблона (AST дерева) и форматирование сообщения

Type Parameters:

ResultType - Результирующий тип данных

EvalCode - Тип данных в результате вычисления кода в внутри шаблона

EvalText - Тип данных в результате вычисления текста в внутри шаблона

Parameters:

tree - AST дерево шаблона (результат парсинга шаблона)

evalText - функция вычисления текста

evalCode - функция вычисления кода (вставок в шаблон ${})

initResult - функция начального результирующего значения

appendText - функция сумирования результирующего значения и текста

appendCode - функция сумирования результирующего значения и кода

Returns:

Результирующее значение

evalAndPrint

public Func0<String> evalAndPrint(AstNode tree,
                                  Func1<String,String> evalCode)

Обход шаблона (AST дерева) и форматирование сообщения

Parameters:

tree - AST дерево шаблона (результат парсинга шаблона)

evalCode - функция вычисления кода (вставок в шаблон ${})

Returns:

Результирующее значение

evalAndPrint

public Func0<String> evalAndPrint(AstNode tree,
                                  Func1<String,String> evalText,
                                  Func1<String,String> evalCode)

Обход шаблона (AST дерева) и форматирование сообщения

Parameters:

tree - AST дерево шаблона (результат парсинга шаблона)

evalText - функция вычисления текста

evalCode - функция вычисления кода (вставок в шаблон ${})

Returns:

Результирующее значение

parse

public AstNode parse(String source)

Парсинг шаблона и формирование соответ AST дерева

Parameters:

source - шаблон

Returns:

AST дерево

map

protected <K,V> TemplateParser.Mapping<K,V> map(K k,
                                                V v)

start

protected AstNode start(Pointer<Token> ptr)