AJAX 강의 2장 - XMLHttpRequest 오브젝트 사용하기

(1)

AJAX 강의 2장 - XMLHttpRequest 오브젝트 사용하기

Chapter02-jinoxst.zip

XMLHttpRequest(XHR) 객체는 Internet Explore5에서 ActiveX 컴포넌트 형식으로 가장 먼저 제공되었기

때문에, 모질라와 사파리 웹브라우저에서 이 객체를 도입하기전까지 사실 많은 개발자들이

XMLHttpRequest 객체의 사용을 꺼려했다.

XHR은 W3C 표준이 아니기때문에 브라우저마다 작동방식에 있어서 다소나마 차이가 존재했었지만 현재 대부분의 브라우저들은 XHR 기능을 서로 비슷하게 구현하고 있다. 현존하는 브라우저들 중에서 XHR을 지 원하지 않는 브라우저는 거의 없을정도로 대부분의 브라우저들은 현재 XHR 을 지원하고 있다.

ajax 구현의 시작은 XHR 객체의 생성에서 시작한다.

XHR 은 W3C 의 표준이 아니므로, 인터넷익스플로어에서는 ActiveX Component 형식으로 구현되었고, 그 밖에 다른 브라우저들(FireFox, Safari, Opera)은 native javascript 객체로 구현되었다. 이런 차이점을 고 려해서 XHR 객체를 얻어오는 자바스크립트 코드를 다음과 같이 작성할 수 있다.

var xmlHttp;

function createXMLHttpRequest() { if (window.ActiveXObject) {

xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");

}

else if (window.XMLHttpRequest) { xmlHttp = new XMLHttpRequest();

} }

window.ActiveXObject 는 ActiveXObject를 지원하는 브라우저라면 오브젝트를 리턴하고 그렇지 않다면 null를 리턴하게 된다. 따라서 오브젝트가 존재하면 if 구문은 true 를 반환하고 xmlHttp 값은 ActiveXObject 객체가 할당되어진다. if 구문이 false 를 반환하면 else if 구분으로 이동하여 xmlHttp 값 은 navtive javascript 객체가 할당될 것이다.

따라서 위 코드를 이용하면 브라우저가 다르더라도 하나의 메소드로 XHR 객체를 생성하여 사용할 수 있 다.

그런데 왜 자바스크립트일까? 비슷한 놈으로 VBScrpt도 있는데 말이다. 여기서 cross-browser(브라우저 가 달라도 실행했을때 에러없이 같은 결과가 나오도록 구현해야 하는 코딩 방식)를 고려해 봐야 한다.

Ajax 에서 조차 IE 에서는 잘 구동되고 나머지 브라우저에서는 안되는 태고적 코딩방식에서는 이제 벗어 나보자. 자바스크립트는 현존하는 거의 모든 브라우저에서 지원받고 있는 스크립팅 언어이다. 그리고 자바 스크립트(Netscape 사에서 만들었음)는 자바(JAVA, 썬에서 만든 언어)와는 전혀 다르다. 자바스크립트에 대해서 간단하게 참고할 것이 있다면 http://www.crockford.com/javascript/javascript.html 이 싸이트에 한번 들어가보자.

(2)

이번에는 XHR 오브젝트에는 어떤 메소드가 있는지 살펴보자.

void open(string method, string url, boolean asynch, string username, string password) : 요청을 초 기화한다. 파라미터중에서 method, url 두개만 필수항목이고 나머지는 선택항목이다. method 는 POST, GET, PUT 3가지중 하나를 사용하면 되며, url 은 요청하고자 하는 서버의 url 이다. asynch 는 요청이 비동기인지 여부를 판단하는 항목이다. 입력하지 않으면 디폴트로 true 가 설정되어 요청은 비동기로 처리 된다. false 로 설정하면 요청은 동기로 처리되기 때문에 서버에서 응답을 받을때까지 프로세스는 기다리게 된다. 사실 XHR 을 사용하는 가장 큰 이점중의 하나인 비동기 처리를 위해서는 asynch 항목을 true 로 설정해서 사용해야 한다. false 를 설정한다면 XHR 을 사용하는 이점이 그만큼 줄어든다.

void send(content) : 실질적으로 요청을 서버로 보낸다. 요청이 비동기이면 이 메소드는 바로 리턴되지만 요청이 동기이면 서버에서 응답을 받을때까지 계속 대기한다. content 는 선택사항이며, DOM 객체(XML 객체)이거나 input stream, string 값으로 설정할 수 있으며 HttpRequest body 의 한 부분으로 서버로 전 달된다. content 에 값을 넘기려면 open() 메소드는 반드시 POST 로 설정해야 하며, GET 방식으로 요청 하려면 null 을 설정하면 된다.

open(), send() 메소드가 가장 많이 사용되는 메소드들이다. 나머지 메소드에 대해서도 알아보자.

void setRequestHeader(string header, string value) : header 에 해당하는 value 값으로 HttpRequest 헤더에 값을 설정하는 메소드로써, 반드시 open() 메소드 다음에 위치해야 한다.

void abort() : 요청을 중지한다.

string getAllResponseHeaders() : 요청에 대응되는 응답의 헤더정보를 리턴한다. 즉, Content-Length, Date, URI 등을 포함하는 헤더정보를 string 형식으로 반환한다.

string getResponseHeader(string header) : 응답의 헤더정보중에서 header 에 대응되는 값을 string 형 식으로 반환한다.

이번에는 XHR 의 속성중에서 중요한 몇가지를 알아본다.

onreadystatechange : 자바스크립트 콜백함수(funtion pointer)를 저장한다. 콜백함수는 readyState 값이 변할때 마다 호출된다. 요청이 서버로 보내지면 readyState 는 5가지 숫자값으로 계속 변화가 일어나게 된 다.

readyState : 요청의 상태를 의미한다.(0 = uninitialized, 1 = loading, 2 = loaded, 3 = interactive, 4 = complete)

responseText : 서버의 응답을 string 형식으로 나타낸다. 단순 text를 innerHTML 속성으로 표현하기에 는 알맞지만 논리적으로 파싱하거나 동적으로 페이지 컨텐츠를 생성하기는 힘들다.

responseXML : 서버의 응답을 XML 로 나타낸다. 이 속성은 DOM 객체로 파싱할 수 있다.

