본문 바로가기

freemarker4

[Java] Freemarker - 데이터 모델(Data Model) 만들기 프리마커 템플릿 엔진은 템플릿과 데이터 모델을 이용해 문서를 생성한다. 데이터 모델은 HashMap 같은 객체를 이용할 수도 있지만 직접 프리마커 엔진이 해석할 수 있는 클래스를 정의할 수도 있다. 프리마커 엔진이 데이터 모델로 해석할 수 있도록 ObjectWrapper 클래스와 Adapter 클래스를 구현해줘야한다. 프리마커 엔진은 ObjectWrapper 클래스와 Adapter 클래스를 통해서 자바 객체를 트리형태로 해석한다. ObjectWrapper 우선 데이터 모델로 사용할 클래스는 ObjectWrapper 인터페이스를 구현해야한다. ObjectWrapper 인터페이스는 다음 메소드를 가지고 있다. TemplateModel wrap(Object obj) throws TemplateModelExce.. 2021. 7. 17.
[Java] 프리마커 스페셜 템플릿 변수들(Freemarker Special Variables) 프리마커 템플릿 언어(FTL, Freemarker Template Language)에는 몇가지 특별한 변수들이 있다. 이 특별 변수들을 사용하기 위해서 템플릿을 작성할 때 '.variable_name' 형태로 사용해야한다. 즉, auto_esc라는 특별 변수를 템플릿에서 사용하려면 .auto_esc로 사용해야한다. 프리마커 템플릿 언어의 특별 변수들은 기본적으로 스네이크 표현법을 지원하며 2.3.23 버전부터 카멜 표기법도 제공된다. 프리마커 특별 변수들 auto_esc auto-escaping 설정 여부를 의미하는 불리언 변수 caller_template_name 현재 매크로 혹은 함수가 호출된 템플릿의 이름(경로) current_template_name 현재 템플릿의 이름(경로) data_model .. 2021. 7. 16.
[Java] 프리마커 템플릿 언어(FTL, Freemarker Template Language) 문법 자바 템플릿 엔진(Java Template Engine)인 프리마커(Freemarker)는 FTL(Freemarker Template Language)라는 언어를 통해 템플릿을 작성할 수 있도록 한다. FTL에는 간단한 데이터 치환뿐만 아니라 조건문이나 반복문 같은 다양한 문법과 기능이 구현되어 있다. 따라서 FTL 문법을 잘 알고 있으면 효율적으로 템플릿을 작성할 수 있다. FTL의 모든 문법이나 정확한 기능에 대해서는 Freemarker 매뉴얼을 참고하도록 하자. 이 포스트에서는 자주 사용하는 FTL 문법과 기능을 소개하고 간단한 사용법을 예제를 통해 설명하겠다. assign 템플릿 작성시 변수를 사용하고 싶을 때, assign 디렉티브를 사용할 수 있다. 예를 들어 this code block as.. 2021. 7. 15.
[Java] 프리마커(Freemarker) - 자바 템플릿 엔진(Java Template Engine) 프리마커는 아파치 오픈소스로 공개되어 있는 자바 템플릿 엔진(Java Template Engine)이다. 템플릿 엔진(Template Engine)이란? 템플릿 엔진(Template Engine)이란 데이터 모델에서 정보를 얻어 템플릿 양식에 맞게 문서를 만들어주는 소프트웨어를 말한다. 템플릿 엔진의 사용자는 템플릿 정의 언어를 이용해서 문서화할 템플릿을 생성하고 템플릿 엔진에 입력한 다음 데이터 모델을 차례로 템플릿 엔진에 입력하여 문서를 만들어낸다. 템플릿 엔진 사용의 대표적인 예는 '웹 템플릿 엔진(Web template engine)'이다. 웹 페이지의 전체적인 아웃라인을 템플릿으로 만들어놓고, 페이지에 보여줄 상세한 데이터를 이용해 구체적인 HTML 문서를 만들어주는 형태로 템플릿 엔진이 사용된.. 2021. 7. 14.