Velocity 설정 및 사용법

버전

velocity-1.7.jar

velocity-tools-2.0.jar

의존 라이브러리

commons-beanutils-1.7.0.jar

commons-collections-3.1.jar

commons-digester-2.0.jar

commons-lang-2.5.jar

commons-logging-1.1.1.jar

web.xml

<!-- Define Velocity template compiler -->

<servlet>

<servlet-name>velocity</servlet-name>

<servlet-class>

org.apache.velocity.tools.view.servlet.VelocityViewServlet</servlet-class>

<!-- Unless you plan to put your toolbox.xml and velocity.properties under 

different folders or give them different names, then these two init-params 

are unnecessary as of VelocityTools 1.3. The VelocityViewServlet will automatically 

look for these files in the following locations. -->

<init-param>

<param-name>org.apache.velocity.toolbox</param-name>

<param-value>/WEB-INF/tools.xml</param-value>

</init-param>

<init-param>

<param-name>org.apache.velocity.properties</param-name>

<param-value>/WEB-INF/velocity.properties</param-value>

</init-param>

</servlet>

<!-- Map *.vm files to Velocity -->

<servlet-mapping>

<servlet-name>velocity</servlet-name>

<url-pattern>*.vm</url-pattern>

</servlet-mapping>

 

tools.xml (옵션)

공통으로 사용되는 값

명시 안했을 시 velocity-tools-2.0.jar 파일 안에 있는

org/apache/velocity/tools/generic/tools.xml

org/apache/velocity/tools/view/tools.xml

org/apache/velocity/tools/struts/tools.xml

사용

<?xml version="1.0"?>

<tools>

    <data type="boolean" key="xhtml" value="true"/>

    <data type="boolean" key="isSimple" value="true"/>

    <data type="number" key="version" value="2.0"/>

    <data key="foo">this is foo</data>

    <data key="bar">this is bar.</data>

    <toolbox scope="session">

        <tool key="map" class="java.util.HashMap"/>

    </toolbox>

</tools>

 

velocity.properties (옵션)

기본은 velocity-1.7.jar 파일의 org/apache/velocity/runtime/defaults/velocity.properties 설정 파일을 사용

input.encoding = UTF-8

output.encoding = UTF-8

문법

참고: http://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html

주석

## 한줄주석

#* *# 여러줄 주석

변수

명명은 a-z,A-Z,0-9,-,_ 사용 가능 예) $foo-0

시작은 a-z,A-Z,_ 사용 가능 예) $_aA (o), $1aA (x), $-aA (x)

사용법

#set ( $_foo = "Hello" )

$_foo == ${foo} == $!foo == $!{foo} -> ! : 값이 정의되지 않은 변수는 공백처리. 없으면 변수명을 보여줌

사용 가능한 타입

Variable reference

String literal

Property reference

Method reference

Number literal

ArrayList

Map

작성중...

끝.