status : 서버로부터의 HTTP 상태코드이다.(예 200(OK), 404(NOT Found), 202(결과 값이 없을 때)등등) statusText : HTTP 상태코드에 대한 텍스트 값이다.(예 OK, NOT Found 등등)

(3)

이번에는 아주 간단한 예제를 실행해 보자. 아래 코드를 실행해 보려면 simpleRequest.html 이름의 html 파일로 만든 후에 반드시 웹서버에서 실행해야 한다. 소스는 다운받아서 실행해 볼 수도 있다.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<head>

<title>Simple XMLHttpRequest</title>

var xmlHttp;

}

} }

function startRequest() { createXMLHttpRequest();

xmlHttp.onreadystatechange = handleStateChange;

xmlHttp.open("GET", "simpleResponse.xml", true);

xmlHttp.send(null);

}

function handleStateChange() { if(xmlHttp.readyState == 4) { if(xmlHttp.status == 200) {

alert("The server replied with: " + xmlHttp.responseText);

} } }

</script>

</head>

<body>

</form>

</body>

</html>

<2-1 simpleRequest.html>

(4)

Hello from the server!

<2-2 simpleResponse.xml 의 내용>

위 코드를 실행해 보면 알겠지만 url 대신 <2-2> 와 같은 내용을 담고 있는 simpleResponse.xml 파일을 요청한다. 되도록 단순하게 XHR 의 구동원리를 이해하는 목적에서 서버에 요청을 하고 응답을 받는것 처 럼 꾸몄을 뿐이다. 위 예제의 구동순서는 아래와 같다.

<2-3 Start Basic Asynchronous Request 버튼>

첫째, 사용자가 그림 <2-3> 버튼을 클릭하면 이벤트가 발생해서 startRequest() 메소드가 실행된다.

둘째, XHR 객체가 생성되고 handleStateChange() 콜백함수가 XHR 객체의 onreadystatechange 속성에 저장된다.

셋째, GET/비동기 방식으로 서버에 요청을 보내는데, 이때 XHR 객체는 서버의 simpleResponse.xml 파일 을 요구한다.

넷째, 서버는 Ajax 클라이언트의 요청 url 인 simpleResponse.xml 을 찾아서 읽은 후에 string 형식으로 XHR 객체로 보낸다.

다섯째, 콜백메소드는 XHR 의 state 가 변할때 실행되므로 readyState=4 이고 stat=200 일때 결과값을 브라우저에 보낸다. 결과 화면은 아래 그림과 같다.

<2-4 simpleRequest.html 결과>

직접 실행해보면 알겠지만 Internet Explore 및 FireFox 에서 같은 결과값을 얻는다.

이번장에서 마지막으로 살펴볼 것은 Ajax 의 보안문제이다. XHR 객체는 요청할 수 있는 서버의 리소스 url 에 제한이 걸려있다. 즉, 접근 할 수 있는 서버 리소스 url 은 XHR 객체가 존재하는 도메인에 있어야 한다는 의미다. 다른 말로 바꾸면 XHR 객체와 서버 프로그램은 같은 도메인에 있어야만 한다. 그렇다면 XHR 객체가 자기가 속해있는 도메인이 아닌 그 밖에 있는 서버의 url 을 호출하면 어떻게 될까? 이것은 브라우저 마다 차이가 있다. IE 의 경우에는 alert 창을 띄우면서 보안 위해요소가 있으니 계속 진행할 것

(5)

인지 아닌지를 사용자가 판단할 수 있게 되어있고, FireFox 의 경우는 에러를 보여주며 요청자체를 브라우 저에서 차단해 버린다.

Ajax 구동방식이 일반적인 웹의 방식과는 많이 다르고 또한 그 내부로직을 이해하는데 어려움이 있을 수 도 있다. 하지만 XHR 의 주요 메소드와 주요 속성을 이해하는 데는 이글을 통해서 보다 쉽게 접근할 수 있으리라 기대해 본다.

(6)

AJAX 강의 3장 - 서버와 통신하기(요청/응답 처리)

Chapter03-jinoxst.zip

3.1 responseText 속성을 이용한 단순 문자열 다루기

2장에 이어 이번에는 innerHTML 속성을 이용한 샘플 코드를 살펴보자.

<head>

<title>Using responseText with innerHTML</title>

var xmlHttp;

}

} }

function startRequest() { createXMLHttpRequest();

xmlHttp.open("GET", "innerHTML.xml", true);

xmlHttp.send(null);

}

function handleStateChange() { if(xmlHttp.readyState == 4) { if(xmlHttp.status == 200) {

document.getElementById("results").innerHTML = xmlHttp.responseText;

} } }

</script>

</head>

<body>

</form>

</body>

</html>

<3-1 innerHTML.html 의 내용>

(7)

<tbody>

<tr>

<th>Activity Name</th>

<th>Location</th>

</tr>

<tr>

<td>Waterskiing</td>

</tr>

<tr>

<td>Volleyball</td>

<td>East Court</td>

</tr>

<tr>

<td>Hiking</td>

<td>Trail 3</td>

</tr>

</tbody>

</table>

<3-2 innerHTML.xml 의 내용>

2장 <2-1> 와 <3-1>의 가장 큰 차이점이라면 XHR 객체의 responseText 속성값을 이용하여 div 엘리먼 트에 문자열을 할당하는 부분이다. 아래 그림은 innerHTML.html 을 실행한 결과이다.

<3-3 innerHTML 실행 결과>

(8)

3.2 responseXML 속성을 이용한 DOM 시작하기

지금까지의 예제에서는 간단하고 단순한 문자열을 처리하는데 적합한 XHR 객체의 resonseText 속성만을 살펴보았다. 하지만 대단히 복잡한 응답데이터의 경우는 단순한 문자열로 처리할 수 없으며 XML 형식으로 처리하는 것이 훨씬 논리적이고 효율적일 것이다. 그러면 어떻게 브라우저는 서버로부터 받은 XML 형식의 데이터를 처리할 수 있는 것일까? XML 문서는 W3C 의 DOM 을 이용해서 처리된다. DOM 을 지원하는 브라우저들은 당연히 XML 문서를 다루는 많은 API 를 구현하고 있기 때문이다.

