1. 역슬래시 \ 이스케이프 규칙

미리 선언한 변수：#set($dog = "woof woof")

1. Velocity 변수명은반드시 문자로 시작해야 합니다. $10.0은 변수로 인식하지 않고 그대로 출력하므로 마이크로소프트 $10.0 달러처럼 쓸 때 별도 이스케이프 불필요；
2. 연속된 역슬래시는 두 개씩 상쇄；\$ 조합만 달러 기호를 이스케이프할 수 있음；
3. 페이지에 $변수이름을 그대로 보여주려면 표준 문법：\$dog。

2. #if 분기 조건 문법

#set($ages = 22)
#if ($ages <13)
    <h1>당신은 어린이입니다</h1>
#elseif ($ages <18)
    <h1>당신은 청소년입니다</h1>
#elseif ($ages <35)
    <h1>당신은 청년입니다</h1>
#elseif ($ages <60)
    <h1>당신은 중년입니다</h1>
#else
    <h1>당신은 노년입니다</h1>
#end

실행 결과

$ages=22，22 < 35 조건 만족 → 출력：<h1>당신은 청년입니다</h1>

주의사항

1. 블록 끝에반드시 #end를 적어 닫아야 합니다. 빠지면 오류 발생；
2. 키워드：#elseif（#else if처럼 공백 넣으면 안 됩니다，잘못된 문법）；
3. 조건에서 사용 가능：< > <= >= == != && || 등 연산자；
4. 위에서부터 순서대로 판단하며, 조건에 맞는 첫 번째 분기만 실행하고 나머지는 무시합니다.

이스케이프와 if 조건문

