상세 컨텐츠

본문 제목

Velocity 문법

프로그래밍/JAVA

by 라제폰 2011. 1. 20. 14:53

본문

Velocity

Rolizen Technet

 
Jump to: navigation, 찾기

<!-- start content -->

http://velocity.apache.org

템플릿 엔진

Spring과 함께 사용

전형적인 디렉토리 구조

그림

  • velocity와 velocity tool을 사용하기 위해 필요한 jar 파일을 lib에 넣어야 한다.
    • velocity-dep-*.jar : velocity 그리고 관련된 클래스 파일
    • velocity-tools-*.jar : velocity tool
    • commons-digester
    • commons-collections
    • commons-beanutils
  • /WEB-INF/velocity 를 velocity template 루트로 잡는다.
  • /WEB-INF/velocity/VM_global_library.vm 가 디폴트 매크로 파일이 된다.
  • /WEB-INF/toolbox.xml 은 velocity tool의 설정이다.
  • 각 설정파일의 위치를 변경하려면 *-servlet.xml에서 한다.

*-servlet.xml

  • -servlet.xml 에 velocity 관련 설정을 넣어 사용할 수 있다.

SpringMVC를 참고할 것.

velocity properties

velocity 관련 설정은 별도의 velocity.properties를 만들어 할 수도 있지만, *-servlet.xml에서 직접 할 수도 있다. 'velocityConfig' 부분의 'velocityProperties' 부분에 property를 추가하면 된다. velocity property의 전체 항목은 velocity jar 파일의 /org/apache/velocity/runtime/default/velocity.properties 에서 확인할 수 있다.

VM_global_library.vm

예를들어 다음과 같이 만들 수 있다.

 

#macro (xhtml)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
   PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
#end

VTL (Velocity Template Language) 문법

간단한 예제

----------------------------------------------------------------

<html>
<body>
#set ($foo = "Velocity")
Hello $foo World!
</body>
<html>

----------------------------------------------------------------

코멘트

## 로 시작하면 한 줄 코멘트

----------------------------------------------------------------

   ## 한 줄 코멘트 single-line comment
----------------------------------------------------------------

 

#* 로 시작하고 *#로 끝나면, 여러 줄 코멘트

----------------------------------------------------------------

   #*
    여러 줄 코멘트.
    여기에 표시되는 내용은
    Velocity Template Engine이 무시해버린다.
   *#
----------------------------------------------------------------

#** 로 시작하고 *#로 끝나면, 블록 코멘트. 사실 여러 줄 코멘트와 다를 것은 별로 없다. 저자나 버전 등을 넣는데 주로 사용한다.

----------------------------------------------------------------

   #**
    This is a VTL comment block and
    may be used to store such information
    as the document author and versioning
    information:
    @author
    @version 5
   *#

----------------------------------------------------------------

변수 Variable

변수는 $로 시작하며, [a-zA-Z0-9-_] 문자가 변수에 사용될 수 있다.

#set로 변수에 값을 세팅할 수 있다.

----------------------------------------------------------------

  #set ($foo = "bar")

----------------------------------------------------------------

원래는 ${foo} 형태가 정식적인(formal) 표현이다. 텍스트 중간에 변수가 들어갈 때 잘못 파싱되는 것을 방지하기 위해, 반드시 이 형태를 사용해야 할 경우가 있다.

----------------------------------------------------------------

   Jack is a $vicemaniac.
   Jack is a ${vice}maniac.


----------------------------------------------------------------

프라퍼티 Property

변수 안의 프라퍼티에 접근할 수 있다.

----------------------------------------------------------------

   $customer.address
   $purchase.total

----------------------------------------------------------------

Java Beans 표준의 property 규칙이 그대로 사용된다. (getX(), setX() 등)

메소드 Method

변수로부터 메소드를 곧바로 실행할 수도 있다.

----------------------------------------------------------------

$customer.getAddress()
$date.format("yyyy-MM-dd", $createTime)

----------------------------------------------------------------

조용한 레퍼런스 Quiet Reference

만약 $foo 라고 썼는데 foo 라는 이름의 객체가 존재하지 않는다면, $foo 라는 글자가 결과에 그대로 표현된다. 객체가 존재하지 않을 때 아무것도 표현되지 않게 하려면, $ 다음에 !를 붙인다.

----------------------------------------------------------------

<input type="text" name="email" value="$email"/>
<input type="text" name="email" value="$!email"/>

----------------------------------------------------------------

물론 정식적인 표현도 가능하다.

----------------------------------------------------------------

<input type="text" name="email" value="$!{email}"/>

----------------------------------------------------------------

escaping

'$' 를 표현하려면 \$ 로 한다. '\$' 는 '\\$' 로 표시한다.

혹은 다음과 같이 할 수 있다.

----------------------------------------------------------------

#set ($dollar = "$")
$dollar