DOM 은 HTML 과 XML 을 다루는 API 를 제공하고 있으며, 스크립트를 통해서 다큐먼트에 접근할 수 있도록 정의되어 있다. 자바스크립트는 DOM 에 접근할 수 있고 DOM 을 다룰수 있는 스크립팅 언어이다.

다큐먼트의 모든 요소들은 DOM 의 부분들이기 때문에 요소의 속성과 메소드들은 자바스크립트로 제어가 가능하다.

다음은 XML 문서를 처리하기 위한 DOM 요소의 속성을 살펴보도록 하자.

childNodes : 현재 요소의 자식을 배열로 표현한다.

firstChild : 현재 요소의 첫번째 자식이다.

lastChild : 현재 요소의 마지막 자식이다.

nextSibling : 현재 요소와 바로 다음의 요소를 의미한다.

nodeValue : 해당 요소의 값을 읽고 쓸 수 있는 속성을 정의한다.(=data) parentNode : 해당 요소의 부모노드이다.

previousSibling : 현재 요소와 바로 이전의 요소를 의미한다.

다음은 XML 다큐먼트를 다루는 유용한 DOM 요소의 메소드를 살펴보자.

getElementById(id) : 다큐먼트에서 특정한 id 속성값을 가지고 있는 요소를 반환한다.

getElementsByTagName(name) : 특정한 태그 이름을 가지고 있는 자식 요소로 구성된 배열을 리턴한다.

hasChildNodes() : 해당 요소가 자식 요소를 포함하고 있는지를 나타내는 Boolean 값을 리턴한다.

getAttribute(name) : 특정한 name 에 해당하는 요소의 속성값을 리턴한다.

(9)

이번에는 XHR 객체의 responseXML 속성을 이용한 예제를 살펴봄으로써 XML 다큐먼트를 다루기 위한 DOM 객체의 속성과 메소드에 대해서 알아본다.

<head>

<title>Parsing XML Responses with the W3C DOM</title>

var xmlHttp;

var requestType = "";

}

} }

function startRequest(requestedList) { requestType = requestedList;

createXMLHttpRequest();

xmlHttp.open("GET", "parseXML.xml", true);

xmlHttp.send(null);

}

function handleStateChange() { if(xmlHttp.readyState == 4) { if(xmlHttp.status == 200) { if(requestType == "north") { listNorthStates();

}

else if(requestType == "all") { listAllStates();

} } } }

(10)

function listNorthStates() {

var xmlDoc = xmlHttp.responseXML;

var northNode = xmlDoc.getElementsByTagName("north")[0];

var out = "Northern States";

var northStates = northNode.getElementsByTagName("state");

outputList("Northern States", northStates);

}

function listAllStates() {

var allStates = xmlDoc.getElementsByTagName("state");

outputList("All States in Document", allStates);

}

function outputList(title, states) { var out = title;

var currentState = null;

for(var i = 0; i <states.length; i++) { currentState = states[i];

out = out + "₩n- " + currentState.childNodes[0].nodeValue;

}

alert(out);

}

</script>

</head>

<body>

<h1>Process XML Document of U.S. States</h1>

<input type="button" value="View All Listed Northern States"

onclick="startRequest('north');"/>

</form>

</body>

</html>

<3-4 parseXML.html 의 내용>

(11)

<?xml version="1.0" encoding="UTF-8"?>

<north>

<state>Minnesota</state>

<state>North Dakota</state>

</north>

<south>

<state>Texas</state>

<state>Oklahoma</state>

<state>Louisiana</state>

</south>

<east>

<state>North Carolina</state>

<state>Massachusetts</state>

</east>

<west>

<state>California</state>

<state>Oregon</state>

<state>Nevada</state>

</west>

</states>

<3-5 parseXML.xml 의 내용>

일단 <3-4>의 실행결과를 살펴본 후 핵심원리를 파악해 보자

<3-6 parseXML.html 을 실행했을때의 그림>

그림 <3-6> 은 parseXML.html 을 실행했을 때의 화면으로 View All Listed States 버튼을 눌렀을때의 결과 및 View All Listed Northern States 버튼을 눌렀을때의 결과 화면을 아래에 표시하였다.

(12)

<3-7 View All Listed States 버튼을 눌렀을때의 결과 화면>

<3-8 View All Listed Northern States 버튼을 눌렀을때의 결과 화면>

예제 3-4 는 다소 길어보이나 XHR 객체의 responseXML 속성을 이용한 DOM 객체를 다루는 속성 및 메 소드를 다루고 있다는 면에서 반드시 이해하고 넘어가야만 한다. 소스 패턴은 지금까지의 예제와 비슷하므 로 DOM 속성 및 메소드가 사용된 주요 부분만 설명하겠다.

listAllStates() 메소드의 아래 라인을 주목해 보자.

=> XHR 객체는 responseXML 속성을 이용해서 서버로부터의 XML 결과 다큐먼트를 다룰수 있는 DOM 속성 및 메소드를 사용할 수 있게 해준다는 것을 알 수 있다.

var allStates = xmlDoc.getElementsByTagName("state");

=>XML 결과 다큐먼트로부터 state 자식 엘리먼트들로 구성된 배열을 얻어와 allStates 변수에 할당하는 로직이다.

(13)

listNorthStates() 메소드를 살펴보자.

var northNode = xmlDoc.getElementsByTagName("north")[0];

=> XML 다큐먼트에서 north 앨리먼트는 유일하게 하나만 존재하므로 자식 앨리먼트로 구성된 배열중에서 첫번째(0) 배열값을 얻어와야 한다. 위 식은 아래와 같이 수정해도 결과는 같다.

var northNode = xmlDoc.getElementsByTagName("north").item(0);

outputList() 메소드를 살펴보자.

out = out + "₩n- " + currentState.childNodes[0].nodeValue;

=> 이부분은 각각의 state 앨리먼트의 첫번째 자식 노드의 값을 out 변수에 계속 연결하는 부분이다.

state 앨리먼트의 값을 표현하고 있는 부분도 XML 에서는 하나의 text 엘리먼트이다. 따라서 각각의 state 엘리먼트의 첫번째 text 자식 엘리먼트를 childNodes[0] 으로 표시한 것이며 그 값을 가져오기 위 해서 nodeValue 속성이 사용된 것이다. nodeValue 는 아래와 같이 data 속성을 사용해도 같은 결과를 얻 는다.

out = out + "₩n- " + currentState.childNodes[0].data;