1. 백엔드 Person 엔티티 코드(C#)

public class Person
{
    private string name;
    public string Name
    {
        get { return name; }
        set { name = value; }
    }
    private int age;
    public int Age
    {
        get { return age; }
        set { age = value; }
    }

    //매개변수 없는 생성자
    public Person(){}
    //매개변수가 있는 생성자
    public Person(string name, int age)
    {
        this.name = name;
        this.age = age;
    }

    //매개변수 없는 인스턴스 메서드
    public string getMyName()
    {
        return this.name;
    }

    //다중 매개변수 인스턴스 메서드
    public string JoinStr(string str1, string str2)
    {
        return str1 + str2;
    }
}

C# 백엔드 코드에서 객체 변수 설정

Person pTest = new Person("Tom", 22);
context.Put("pTest", pTest);

2. VTL 템플릿 코드 & 렌더링 설명

메서드 호출<br />
$pTest.getMyName();

#set($a = "hello")
#set($b = "foxdevelop")

$pTest.JoinStr($a, $b);

1. $pTest.getMyName()

• 객체의매개변수 없는 메서드 getMyName() 호출
• 반환값 Tom

Velocity 매개변수 없는 메서드 호출：괄호() 생략 가능，$pTest.getMyName 는 $pTest.getMyName()와 동일

2. $pTest.JoinStr($a, $b)

• 문자열 매개변수 두 개를 받는 메서드 호출
• VTL이 먼저 $a、$b를 해석한 뒤 실인자 "hello"、"foxdevelop" 전달
• 문자열 결합 결과 반환：hellofoxdevelop

요약

1. 메서드 이름은 대소문자를 엄격히 구분
   C# getMyName() ≠ GetMyName()，템플릿은 코드 표기와 일치해야 합니다.
2. 매개변수는 변수를 그대로 사용
   따옴표를 추가하지 마세요，$pTest.JoinStr($a,$b)가 올바릅니다；$pTest.JoinStr("$a","$b")로 쓰면 리터럴 문자열”$a”가 전달됩니다
3. 속성과 메서드 구분

• $pTest.Name → 속성 접근(getter)
• $pTest.getMyName() → 메서드 호출

1. 반환값 자동 출력
   템플릿에 $객체.메서드()를 적으면 Velocity가 반환값을 자동으로 출력；출력이 필요 없으면 #set으로 결과를 받습니다：

#set($result = $pTest.JoinStr($a,$b))

3. 최종 페이지 렌더링 결과

메서드 호출
Tom;

hellofoxdevelop;

확장 메서드

변수 기본 설정：#set ($valok = "hello foxdevelop")

변수 경계 ${} 와 . 접근 차이 분석

${valok}.cn 변수 + 접미사 연결
${valok.cn} valok 객체 안의 cn 속성 접근

작은따옴표 / 큰따옴표 & 변수 붙여쓰기

코드	렌더링 결과	원리 설명
what$valok	whathello foxdevelop	직접 연결, Velocity가 자동으로 변수 경계를 인식
what$"valok"	what$”valok”	문법 오류. $ 바로 뒤에 따옴표를 쓸 수 없어 변수를 분석할 수 없음
what"$valok"	what”hello foxdevelop“	따옴표는 일반 문자일 뿐 템플릿 안에서 문자열 구문으로 작동하지 않고 변수는 정상 처리됨
what'$valok'	what’hello foxdevelop‘	위와 동일, 작은따옴표도 평범한 문자
$valokwhat	$valokwhat	변수 인식 불가! Velocity가 valokwhat 전체를 변수명으로 보고 없으면 원문을 출력
${valok}what	hello foxdevelopwhat	중괄호로 범위를 고정, 변수와 글자가 붙는 문제 해결

정리

1. 변수가 다른 글자와 이어질 때 반드시 ${변수이름} 사용
   잘못된 예：$valokwhat；올바른 예：${valok}what
2. 접미사 붙일 때：${valok}.cn 이지 ${valok.cn}으로 쓰지 마세요
3. $!변수 조용한 참조：변수가 없으면 빈 값이 나오고 $xxx가 출력되지 않음
4. 템플릿 HTML 안의 따옴표는 그냥 문자；#set 할당 구문 안에서만 작은따옴표(변수 해석 안함), 큰따옴표(변수 해석함) 차이가 생깁니다

#set($a = "$valok") // 큰따옴표：변수 해석, a=hello bamn
#set($a = '$valok') // 작은따옴표：변수 해석 안함, a=$valok

변수 경계 보충 설명

1. 문자열 List 순회하기

C# 백엔드 코드

List<string> strList = new List<string>() {"dsd","sdfsd","asdfsd","asdfsdfsd"};
context.Put("strList", strList);

Velocity 템플릿 코드

#foreach($str in $strList)
    $str <br/>
#end

실행 결과: 리스트의 각 문자열을 반복해서 가져오고 줄 바꿈하여 출력합니다.

문법 설명

#foreach(반복변수 in 컬렉션) 로 반복문을 시작하고 #end 로 반복문을 마칩니다.

2. 사용자 정의 엔티티 클래스 List 순회

1. Person 엔티티(C#)

public class Person
{
    private string name;
    public string Name
    {
        get { return name; }
        set { name = value; }
    }
    private int age;
    public int Age
    {
        get { return age; }
        set { age = value; }
    }
    public Person(){}
    public Person(string name,int age)
    {
        this.name = name;
        this.age = age;
    }
}

2. 백엔드에서 List 구성

List<Person> pList = new List<Person>();
pList.Add(new Person("Jack", 1));
pList.Add(new Person("Ben", 11));
pList.Add(new Person("Kevin", 100));
pList.Add(new Person("Simon", 500));
pList.Add(new Person("Lulu", 20));
context.Put("pList", pList);

3. 템플릿에서 속성 접근 문법

템플릿 코드:

#foreach($per in $pList)
<tr>
    <td>$per.name</td>
    <td>$per.age</td>
</tr>
#end

데이터를 읽어올 수 없습니다! 오류가 발생하거나 빈 화면이 표시됩니다

근본 원리

Velocity 객체 속성 접근 규칙：
$per.xxx 는 자동으로 public Get 메서드 GetXxx() 를 찾습니다

• $per.name → per.getName() 호출 시도
• $per.age → per.getAge() 호출 시도

작성한 엔티티:

• private 필드：name、age
• public 속성은 첫 글자 대문자：Name、Age，대응 메서드 GetName()、GetAge()

올바른 템플릿 작성법:

#foreach($per in $pList)
<tr>
    <td>$per.Name</td>
    <td>$per.Age</td>
</tr>
#end

참고: C#은 속성 첫 글자를 대문자로 사용하는 규칙이고 Java 엔티티는 보통 소문자를 사용합니다. 초보자가 자주 실수하는 대소문자 함정입니다.

3. #foreach 내장 변수

반복문 안에서 바로 사용할 수 있는 내장 변수입니다:

예시:

#foreach($per in $pList)
    $foreach.count 、이름：$per.Name
#end

4. 테이블 출력

<table border="0" cellpadding="0" cellspacing="0">
#foreach($per in $pList)
    <tr>
        <td>$per.Name</td>
        <td>$per.Age</td>
    </tr>
#end
</table>

정리

1. #foreach(변수 in 컬렉션) + #end 는 Velocity 표준 반복문;
2. 일반 List 순회 시 $변수 를 직접 출력;
3. 엔티티 객체 순회：$객체.속성이름 대소문자를 정확히 일치시키고 private 필드에 접근하지 마세요;
4. C# 엔티티 속성은 첫 글자를 대문자로 통일하고 템플릿도 동일하게 작성;
5. 데이터가 비어있으면 먼저 속성 대소문자, get 접근자 존재 여부 를 확인하세요.

컬렉션 순회

1. 템플릿 주석 구분

개발 권장：업무 관련 코드 주석은 ## / #* *# 를 우선 사용하여 페이지 소스에 주석 내용이 노출되지 않도록 하세요.

2. 변수 명명 규칙

공식 기본 명명 규칙

1. 변수의 첫 글자는영문자(a‑z / A‑Z)여야 합니다
2. 이후 사용 가능 문자：영문자, 숫자0‑9, 밑줄_, 하이픈-

하이픈 - 의 연산자 모호성 문제

#set($name-d = "test")

실행 시 오류가 발생：Encountered "name" ... Was expecting one of:
원인：Velocity가 - 를 빼기 연산자로 인식하기 때문입니다!
엔진은 $name - d 로 해석하여 변수 $name 에서 변수 d 를 빼는 연산으로 판단해 문법 충돌이 생깁니다.

두 가지 해결방법：

1. 권장：밑줄을 사용한 명명 (모호성 없음, 일반적인 코딩 규약)

#set($name_d = "hello world")

2. 중괄호로 변수 범위 지정 (하이픈이 들어간 변수명 지원)

#set(${name-d} = "hello world")
${name-d}

유효/무효 예시 비교

# 정상
#set($name_d = "밑줄")
#set($name12d = "영문자 시작 + 숫자")
#set(${name-1_2d} = "하이픈 사용 시 중괄호 필수")

# 중괄호 없이 하이픈 사용 → 구문 분석 오류
#set($name-d = "오류 발생!")
#set($name-1_2d = "오류 발생!")

3. #set 문법 작성 규칙

표준 작성법 (괄호 주변 공백은 자유롭게, 통일된 스타일 권장)

#set($변수이름 = "값")

문자열은 큰따옴표로 감싸야 합니다. 등호 좌우에 공백을 넣으면 가독성이 좋아집니다.

주석

1. 핵심 역할

Velocity 템플릿 엔진은 #include / #parse 로 템플릿 재사용을 구현합니다.
페이지 상단 네비게이션 _head.htm, 하단 저작권 정보 _footer.htm 같은 공통 부분을 별도 서브템플릿으로 분리해서 불러오면 HTML 코드 중복을 피할 수 있습니다.

2. 두 지시자의 핵심 차이

1. #include("파일경로")

파일 원문을 그대로 출력만 할 뿐, 서브템플릿 안의 Velocity 변수($!{xxx})는 해석하지 않습니다

• 서브템플릿 안의 $!{testinclude}는 렌더링되지 않고 문자열 그대로 출력됩니다 $!{testinclude}
• 여러 파일을 한 번에 불러오기 지원：#include("a.htm","b.htm")
• 적합：변수가 없는 순수 정적 HTML, 정적 코드 조각

2. #parse("파일경로")

서브템플릿을 불러오고 Velocity 문법을 전부 해석합니다. 부모 템플릿에서 넘긴 변수가 서브템플릿에서 정상적으로 렌더링됩니다.

• 서브템플릿의 $!{testinclude}는 컨텍스트 변수를 읽어 백엔드에서 전달한 값으로 교체됩니다
• 단일 파일 경로만 허용하며 여러 파일을 동시에 불러올 수 없습니다
• 적합：변수를 사용하는 공통 헤더, 푸터 등의 템플릿(페이지 제목, 동적 저작권 문구 등)

메모 노트 내용：
#include는 서브템플릿 코드를 그대로 붙여넣을 뿐 해석하지 않고, #parse는 문법 해석을 진행합니다

3. 실제 예시

1. 백엔드 코드(.cs)

context.Put("testinclude", "서브템플릿 문자열：");

2. 서브템플릿 _footer.htm 내용

저작권 정보 $!{testinclude}

케이스① #include("./themes/default/_footer.htm") 사용

페이지 출력 결과：

저작권 정보 $!{testinclude}

변수가 해석되지 않고 플레이스홀더 그대로 출력됩니다.

케이스② #parse("./themes/default/_footer.htm") 사용

페이지 출력 결과：

저작권 정보 서브템플릿 문자열：

변수가 정상적으로 렌더링됩니다. 실제 프로젝트에서 헤더·푸터 공통 템플릿에#parse를 우선 사용하는 이유입니다.

4. 사용 시나리오 권장

개발 규칙：
동적 변수가 쓰일 가능성이 있는 네비게이션, 푸터 저작권 등 공통 컴포넌트는 #parse를 사용하고, 완전 정적 텍스트나 스타일 조각에는 #include를 사용합니다.

템플릿 재사용

1. 변수 정의 #set()

변수를 정의하는 두 가지 방식:
방식1: 백엔드 C#/Java 코드에서 미리 변수를 정의하고 템플릿 페이지에서 읽어오기;
방식2: 템플릿 안에서 #set()으로 직접 변수 정의(이번 강의 핵심)

#set($name = "hello foxdevelop.com")
#set($okay = "common baby")
#set($nameokay = "$name|$okay")

• #set(변수 = 값)：문자열, 숫자, 배열, 객체 속성, 다른 변수 할당을 지원합니다
• 약타입 언어이므로 변수 타입 선언이 필요 없습니다

2. 변수 렌더링 문법 및 규칙

2.1 기본 형식

• $name：변수가 없으면 $name 문자열 그대로 출력
• $!name：자동 비우기 렌더링，변수가 없을 때 빈 값 출력. 페이지에 $xxx가 보이는 것을 막으므로 권장
• 권장 표준 문법：${name}（중괄호로 변수 범위를 명확히 구분）

2.2 경계 문제 예시

#set($name = "hello")
$namehello     × 엔진이 $namehello 라는 변수로 인식해 찾지 못함
${name}hello   √ 정상, $name을 해석한 뒤 hello 텍스트 이어 붙임

3. 한 줄 주석 ##

## 여기는 주석, 최종 결과에 출력되지 않음
#set($name = "test") ## 줄 끝에도 주석 작성 가능

1. 주석 내용은최종 렌더링된 페이지에 출력되지 않습니다;
2. 브라우저에서 페이지 소스 보기를 해도주석 텍스트가 보이지 않습니다（템플릿 엔진 처리 단계에서 제거）.

4. #set에서 지원하는 여러 할당 타입

## 문자열 할당
#set($name = "hello world")

## 변수를 다른 변수에 복사
#set($obj= $name)

## 객체 속성 할당
#set($obj.Friend = "monica")
#set($obj.Blame = $whitehouse.Leak)

## 메서드 호출 결과 할당
#set($obj.Plan = $spindoctor.weave($web))

## 숫자 할당
#set($obj.Number = 123)

## 배열 할당
#set($obj.Say = ["Not", $my, "fault"])

5. 변수가 존재하지 않을 때 특수 규칙

$sadfsdfsd

템플릿 엔진이 해당 변수를 찾지 못할 경우：

• 일반 문법 $sadfsdfsd：문자열 $sadfsdfsd 그대로 출력
• $!sadfsdfsd로 작성：변수가 없으면 빈 문자열 출력

템플릿 안에서 변수 설정하기

1. PageInfo 엔티티 클래스

지금까지 문자열만 전달했는데 효율이 낮고 유지보수가 불편합니다. 엔티티 클래스로 데이터를 묶으면 코드가 훨씬 직관적이게 됩니다.

public class PageInfo
{
    private bool IsShowImage;
    public bool IsShowImage1
    {
        get { return IsShowImage; }
        set { IsShowImage = value; }
    }
}

• 비공개 필드 IsShowImage, 공개 속성 IsShowImage1으로 외부에 노출
• 템플릿 접근 문법: $info.IsShowImage1

2. 컨텍스트 데이터 채우기

//템플릿 컨텍스트 컨테이너
IContext context = new VelocityContext();

PageInfo pi = new PageInfo();
pi.IsShowImage1 = true;

//객체 pi를 키 이름 info로 컨텍스트에 저장
context.Put("info",pi);

//문자열 변수 예시
context.Put("infotitle","안녕하세요");

context.Put("키이름",데이터)：데이터를 템플릿으로 넘기고 템플릿은 $키이름으로 읽어옵니다.

2. Velocity 템플릿 핵심 문법

2.1 지시자 기호 #

#로 시작하는 구문은 지시자입니다. 자주 쓰이는 지시자:
#if, #else, #end, #foreach, #set, #include

조건 렌더링 예시:

이미지 두 장을 준비한 뒤 웹사이트 루트의 Contents/Images 폴더에 넣으세요. IsShowImage1 값을 바꿔서 보여줄 이미지를 전환합니다.

#if($info.IsShowImage1)
    <img src="./Contents/Images/a.gif" />
#else
    <img src="./Contents/Images/b.gif" />
#end

로직: IsShowImage1=true일 때 a.gif 표시, 그 외에는 b.gif 표시

2.2 변수 기호 $

• $변수이름：변수 값 출력
• ${변수이름}：변수 경계 지정 (중요!)

사용 상황: 변수 바로 뒤에 문자가 이어질 때 엔진이 변수 이름 끝을 구분하지 못함

잘못된 표기: $infotitlefoxdevelop.com
엔진이 변수명을 infotitlefoxdevelop로 인식하며 존재하지 않는 변수로 취급합니다.

올바른 표기: ${infotitle}foxdevelop.com
infotitle 변수를 해석한 뒤 foxdevelop.com 문자열을 이어 붙임

2.3 무음 출력 수식자 ! → $!변수이름

기본 동작: 변수가 없으면 페이지에 $변수이름 문자 그대로 출력
$!변수이름：변수가 없거나 null일 때 아무것도 출력하지 않고 $ 기호도 표시하지 않음

비교 예시:

전체 테스트 코드:

${infotitle}foxdevelop.com <br/>
$!infotitlefoxdevelop.com <br/>
$infotitle <br/>
$!infotitle <br/>

정리

1. 변수 뒤에 문자열을 이어 붙일 때 반드시 ${변수}로 감싸기
2. 실제 운영 환경에서는 $!{변수이름}을 우선 사용, null일 때 원본 $xxx가 출력되어 레이아웃이 깨지는 것을 방지
3. #if로 불리언 속성 판단 시 그대로 #if($info.IsShowImage1)로 작성, ==true 불필요

기본 템플릿 문법

소개

ASP.NET 프로젝트에서 널리 사용됩니다;
ASP.NET MVC에는 Razor 템플릿이 기본으로 탑재되어 있습니다.

기존 .aspx 페이지 기반 프로젝트에 MVC 패턴을 적용하고 싶은 개발자들이 많이 NVelocity를 선택했습니다.

NVelocity는 이미 유지보수가 중단되었으며 오래된 .NET Framework 레거시 프로젝트에서만 사용합니다. 신규 프로젝트는 Razor, Handlebars.NET 등 현대적인 템플릿 엔진을 우선 사용하는 것이 좋습니다.

.NET Framework 버전별 호환 NVelocity 버전

Velocity는 역사가 긴 Java 템플릿 엔진으로 구문이 간결하며 #, $ 기호를 템플릿 마커로 활용합니다. NVelocity는 이 구문을 완전히 포팅했습니다.

다운로드

공식 마지막 업데이트는 2018년이며 최신 버전은 1.2.0입니다.

아래 주소에서 소스 코드를 내려받을 수 있습니다.

오픈소스 프로젝트로 GitHub에서 관리되고 있습니다 castleproject/NVelocity: Castle’s NVelocity

공식 저장소에는 컴파일된 dll 파일이 없으므로 소스를 다운로드한 뒤 직접 빌드하거나 프로젝트 자체를 솔루션에 포함시켜 사용하면 됩니다.

Visual Studio로 sln 파일을 엽니다.

마지막 릴리즈 버전은 .NET Core 2.1 기반이므로 필요하다면 .NET 4.8로 업그레이드하는 것을 권장합니다.

빌드가 완료되면 출력 폴더에서 dll 파일을 확인할 수 있습니다.

그러고 나서 다른 ASP.NET 웹 프로젝트에 참조를 추가하면 됩니다. 방금 생성한 NVelocity.dll을 웹 프로젝트에 포함시키세요.

프로젝트 적용 방식

프로젝트에 어셈블리 참조 추가: NVelocity.dll
주요 장점: 이 템플릿 엔진을 활용하면 웹사이트의 테마 전환 기능을 간편하게 구현할 수 있습니다.

웹 사이트 루트 경로에 Themes 폴더를 생성해 모든 템플릿을 보관하는 기본 디렉터리로 지정합니다.
Themes 안에 여러 테마 폴더를 만들 수 있습니다. 예시는 다음과 같습니다.

사이트 루트에 Themes 폴더를 만들어 테마 저장 경로로 사용합니다.

테마 디렉터리 구조

default 폴더를 만들어 기본 템플릿으로 지정합니다.
필요에 따라 Themes/blue, Themes/dark 등 여러 템플릿 세트를 추가할 수 있습니다.

사이트 루트
└── Themes
    ├── default      # 기본 테마 템플릿 파일
    ├── dark         # 어두운 테마 템플릿 파일
    └── blue         # 파란색 테마 템플릿 파일

실행 시 설정 파일에서 활성화된 테마 이름을 읽고 NVelocity가 해당 테마 폴더 안의 템플릿을 불러옵니다.
테마 전환의 원리: 설정값을 수정해 다른 테마 폴더를 가리키도록 할 뿐 비즈니스 로직 코드는 수정할 필요가 없습니다.
구식 ASP.NET WebForm(.aspx) 프로젝트에서 프론트 페이지 테마 변경 기능을 구현하기 적합합니다.

aspx 작성

사이트 루트에 Register.aspx 페이지를 새로 생성하고 예시 페이지로 활용합니다.

Themes/default 경로에 템플릿 파일 register.htm을 생성합니다. 이 파일은 NVelocity 템플릿으로 HTML과 Velocity 문법을 담습니다.

Register.aspx를 열고 페이지 지시문만 남겨둔 나머지 HTML 코드를 전부 삭제합니다.

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Register.aspx.cs" Inherits="NVelocityStudy.Web.Register" %>

aspx 파일 자체는 페이지 렌더링에 관여하지 않고 컨트롤러 진입점 역할만 수행합니다. 백엔드 코드가 NVelocity를 호출해 register.htm 템플릿을 불러와 최종 내용을 출력합니다.

사이트 루트
├─ Register.aspx          # 접속 진입 페이지
├─ Register.aspx.cs       # 서버 로직 코드
└─ Themes
    └─ default
        └─ register.htm   # NVelocity 템플릿

이후 Register.aspx.cs에 코드를 작성해 현재 테마의 register.htm 템플릿을 불러오고 데이터 모델을 전달한 뒤 완성된 HTML을 생성합니다.

테마를 교체하려면 테마 폴더 경로 설정만 바꾸면 되며, 해당 폴더 안의 register.htm이 자동으로 로딩됩니다.

aspx.cs 구현

서버 코드 파일 Register.aspx.cs를 열고 Page_Load 메서드 안에 NVelocity 렌더링 로직을 작성합니다. 페이지가 로드될 때 템플릿 해석 및 결과 출력이 진행됩니다.

using System;
using System.Collections.Generic;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace NVelocityStudy.Web
{
    public partial class Register : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            // 여기에 NVelocity 템플릿 로딩 및 렌더링 코드를 작성합니다
        }
    }
}