----------------------------------------------------------------

지시자 Directive

지시자는 #로 시작한다. ${..}와 같은 이유로, #{..} 표현도 가능하다.

----------------------------------------------------------------

#if($a==1)true enough#elseno way!#end
#if($a==1)true enough#{else}no way!#end

----------------------------------------------------------------

#set

변수에 값을 지정하기 위해 사용한다.

----------------------------------------------------------------

#set ($primate = "monkey") ## literal
#set ($monkey = $bill) ## variable reference
#set ($monkey.Friend = "monica") ## string literal
#set ($monkey.Blame = $whitehouse.Leak) ## property reference
#set ($monkey.Plan = $spindoctor.weave($web)) ## method reference
#set ($monkey.Number = 123) ## number literal
#set ($monkey.Say = ["Not", $my, "fault"]) ## ArrayList
#set ($monkey.Map = {"banana" : "good", "roast beef" : "bad"}) ## Map

#set ($value = $foo + 1)
#set ($value = $bar - 1)
#set ($value = $foo * $bar)
#set ($value = $foo / $bar)

----------------------------------------------------------------

같은 변수에 다른 값을 넣으면, 마지막 넣은 값이 저장된다.

값을 unset 하는 기능은 없다.

Literal

set 할때 문자열은 큰따옴표(") 로 감싸진다. 이 안에 변수가 있으면, 그것도 해석(parse)된다.

----------------------------------------------------------------

#set( $directoryRoot = "www" )
#set( $templateName = "index.vm" )
#set( $template = "$directoryRoot/$templateName" )
$template

----------------------------------------------------------------

결과값은

----------------------------------------------------------------

www/index.vm

----------------------------------------------------------------

하지만 작은따옴표(')로 감싸면 해석되지 않는다.

----------------------------------------------------------------

#set( $foo = "bar" )
$foo
#set( $blargh = '$foo' )
$blargh

----------------------------------------------------------------

결과는

----------------------------------------------------------------

bar
$foo

----------------------------------------------------------------

조건문 if-else

----------------------------------------------------------------

#if ($foo < 10)
   Go North
#elseif ($foo == 10)
   Go East
#elseif ($bar == 6)
   Go South
#else
   Go West
#end

----------------------------------------------------------------

== 연산은 primitive, string, object를 비교하는데, object의 경우 toString()의 값이 비교된다.

AND 연산 : &&

----------------------------------------------------------------

#if ($foo && $bar)
   This AND that
#end

----------------------------------------------------------------

OR 연산 : ||

----------------------------------------------------------------

#if ($foo || $bar)
   This OR That
#end

----------------------------------------------------------------

NOT 연산 : !

----------------------------------------------------------------

#if (!$foo)
  NOT that
#end

----------------------------------------------------------------

$!foo 와 !$foo 를 혼동하지 말 것!

반복문 Loops

$allProducts가 List나 Array인 경우에는 이렇게 한다.

----------------------------------------------------------------

#foreach( $product in $allProducts )
   $product
#end

----------------------------------------------------------------

$allProducts가 Map이나 Hashtable이라면, 이렇게 할 수 있다.

----------------------------------------------------------------

#foreach( $key in $allProducts.keySet() )
   Key: $key -> Value: $allProducts.get($key)
#end

----------------------------------------------------------------

현재 루프 카운트는 $velocityCount로 알아올 수 있다.

----------------------------------------------------------------

#foreach( $customer in $customerList )
   $velocityCount : $customer.Name
#end

----------------------------------------------------------------

$velocityCount 이름과 0부터 시작하는지 1부터 시작하는지 등은 설정 가능하다.

include

----------------------------------------------------------------

#include ("one.txt")
#include ("one.gif","two.txt","three.htm")
#include ("greetings.txt", $seasonalstock)

----------------------------------------------------------------

파일의 내용을 그대로 include한다. 여러 파일을 한꺼번에 include할 수 있다. 파일 이름에 변수가 들어갈 수 있다.

parse

----------------------------------------------------------------

#parse ("me.vm")
----------------------------------------------------------------

파일을 파싱해서 그 결과를 include한다. 한번에 하나의 파일만 가능하다.

----------------------------------------------------------------

Count down.
#set ($count = 8)
#parse ("parsefoo.vm")
All done with dofoo.vm!

----------------------------------------------------------------

----------------------------------------------------------------
#set ($count = $count - 1)
#if ($count > 0)
   #parse ("parsefoo.vm")
#else
   All done with parsefoo.vm!
#end
----------------------------------------------------------------

재귀적으로 사용 가능한데, 깊이가 정해져있다. 깊이는 설정 가능하고, 디폴트로 10이다.

stop

----------------------------------------------------------------

#stop
----------------------------------------------------------------

파싱을 멈춘다.

매크로

일종의 함수 같은 것이다.

다음과 같이 정의하고,

----------------------------------------------------------------

#macro (d)
   <tr><td></td></tr>
#end

----------------------------------------------------------------

다음과 같이 사용한다.

----------------------------------------------------------------

#d()

----------------------------------------------------------------

파라미터를 매크로 이름 뒤에 변수로 받을 수 있다.

----------------------------------------------------------------

#macro (callme $a)
   $a $a $a
#end

----------------------------------------------------------------

이렇게 사용한다.

----------------------------------------------------------------

#callme ($foo.bar())

----------------------------------------------------------------

Velocity Tool

Cookie Tool

$cookie.foo.value
$cookie.add("cookieName", "cookieValue")

Import Tool

$import.read("http://www.rolizen.com/import/url")

Parameter Tool

$params.foo
$params.getString("foo")
$params.getNumber("foo")
$params.getInt("foo")

Alternator Tool

예를들어, 루프를 돌면서 table의 tr을 찍는데, 홀수줄은 흰색으로, 짝수줄은 회색으로 찍고 싶은 경우,

----------------------------------------------------------------

#set ($color = $alternator.auto(["fff", "eee"))
#foreach ($item in $listItems)
<tr style="background-color:#$color">...</tr>
#end

----------------------------------------------------------------

Date Tool

$date                                          -> 2007. 2. 5 오후 3:14:43
$date.get("yyyy-MM-dd HH:mm:ss")               -> 2007-02-05 15:14:43
$date.format("yyyy-MM-dd HH:mm:ss", $myDate)   -> 2007-02-03 16:31:34

Number Tool

#set ($val = 1234567)
$number.format("currency", $val)   -> ￦1,234,567
$number.format("integer", $val)    -> 1,234,567
$number.format("0,000", $val)      -> 1,234,567
$number.format("0,0000", $val)     -> 123,4567
$number.format("0", $val)          -> 1234567

Escape Tool

----------------------------------------------------------------

$html                        -> "bread" & "butter"
$esc.html($html)             -> "bread" & "butter"

----------------------------------------------------------------
$xml                         -> "bread" & "butter"
$esc.xml($xml)               -> "bread" & "butter"

----------------------------------------------------------------
$javascript                  -> He didn't say, "Stop!"
$esc.javascript($javascript) -> He didn\'t say, \"Stop!\"
----------------------------------------------------------------

$esc.dollar                  -> $
$esc.d                       -> $

----------------------------------------------------------------
$esc.hash                    -> #
$esc.h                       -> #

----------------------------------------------------------------
$esc.backslash               -> \
$esc.b                       -> \

----------------------------------------------------------------
$esc.quote                   -> "
$esc.q                       -> "

----------------------------------------------------------------
$esc.singleQuote             -> '
$esc.s                       -> '

----------------------------------------------------------------
$esc.exclamation             -> !
$esc.e                       -> !
----------------------------------------------------------------

Iterator Tool

List Tool

List나 Array에서 엘리먼트를 get / set 할 수 있다.

----------------------------------------------------------------

$primes                    -> new int[] {2, 3, 5, 7}
$list.size($primes)        -> 4
$list.get($primes, 2)      -> 5
$list.set($primes, 2, 1)   -> (primes[2] becomes 1)
$list.get($primes, 2)      -> 1
$list.isEmpty($primes)     -> false
$list.contains($primes, 7) -> true

----------------------------------------------------------------

Math Tool

Sorter Tool

Velocity Tool 만드는 법

일반적인 Tool

그냥 일반적인 class를 만들면 된다. public한 field와 method를 사용할 수 있다.

context 를 갖는 Tool

<PRE>----------------------------------------------------------------
public class MemberUtil { private HttpServletRequest request; private HttpSession session; private MemInfoData meminfo; public void init(Object obj) { ChainedContext cc = (ChainedContext)obj; this.request = cc.getRequest(); this.session = request.getSession(true); meminfo = (MemInfoData)session.getAttribute(MemInfoData.MEMINFO_SESSION_KEY); if (!validMemInfo(meminfo)) meminfo = null; } private boolean validMemInfo(MemInfoData mid) { return (mid != null) && (mid.getMemNo() > 0) && (mid.getOpenid() != null); } public HttpServletRequest getRequest() { return request; } public HttpSession getSession() { return session; } public MemInfoData getMeminfo() { return meminfo; } public boolean isLogin() { return (meminfo != null); }}----------------------------------------------------------------
</PRE>

위와 같이 init() 메소드를 이용해 context를 받을 수 있다.

Velocity Editor

eclipse plugin : http://velocitywebedit.sourceforge.net/

<!-- Saved in parser cache with key technet_wiki:pcache:idhash:1461-0!1!0!!ko!2!edit=0 and timestamp 20090401045639 -->

원본 주소 ‘http://technet.ui2.co.kr/wiki/index.php/Velocity’

관련글 더보기

티스토리툴바