3.3 Dynamic DOM 객체 다루기

지금까지는 DOM 의 기초적인 속성 및 메소드들을 다루어 봤다. 이런 속성으로는 다이나믹한 웹페이지를 구성하는데 한계가 있다. 웹페이지 전체가 리로딩 되지 않고 적절한 시점에 필요한 부분만 서버와 통신하 여 데이터가 수정되는 동적인 웹페이지를 만들려면 더 다양한 DOM 의 속성을 익혀야 한다. 자, 그럼 컨텐 츠를 동적으로 생성할 수 있게 해주는 W3C DOM 의 속성과 메소드에는 어떤것들이 있는지 알아보자.

document.createElement(tagName) : tagName 으로된 엘리먼트를 생성한다. div 를 메소드 파라미터로 입력하면 div 엘리먼트가 생성된다.

document.createTextNode(text) : 정적 텍스트를 담고 있는 노드를 생성한다.

<element>.appendChild(childNode) : 특정 노드를 현재 엘리먼트의 자식 노드에 추가시킨다. (예를들어 select 엘리먼트에 option 엘리먼트 추가)

<element>.getAttribute(name) : 속성명이 name 인 속성값을 반환한다.

<element>.setAttribute(name, value) : 속성값 value 를 속성명이 name 인 곳에 저장한다.

<element>.insertBefore(newNode, tartgetNode) : newNode 를 tartgetNode 전에 삽입한다.

<element>.removeAttribute(name) : 엘리먼트에서 name 속성을 제거한다.

<element>.removeChild(childNode) : 자식 엘리먼트를 제거한다.

<element>.replaceChild(newNode, oldNode) : oldNode 를 newNode 로 치환한다.

<element>.hasChildNodes() : 자식 노드가 존재하는지 여부를 판단한다. 리턴형식은 Boolean 이다.

여기서 한가지 짚고 넘어갈 부분이있다. 현재 거의 모든 브라우저는 DOM 을 지원하고 있으며 API 또한 비슷하게 동작하도록 구현되어 있다. 정확히 말하자면 DOM API 의 구현이 브라우저마다 다소 차이가 있

(14)

다는 말이다. 가장 호환이 안되는 브라우저는 다름아닌 인터넷 익스플로어다. AJAX 의 핵심은

XMLHttpRequest 객체이고 가장 먼저 이 객체를 구현하고 제공한 브라우저가 IE5임을 감안할때 상당히 아이러니컬하지 않은가? 2000년 IE 가 전세계 브라우저의 시장점유율 95% 차지할 즈음, IE 에 대적할 만 한 브라우저는 존재하지 않았다. 마이크로소프트가 다양한 웹표준 구현을 포기했던 시점이 바로 이때부터 다. 이때까지 XHR 의 사용은 당연히 저조할 수밖에 없었다. 하지만 모질라와 사파리가 잇따라 광범위하게 지원을 시작하게 되자 상황은 변하기 시작했고, 사용율이 극히 부진했던 XHR 객체는 W3C 의 표준으로 까지 자리매김하게 되었다. 더우기 구글맵, 구글 Suggest, Gmail, Flickr, Netflix 등에서 AJAX 를 사용하 자 이제는 명실상부한 웹의 표준으로 거듭나게 되었다. 너무 늦었지만 Microsoft 쪽에서도 많은 분발을 촉 구한다. 그러면 IE 에서 문제가 되고 있는 DOM 객체의 특징을 간략히 살펴보자.

첫째, IE 에서는 <table> 에 <tr> 을 추가할때 appendChilde() 메소드를 사용하더라도 <tr> 은 나타나지 않는다. 따라서 <tr> 을 <tbody> 에 추가해 주는 방식을 사용해야 모든 브라우저에서 동작하는 코드를 작 성할 수 있다.

둘째, IE 에서는 setAttribute() 메소드에 class 속성을 이용할 수 없다. setAttribute("class",

"newClassName") 한 후에 다시 setAttribute("className", "newClassName") 을 해야 모든 브라우저의 호환성을 보장할 수 있다.

셋째, IE 에서는 style 속성에 setAttribute() 메소드를 이용할 수 없다. <element>.setAttribute("style, font-weight:bold;") 라고 하는 대신에 <element>.style.cssText = "font-weight:bold" 라고 해 줘야 모 든 브라우저에서 제대로 작동한다.

다음은 DOM 의 동적 속성 및 메소드를 이용해서 다이나믹한 웹페이지를 생성하는 예제를 다루어 보겠다.

<head>

<title>Dynamically Editing Page Content</title>

var xmlHttp;

}

} }

function doSearch() {

xmlHttp.open("GET", "dynamicContent.xml", true);

xmlHttp.send(null);

}

(15)

function handleStateChange() { if(xmlHttp.readyState == 4) { if(xmlHttp.status == 200) { clearPreviousResults();

parseResults();

} } }

function clearPreviousResults() {

var header = document.getElementById("header");

if(header.hasChildNodes()) {

header.removeChild(header.childNodes[0]);

}

var tableBody = document.getElementById("resultsBody");

while(tableBody.childNodes.length >0) {

tableBody.removeChild(tableBody.childNodes[0]);

} }

function parseResults() {

var results = xmlHttp.responseXML;

var property = null;

var address = "";

var price = "";

var comments = "";

var properties = results.getElementsByTagName("property");

for(var i = 0; i <properties.length; i++) { property = properties[i];

address = property.getElementsByTagName("address")[0].firstChild.nodeValue;

price = property.getElementsByTagName("price")[0].firstChild.nodeValue;

comments = property.getElementsByTagName("comments")[0].firstChild.nodeValue;

addTableRow(address, price, comments);

}

var header = document.createElement("h2");

var headerText = document.createTextNode("Results:");

header.appendChild(headerText);

document.getElementById("header").appendChild(header);

document.getElementById("resultsTable").setAttribute("border", "1");

}

(16)

function addTableRow(address, price, comments) { var row = document.createElement("tr");

var cell = createCellWithText(address);

row.appendChild(cell);

cell = createCellWithText(price);

cell = createCellWithText(comments);

document.getElementById("resultsBody").appendChild(row);

}

function createCellWithText(text) {

var cell = document.createElement("td");

var textNode = document.createTextNode(text);

cell.appendChild(textNode);

return cell;

}

</script>

</head>