Page_Load 안에 아래 코드를 추가합니다.

protected void Page_Load(object sender, EventArgs e)
{
    //1단계. VelocityEngine 인스턴스 생성
    VelocityEngine ve = new VelocityEngine();

    //2단계. 엔진 설정 초기화
    ExtendedProperties pros = new ExtendedProperties();
    pros.AddProperty(RuntimeConstants.RESOURCE_LOADER, "file"); // 파일 기반 템플릿 로드 방식
    pros.AddProperty(RuntimeConstants.FILE_RESOURCE_LOADER_PATH, Server.MapPath(@"")); // 템플릿 기본 경로
    ve.Init(pros); // 설정을 적용하고 엔진 초기화

    //3단계. 템플릿 파일 불러오기
    Template template = ve.GetTemplate("themes/default/register.htm");

    //4단계. 컨텍스트 생성, 템플릿에 변수 전달
    IContext context = new VelocityContext();
    context.Put("websiteName", "FoxDevelop");
    context.Put("domainName", "foxdevelop.com");

    //5단계. 템플릿과 데이터를 결합하여 HTML 생성
    StringWriter writer = new StringWriter();
    template.Merge(context, writer); // 렌더링 결과를 writer에 저장

    //6단계. 최종 페이지 출력
    Response.Write(writer.ToString().Replace("\r\n", "<br/>"));
}