<body>

<h1>Search Real Estate Listings</h1>

Show listings from <select>

</select>

to <select>

</select>

</form>

</span>

</tbody>

</table>

</body>

</html>

<3-9 dynamicContent.html 의 내용>

(17)

<?xml version="1.0" encoding="UTF-8"?>

<comments>Quiet, serene neighborhood</comments>

</property>

<address>3308 James Ave S</address>

<comments>Close to schools, shopping, entertainment</comments>

</property>

<address>98320 County Rd 113</address>

<comments>Small acreage outside of town</comments>

</property>

</properties>

<3-10 dynamicContent.xml 의 내용>

<3-10 샘플 3-9의 실행결과 화면>

샘플 3-9를 보면 동적 메소드가 적용된 부분은 굵게 표시를 해 놓았다. 이부분을 이전 샘플들과 비교해 가면서 보면 코드를 이해하는데 큰 어려움은 없으리라 생각한다. 실행결과는 3-10 그림에 나와있다.

Search 버튼을 누르면 dynamicContent.xml 의 내용을 테이블로 표시한다. Search 버튼을 누르면 기존에 존재하는 테이블 row 를 동적으로 제거한 후에 동적으로 다시 그린다. 이번 예제는 이 부분이 핵심으므로 가장 중요한 코드만을 설명하겠다.

(18)

function createCellWithText(text) {

var cell = document.createElement("td");

var textNode = document.createTextNode(text);

cell.appendChild(textNode);

return cell;

}

위 메소드는 테이블 컬럼(<td></td>)에 해당하는 정보를 생성하는 메소드이다. 3-10 그림을 보면 하나의 row 에는 3개의 컬럼 요소가 있으며 동적으로 하나의 행을 생성하기 위해서는 address, price,

comments 에 해당하는 td 요소를 각각 생성해야 한다.

function addTableRow(address, price, comments) { var row = document.createElement("tr");

var cell = createCellWithText(address);

cell = createCellWithText(price);

cell = createCellWithText(comments);

document.getElementById("resultsBody").appendChild(row);

}

위 메소드는 테이블 행(<tr></tr>)에 해당하는 정보를 생성해서 테이블에 추가하는 메소드이다. 바로 위에 서 언급했듯이 행을 구성하고있는 3개의 컬럼 요소를 각각 만들어서 row 변수에 추가한 후, 이 변수를 다 시 tbody 속성에 추가하면 그림 3-10과 같은 화면이 완성되는 것이다.

3.4 요청 파라미터를 서버로 보내기

지금까지는 ajax를 이용하여 요청을 서버로 보내는 방법과 서버로부터 받은 결과 정보를 파싱해서 처리하 는 여러 특징들에 대해서 살펴보았다. 하지만 이것만으로는 부족하다. xml 의 고정된 정보를 다루는 것이 실증나지 않는가? 요청을 보낼때 특정 파라미터를 실어서 서버에 보내고, 서버는 요청정보를 바탕으로 특 화된 응답정보를 보내야만 쓸만해 진다.

(19)

XMLHttpRequest(XHR) 은 고전적 웹의 GET/POST 방식과 흡사하게 동작한다. GET 방식은 name=value 쌍의 파라마터를 url 에 실어서 서버로 전송한다. 물론 name=value 쌍은 리소스 url 의 끝을 의미하는 ? 이후에 구분자(&) 를 사이사이에 끼고 주욱 붙는다.

POST 방식은 GET 방식과 마찬가지로 name=value 쌍의 형태로 데이터를 전달한다. 물론 같은 구분자 (&)를 사용한다. 하지만 POST 방식은 폼 요소의 데이터를 인코딩하여 Http Request 객체의 body 에 저 장해서 보낸다.

또 다른 차이점이 있다면 서버로 보낼 수 있는 요청정보의 크기인데, GET 방식으로는

name1=value1&name2=value2&name3=value3... 이런 문자열의 길이가, 브라우저마다 차이가 있지만, 대 략 2000 byte 이상이면 불가능하다. 불가능하다는 의미가 무엇이냐 하면 브라우저는 요청정보를 보내려고 시도는 하지만 처리가 안되기 때문에 프러세스는 중단되고 만다. 따라서 서버로 보내는 파라미터가 많을 때는 POST 방식을 사용해야 한다. 일반적으로 데이터를 fetch(검색) 할때는 GET 방식을 사용하고 그 이 외의 작업(추가, 수정, 삭제)에는 POST 방식을 주로 사용한다. 예를 들어 클릭해서 현재 이 글을 읽고 있 는 경우는 GET 방식이 사용되었을 것이고, 이 글을 수정할때는 POST 방식이 사용될 것이다.

Ajax와 관련된 차이점이라면 GET 방식은 파라미터가 인코딩되어 url 에 붙어가기 때문에 해당 url 을 통 째로 재사용(bookmark) 가능하지만 ajax 특성상 이런 북마킹 기능은 불가능 하다. HTML 폼 요소에는 method 속성이 있는데 개발자는 GET 또는 POST 방식을 선택할 수 있다. 요청 데이터들은 서버로 submit 될때 method속성에 알맞도록 자동으로 인코딩되지만 XHR 객체는 이런 내장 알고리즘이 없기 때 문에 개발자가 쿼리 스트링을 작성해야 한다. 쿼리 스트링을 작성하는 방법은 GET 또는 POST 방식에 상 관없이 동일하다. 유일한 차이점이 있다면 GET 방식의 쿼리 스트링은 요청 url 에 붙어서 서버로 전송되 지만 POST 방식의 쿼리 스트링은 XHR 객체의 send(쿼리 스트링) 메소드가 호출될때 파라미터로 전송된 다. 샘플을 살펴보면서 ajax 에서 GET 및 POST 방식을 어떻게 사용하는지 알아보자. 이번에는 결과화면 을 먼저 소개한다.

<3-11 GET/POST 방식 샘플 화면>

(20)

위 그림 3-11 은 브라우저에서 First name, Middle name, Birthday 를 입력한 후 Send parameters using GET 버튼 혹은 Send parameters using POST 버튼을 눌렀을 때의 결과가 바로 아래 부분에 표시 되는 형태의 단순한 예제이다. 위 샘플을 실행시켜 보기 위해서는 getAndPostExample.html 과 서버 프로 그램인 GetAndPostExample.java 가 필요하다. 하지만 이번 예제의 주요 핵심은 서버 프로그램이 아니다.

XHR 객체가 GET/POST 방식을 어떻게 사용하는지를 이해하는 것이 중요하다. 클라이언트 및 서버 프로 그램 코드를 기술한 후 XHR 의 주요코드에 대해서 설명을 하겠다.

<head>

<title>Sending Request Data Using GET and POST</title>

var xmlHttp;

}

} }

function createQueryString() {

var firstName = document.getElementById("firstName").value;

var middleName = document.getElementById("middleName").value;

var birthday = document.getElementById("birthday").value;

var queryString = "firstName=" + firstName + "&middleName=" + middleName + "&birthday=" + birthday;

return queryString;

}

function doRequestUsingGET() { createXMLHttpRequest();

var queryString = "GetAndPostExample?";

queryString = queryString + createQueryString() + "&timeStamp=" + new Date().getTime();

xmlHttp.open("GET", queryString, true);

xmlHttp.send(null);

}

(21)

function doRequestUsingPOST() { createXMLHttpRequest();

var url = "GetAndPostExample?timeStamp=" + new Date().getTime();

var queryString = createQueryString();

xmlHttp.open("POST", url, true);

xmlHttp.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xmlHttp.send(queryString);

}

function handleStateChange() { if(xmlHttp.readyState == 4) { if(xmlHttp.status == 200) { parseResults();

} } }

var responseDiv = document.getElementById("serverResponse");

if(responseDiv.hasChildNodes()) {

responseDiv.removeChild(responseDiv.childNodes[0]);

}

var responseText = document.createTextNode(xmlHttp.responseText);

responseDiv.appendChild(responseText);

}

</script>

</head>

<body>

<h1>Enter your first name, middle name, and birthday:</h1>

<table>

<tbody>

<tr>

<td>First name:</td>

</tr>

<tr>

<td>Middle name:</td>

</tr>

<tr>

<td>Birthday:</td>

</tr>

</tbody>

</table>

(22)

<input type="button" value="Send parameters using POST"

onclick="doRequestUsingPOST();"/>

</form>

<br/>

<h2>Server Response:</h2>

</body>

</html>

<3-12 getAndPostExample.html 의 전체 소스 코드>

package ajaxbook.chap3;

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class GetAndPostExample extends HttpServlet { /**

* */

private static final long serialVersionUID = 1L;

protected void processRequest(HttpServletRequest request, HttpServletResponse response, String method) throws ServletException, IOException {

//Set content type of the response to text/xml response.setContentType("text/xml");

//Get the user's input

String firstName = request.getParameter("firstName");

String middleName = request.getParameter("middleName");

String birthday = request.getParameter("birthday");

//Create the response text

String responseText = "Hello " + firstName + " " + middleName + ". Your birthday is " + birthday + "."

+ " [Method: " + method + "]";

//Write the response back to the browser PrintWriter out = response.getWriter();

out.println(responseText);

//Close the writer out.close();

}

(23)

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

//Process the request in method processRequest processRequest(request, response, "GET");

}

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

//Process the request in method processRequest processRequest(request, response, "POST");

} }

<3-13 GetAndPostExample.java 의 전체 소스 코드>

3-12 의 샘플 코드는 이전 예제와 비교해 봤을때 크게 어려운 부분은 없을 것이다. 3-13 의 프로그램은 단순한 에코성 문자열을 생성해서 다시 클라이언트로 보내는 것이므로 특별한 설명은 필요하지 않을 듯 싶 다. 이번 예제의 핵심은 ajax 에서 GET 및 POST 방식으로 서버에 파라미터를 보내는 방법이다.

function createQueryString() {

var firstName = document.getElementById("firstName").value;

var middleName = document.getElementById("middleName").value;

var birthday = document.getElementById("birthday").value;

var queryString = "firstName=" + firstName + "&middleName=" + middleName + "&birthday=" + birthday;

return queryString;

}

먼저 위 코드는 GET 및 POST 방식에 있어서 쿼리 스트링을 만들어 공통으로 사용하기 위한 메소드이다.

전에도 설명했듯이 name=value 쌍의 파라미터를 한줄의 String 데이터로 만들고 있다. 각 name=value 쌍 은 &로 구분지어야 한다. name=value 쌍의 순서는 상관없다.

function doRequestUsingGET() { createXMLHttpRequest();

var queryString = "GetAndPostExample?";

queryString = queryString + createQueryString() + "&timeStamp=" + new Date().getTime();

xmlHttp.open("GET", queryString, true);

xmlHttp.send(null);

}

(24)

위의 코드는 ajax 를 활용하여 GET 방식으로 파라미터를 서버에 보내는 코드이다. XHR 객체 생성후 쿼리 스트링을 생성한다. var queryString = "GetAndPostExample?"; 라인에서 GetAndPostExample 은 ajaxbook.chap3.GetAndPostExample 서브렛을 호출하기 위해서 서브렛 이름과 매핑된 url 이름이다. 이 부분은 해당 컨텍스트의 web.xml 에 다음과 같이 기술되어 있어야 한다.

<web-app>

<servlet-name>GetAndPostExample</servlet-name>

<servlet-class>ajaxbook.chap3.GetAndPostExample</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>GetAndPostExample</servlet-name>

<url-pattern>/GetAndPostExample</url-pattern>

</servlet-mapping>

</web-app>

쿼리 스트링을 만들때 "&timeStamp=" + new Date().getTime(); 부분을 넣은 이유는 다음과 같다. 몇몇 브라우저들은 명확하지 않은 조건하에서 똑같은 url 로 XHR 멀티 요청을 보냈을때 서버의 결과를 캐싱하 는 경향을 보인다. 비록 같은 url 이지만 응답이 다를경우엔 캐싱하는 경향이 오히려 예상치 못한 결과의 원인이 될 수도 있기때문에 되도록이면 unique 한 url을 생성하기 위한 방법을 택한것이다. 이렇게 생성한 쿼리 스트링을 open 메소드에 넣어주고 send 메소드에는 null 값을 설정한다. 다음은 POST 방식에 대해 서 살펴보자.

function doRequestUsingPOST() { createXMLHttpRequest();

var url = "GetAndPostExample?timeStamp=" + new Date().getTime();

var queryString = createQueryString();

xmlHttp.send(queryString);

}