이 코드는 템플릿 html 파일을 읽고 변수를 생성한 뒤 html 내의 자리 표시자를 실제 값으로 교체하는 과정입니다.

1. VelocityEngine 인스턴스 생성 전역 정적 Velocity.Init()와 달리 독립적인 엔진 객체로 여러 개의 개별 설정을 운용할 수 있습니다.
2. 엔진 초기화 및 환경 설정

• RESOURCE_LOADER=file : 템플릿을 로컬 파일로 불러오도록 지정;
• FILE_RESOURCE_LOADER_PATH : 템플릿을 탐색할 기본 경로 설정;
• ve.Init(pros) : 설정을 불러와 초기화를 완료.

3. 템플릿 불러오기 GetTemplate() 설정된 기본 경로를 기준으로 themes/default/register.htm 템플릿을 읽어옵니다.
4. VelocityContext 데이터 컨텍스트context.Put(키, 값)으로 C# 변수를 템플릿에 전달하며, htm 파일 안에서는 $websiteName、$domainName으로 값을 호출합니다.
5. 템플릿 Merge 렌더링template.Merge(컨텍스트, 출력스트림)으로 변수를 템플릿에 채워 완성된 HTML 문자열을 만들며, StringWriter로 렌더링 결과를 받습니다.
6. Response 출력 완성된 HTML을 브라우저로 전송;Replace("\r\n","<br/>") : 소스 코드의 줄바꿈 문자를 HTML 줄바꿈 태그로 변환.

htm 템플릿 작성

테마 폴더 안의 register.htm 파일을 수정합니다.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title></title>
</head>
<body>
    사이트：$websiteName <br />
    도메인：$domainName
</body>
</html>

위의 $xxxxxxx 두 개는 Page_Load에서 선언한 변수의 자리 표시자이며 렌더링 과정에서 실제 값으로 교체됩니다.

1. 변수 표기 $변수명 $websiteName、$domainName는 NVelocity(VTL) 변수 문법입니다. 코드에서 context.Put("websiteName", "FoxDevelop")로 값을 할당하면 렌더링 시 엔진이 자동으로 치환합니다.

• $websiteName → FoxDevelop
• $domainName → foxdevelop.com

실행 결과 예시

사이트：FoxDevelop
도메인：foxdevelop.com

NVelocity 개요