POST 방식도 GET 방식과 마찬가지로 같은 쿼리 스트링을 사용한다. 하지만 용도는 다르다. GET 방식은 url 과 쿼리 스트링을 합쳐서 open 메소드에 넣어서 사용한 반면, POST 방식은 위 코드처럼 send 메소드 에 파라미터로 넣어준다. 또 다른 차이점이라면 POST 방식은 HTTP Request 객체의 바디에 파라미터가 저장되는 것이므로 헤더에도 Content-Type 을 반드시 정의해 줘야 한다. 정의를 해주지 않으면 서버에서 는 클라이언트에서 보낸 파라미터를 얻지 못한다.

(25)

3.5 XML 을 요청 파라미터로 사용하기

예제 3-13은 ajax를 이용하여 브라우저의 파라미터를 서버로 전송하고 그 결과를 처리하는 부분을 주로 살펴보았다. 하지만 파라미터를 name=value 쌍으로 보내는 것은 초보나 하는 짓으로 보일 수 있고 좀더 확정성과 유연성 그리고 가독성을 높이는 방향으로 노력을 해보자. 파라미터를 xml 로 변환해서 처리하도 록 하는 것이다. 흥미진진하지 않은가? 그렇다고 이 방식이 완벽한 해결책이 되는 것은 아니다. 이번 예제 도 물론 실험적이고 기초적인 코드를 가지고 그 활용도를 모색할 것이다.

<head>

<title>Sending an XML Request</title>

var xmlHttp;

}

} }

function createXML() { var xml = "<pets>";

var options = document.getElementById("petTypes").childNodes;

var option = null;

for(var i = 0; i <options.length; i++) { option = options[i];

if(option.selected) {

xml = xml + "<type>" + option.value + "<₩/type>";

} }

xml = xml + "<₩/pets>";

return xml;

}

(26)

function sendPetTypes() { createXMLHttpRequest();

var xml = createXML();

var url = "PostingXMLExample?timeStamp=" + new Date().getTime();

xmlHttp.send(xml);

}

} } }

}

</script>

</head>

<body>

<h1>Select the types of pets in your home:</h1>

<option value="birds">Birds</option>

<option value="hamsters">Hamsters</option>

<option value="rabbits">Rabbits</option>

</select>

</form>

</body>

</html>

<3-14 postingXML.html 의 전체 소스 코드>

(27)

import java.io.*;

import javax.xml.parsers.DocumentBuilderFactory;

import javax.xml.parsers.ParserConfigurationException;

import org.w3c.dom.Document;

import org.w3c.dom.NodeList;

import org.xml.sax.SAXException;

public class PostingXMLExample extends HttpServlet { /**

* */

String xml = readXMLFromRequestBody(request);

Document xmlDoc = null;

try {

xmlDoc =

DocumentBuilderFactory.newInstance().newDocumentBuilder() .parse(new ByteArrayInputStream(xml.getBytes()));

}

catch(ParserConfigurationException e) {

System.out.println("ParserConfigurationException: " + e);

}

catch(SAXException e) {

System.out.println("SAXException: " + e);

}

/* Note how the Java implementation of the W3C DOM has the same methods * as the JavaScript implementation, such as getElementsByTagName and * getNodeValue.

*/

NodeList selectedPetTypes = xmlDoc.getElementsByTagName("type");

String type = null;

String responseText = "Selected Pets: ";

for(int i = 0; i <selectedPetTypes.getLength(); i++) {

type = selectedPetTypes.item(i).getFirstChild().getNodeValue();

responseText = responseText + " " + type;

}

response.setContentType("text/xml");

response.getWriter().print(responseText);

}

(28)

private String readXMLFromRequestBody(HttpServletRequest request){

StringBuffer xml = new StringBuffer();

String line = null;

try {

BufferedReader reader = request.getReader();

while((line = reader.readLine()) != null) { xml.append(line);

} }

catch(Exception e) {

System.out.println("Error reading XML: " + e.toString());

}

return xml.toString();

} }

<3-15 PostingXMLExample.java 의 전체 소스 코드>

3-14는 완전 html 날코딩이라 실망할 수도 있겠다. 파라미터를 담고 있는 xml 을 스트링 조합으로 생성해 서 서버로 전송한다. 전송방식은 샘플 3-12 의 POST 방식과 동일하다. 3-15 는 서브릿으로써 브라우저 에서 request 객체의 body 에 실어보낸 xml 을 파싱해서 데이터를 추출한 후 일정한 형식의 문자열로 변 환하여 다시 클라이언트로 보내주는 방식이다. 이번 서버 프로그램역시 xml 을 파싱하고 정보를 추출하는 부분에 대해서는 특별한 설명을 하지는 않겠다. 하지만 서블릿에서 한가지 짚고 넘어가자면 클라이언트로 부터 받은 xML 을 파싱할때 Document 인터페이스를 사용하는데, 이 는 W3C 가 구체화한 것으로 DOM 객체에 존재하는 같은 기능의 메소드인 getElementsByTagName("type") 을 사용하고 있다는 점이다. 나 의 주요 논점은 어디까지나 클라이언트이다. 핵심 코드는 아래와 같다.

function createXML() { var xml = "<pets>";

var options = document.getElementById("petTypes").childNodes;

var option = null;

for(var i = 0; i <options.length; i++) { option = options[i];

if(option.selected) {

xml = xml + "<type>" + option.value + "<₩/type>";

} }

xml = xml + "<₩/pets>";

return xml;

}

(29)

핵심 로직이지만 너무 간단해서 설명할 것도 없을 것 같다. 위 부분은 xml을 String 형식의 쿼리 스티링을 생성하는 부분이다. petTypes 는 select box 에서 option 엘리먼트 값을 추출하여 문자열을 만드는 부분 이다.

function sendPetTypes() { createXMLHttpRequest();

var xml = createXML();

var url = "PostingXMLExample?timeStamp=" + new Date().getTime();

xmlHttp.send(xml);

}

위 코드 역시 이전 샘플에서 다루었기 때문에 특별하게 설명한 부분은 없다. 하지만 한가지 짚고 넘어갈 부분이 있는데, send() 메소드의 파라미터에는 문자열 및 DOM 객체를 설정하는 것이 가능하다. 하지만 왜 이번 예제에서는 DOM 객체 대신에 문자열을 넣었을까? 아쉽게도 지금까지 브라우저간 DOM 객체를 생성 해서 공통적으로 사용할 수 있는 방법이 없기 때문이다. IE 의 경우는 ActiveXObject 컨트롤을 통해서, 모 질라는 native 자바스립트를 통해서 제공하며, 심지어 이런 방법조차 지원하지 않는 브라우저도 존재한다.

따라서 어쩔수 없이 스트링값을 설정한 것이다.

다음은 위 프로그램을 실행한 결과 화면이다.

<3-16 postingXML.html 의 실행 결과 화면>

(30)

3.6 JSON 을 활용하여 데이터를 서버로 보내기

바로 이전의 3-14 샘플은 브라우저의 파라미터를 XML 형식으로 변환하여 서버로 보내는 방법을 제시했 었다. 데이타 포맷의 표준이 되서버린 XML을 이용한다는 전체적인 맥락은 그럴싸했지만 사실 XML을 만 드는 과정이 복잡한 쿼리 스트링 조합작업이라면 누가 하려하겠는가 말이다. 나 자신도 이런 작업은 정말 싫어한다.

XML 을 생성하기 위한 javascript 날코딩의 대안으로 JSON(Javascript Object Notation, www.json.org) 을 소개한다. JSON 은 텍스트 포맷기반의 경량 데이터 변환 포맷이다. 프로그래밍 언어에 독립적며, C 언 어계열에 익숙한 데이터 구조 형식을 취하고 있다. JSON은 두가지 텍스트 포맷을 가지고 있는데, 첫번째 는 name/value 쌍의 컬렉션 데이터 구조로 프로그래밍 언어로 따지면 object, record, struct 쯤 되겠다.

두번째는 정렬된 value 의 리스트형태로써 프로그래밍 언어로 비유하자면 배열이라고 보면 될 것이다.

JSON 의 데이터 구조는 많은 프로그램 언어에 의해서 지원되고 있기때문에 XML 보다는 이기종 시스템간 의 이상적인 선택이 될 것이다. 추가적으로 JSON 은 표준 자바스크립트의 부류이므로 모든 웹 브라우저간 에도 양립할 수 있는 것이다.

(31)

<3-17 JSON 오브젝트구조도(출처 : www.json.org)>

위 그림은 JSON의 데이터 구조를 나타내고 있다.

Object는 {} 으로 표시한다. 오브젝트에는 name/value 쌍이 콜론(:) 혹은 콤마(,) 로 구분되어져 있으며 순서는 없다.

Array 는 [] 으로 표시한다. 배열은 정렬된 value 가 콤마(,) 에 의해서 구분되어져 있으며, value 값은 스 트링("" 으로 둘러싸야 함), 숫자, true or false, null, object , array 가 올수 있으므로 배열의 구조는 계 층적이라고 할 수 있다.

스트링은 유니코드 조합 및 백래쉬 이스케이프(₩)를 사용할 수 있으며 '' 을 사용하여 character 를 표현 할 수 있다.

스트링과 숫자는 C언어 혹은 자바의 스트링과 거의 흡사하지만 8진수 및 16진수 포맷은 지원하지 않는다.

공백을 name/value 쌍 사이사이에 사용할 수 있다.

하나의 예를 들어보자. Employ 라는 클래스(멤버로 firstName, lastName, employeeNumber, title)의 인 스턴스를 JSON 을 이용해서 아래와 같이 표현해 볼 수 있다.

var employee = { "firstName" : John, "lastName" : Doe, "employNumber" : 123, "title" : "Manager"

}

(32)

그러면 위 표현을 오브젝트 속성을 이용해서 아래와 같이 다룰 수 있다.

var lastName = employee.lastName;//lastName 에 접근 var title = employee.title;//title 에 접근

employee.emplyeeNumber = 456;//employeeNumber 를 456 으로 수정

JSON 의 인코딩은 확실히 XML 인코딩보다 가볍다. 따라서 네트웍을 통해서 큰 데이터가 오고가는 상황에 서는 많은 퍼포먼스의 차이가 발생할 것이다. JSON 싸이트에 가보면 적어도 14개 이상의 서버쪽 어플리케 이션을 다루는 프로그래밍언어에서 JSON 을 사용할 수 있게끔 준비가 되어 있다.

이제 3장의 마지막 주제인 JSON 을 이용한 간단한 샘플을 살펴보자.

<head>

<title>JSON Example</title>

var xmlHttp;

}

} }

function doJSON() {

var car = getCarObject();

//Use the JSON JavaScript library to stringify the Car object var carAsJSON = JSON.stringify(car);

alert("Car object as JSON:₩n " + carAsJSON);

var url = "JSONExample?timeStamp=" + new Date().getTime();

xmlHttp.send(carAsJSON);

}

(33)

} } }

}

function getCarObject() {

return new Car("Dodge", "Coronet R/T", 1968, "yellow");

}

function Car(make, model, year, color) { this.make = make;

this.model = model;

this.year = year;

this.color = color;

}

</script>

</head>

<body>

<input type="button" value="Click here to send JSON data to the server"

onclick="doJSON();"/>

</form>

</body>

</html>

<3-18 jsonExample.htm 의 전체 소스 코드>

(34)

import java.io.*;

import java.net.*;

import java.text.ParseException;

import org.json.JSONObject;

public class JSONExample extends HttpServlet {

String json = readJSONStringFromRequestBody(request);

//Use the JSON-Java binding library to create a JSON object in Java JSONObject jsonObject = null;

try {

jsonObject = new JSONObject(json);

}

catch(ParseException pe) {

System.out.println("ParseException: " + pe.toString());

}

String responseText = "You have a " + jsonObject.getInt("year") + " "

+ jsonObject.getString("make") + " " + jsonObject.getString("model") + " " + " that is " + jsonObject.getString("color") + " in color.";

response.setContentType("text/xml");

response.getWriter().print(responseText);

}

private String readJSONStringFromRequestBody(HttpServletRequest request){

StringBuffer json = new StringBuffer();

String line = null;

try {

BufferedReader reader = request.getReader();

while((line = reader.readLine()) != null) { json.append(line);

} }

catch(Exception e) {

System.out.println("Error reading JSON string: " + e.toString());

}

return json.toString();

} }

<3-19 JSONExample.java 의 전체 소스 코드>