- http 모듈은 Node.js의 가장 기본적인 웹 모듈이며 HTTP 웹 서버와 클라이언트를 생성하는 것과 관련된 모든 기능을 담당한다.
1. 요청과 응답
- 일반적으로 많이 알고 있는 요청과 응답에 대한 내용이다.
- 요청은 클라이언트가 서버로부터 요구하는 것을 말한다.
- 응답은 서버가 클라이언트로부터 받은 요청에 대한 정보를 제공해주는 것을 말한다.
- 기초적인 내용이라 내용 생략.
- http 모듈에서 가장 중요한 객체는 server 객체이다.
- http 모듈의 createServer() 메서드를 사용하면 server 객체를 생성할 수 있다.
- 서버 객체를 생성하고 52273번 포트를 사용하여 서버를 실행한다.
- listen(port[, callback]) : 서버를 실행한다.
- close() : 서버를 종료한다.
- 서버를 실행하여 10초 후 서버를 종료한다.
- request : 클라이언트가 요청할 때 발생하는 이벤트이다.
- connection : 클라이언트가 접속할 때 발생하는 이벤트이다.
- close : 서버가 종료될 때 발생하는 이벤트이다.
- checkContinue : 클라이언트가 지속적인 연결을 하고 있을 때 발생하는 이벤트이다.
- upgrade : 클라이언트가 HTTP 업그레이드를 요청할 때 발생하는 이벤트이다.
- clientError : 클라이언트에서 오류가 발생할 때 발생하는 이벤트이다.
[ 코드 - server 객체의 이벤트 ]
//모듈을 추출한다.
var http = require('http');
//server 객체를 생성한다.
var server = http.createServer();
//server 객체에 이벤트를 연결한다.
server.on('request', function() {
console.log('Request On');
});
server.on('connection', function() {
console.log('Connection On');
});
server.on('close', function() {
console.log('Close On');
});
//listen() 메서드를 실행한다.
server.listen(52273);
- 코드를 실행한 후 웹 브라우저를 사용하여 http://127.0.0.1:52273에 접속한다.
- 웹 브라우저는 요청했지만 응답이 없으므로 아무것도 출력되지 않을 것이다.
- 하지만 콘솔 화면을 살펴보면 이벤트가 실행된 것을 확인할 수 있다.
- 클라이언트에 웹 페이지를 제공하려면 응답 메시지를 작성해야 한다.
- 응답 메시지를 작성할 때는 response 객체를 사용한다.
- response 객체는 request 이벤트 리스너의 두 번째 매개변수로 전달되는 객체이다.
- writeHead(statusCode, object) : 응답 헤더를 작성한다.
- end([data], [encoding]) : 응답 본문을 작성한다.
- 코드를 실행한 후 웹 브라우저에서 http://127.0.0.1:52273에 접속한다.
3.1 File System 모듈을 사용한 HTML 페이지 제공
- 자바스크립트 파일 위에서 모든 HTML 페이지를 문자열로 작성하는 것은 불가능하다.
- File System 모듈을 사용하여 서버에 존재하는 HTML 페이지를 클라이언트에 제공한다.
[ 코드 - HTMLPage.html ]
<!DOCTYPE html>
<html>
<head>
<title>Index</title>
</head>
<body>
<h1>Hello Node.js</h1>
<h2>Test page</h2>
<p>Lorem ipsum dolor sit amet.</p>
</body>
</html>
[ 실행 - HTML 제공 파일 ]
- HTMLPage.html 파일의 HTML 페이지를 볼 수 있다.
3.2 이미지와 음악 파일 제공
- 파일을 제공하는 웹 서버를 만들어보겠다.
- JPG 이미지 파일과 MP3 음악 파일을 준비한다.
[ 코드 - 서버 생성 및 실행 ]
//모듈을 추출한다.
var fs = require('fs');
var http = require('http');
//52273번 포트에 서브를 생성하고 실행한다.
http.createServer(function (request, response) {
}).listen(52273, function () {
console.log('Server Running at http://127.0.0.1:52273');
});
//52274번 포트에 서버를 생성하고 실행한다.
http.createServer(function (request, response) {
}).listen(52274, function() {
console.log('Server Running at http://127.0.0.1:52274');
});
- 포트 2개를 사용하여 서버를 2개 생성한다.
[ 코드 - 52273번 포트의 이미지 파일 제공 ]
//52273번 포트에 서브를 생성하고 실행한다.
http.createServer(function (request, response) {
//이미지 파일을 읽는다.
fs.readFile('crystalrain.jpg', function (error, data) {
response.writeHead(200, { 'Content-Type' : 'image/jpeg' });
response.end(data);
});
}).listen(52273, function () {
console.log('Server Running at http://127.0.0.1:52273');
});
- 특정 형식 파일을 제공할 때 가장 중요한 것은 응답 헤더의 Content-Type 속성이다.
- Content-Type 속성은 MIME 형식을 입력한다. (image/jpeg)
- 응답 헤더의 Content-Type 속성을 'audio/mp3'로 입력한다.
[ 실행 - 이미지 파일 제공 ]
[ 실행 - 음악 파일 제공 ]
[ MME 형식의 예 ]
- text/plain : 기본적인 텍스트
- text/html : HTML 문서
- text/css : CSS 문서
- text/xml : XML 문서
- image/jpeg : JPG/JPEG 그림 파일
- image/png : PNG 그림 파일
- video/mpeg : MPEG 비디오 파일
- audio/mp3 : MP3 음악 파일
※ 그 외에도 굉장히 많다.
3.3 쿠키 생성
- 쿠키는 키(key)와 값(value)이 들어 있는 작은 데이터 조각으로 이름, 값, 파기 날짜와 경로 정보를 가지고 있다.
- 쿠키는 서버와 클라이언트에서 모두 저장하고 사용할 수 있다.
- 쿠키는 일정 기간 동안 데이터를 저장할 수 있으므로 일정 기간 동안 로그인을 유지하는 웹사이트에 사용한다.
- response 객체를 사용하면 클라이언트에 쿠키를 할당할 수 있다.
- 쿠키를 할당할 때는 응답 헤더의 Set-Cookie 속성을 사용한다.
- Set-Cookie 속성에는 쿠키의 배열을 넣는다.
[ 실행 - 쿠키 저장 및 출력 (1번째 실행) ]
- 처음 요청을 할 때는 클라이언트가 쿠키를 갖고 있지 않으므로 undefined로 표시된다. (이미 생성되어 있는 쿠키에 대해서만 쿠키 정보를 불러올 수 있다.)
- 하지만 쿠키 생성이 실행되었으므로 다음에 요청할 때에는 쿠키 정보를 불러올 수 있다.
[ 실행 - 쿠키 저장 및 출력 (2번째 실행) ]
- 1번째 요청했을 때 쿠키 생성을 했으므로 2번째 요청했을 때에는 쿠키 정보를 불러올 수 있다.
3.4 페이지 강제 이동
[ 코드 - Location 속성을 사용한 페이지 강제 이동 ]
//모듈을 추출한다.
var http = require('http');
//웹 서버를 생성 및 실행한다.
http.createServer(function (request, response) {
response.writeHead(302, {'Location' : 'http://m.naver.com'});
response.end();
}).listen(52273, function() {
console.log('Server Running at http://127.0.0.1:52273');
});
[ 실행 - Location 속성을 사용한 페이지 강제 이동 ]
- http://127.0.0.1:52273 으로 접속하면 m.naver.com 으로 페이지 강제 이동을 한다.
- writeHead() 메서드의 첫 번째 매개변수를 Status Code라 부른다.
- 위 예제에서 사용된 302는 강제 페이지 이동을 구현할 때 가장 많이 사용된다.
- 1XX : 처리 중
ex) 100 Continue - 2XX : 성공
ex) 200 OK - 3XX : 리다이렉트
ex) 300 Multiple Choices - 4XX : 클라이언트 오류
ex) 400 Bad Request - 5XX : 서버 오류
ex) 500 Internal Server Error
4. request 객체
- server 객체의 request 이벤트가 발생할 때 이벤트 리스터의 첫 번째 매개변수에 request 객체가 들어간다.
- request 속성을 사용하면 사용자가 요청한 페이지를 적절하게 제공하는 것은 물론 요청 방식에 따라 페이지를 구분할 수 있다.
- method : 클라이언트의 요청 방식을 나타낸다.
- url : 클라이언트가 요청한 URL을 나타낸다.
- headers : 요청 메시지 헤더를 나타낸다.
- trailers : 요청 메시지 트레일러를 나타낸다.
- httpVersion : HTTP 프로토콜 버전을 나타낸다.
4.1 url 속성을 사용한 페이지 구분
- 요청 페이지의 URL에 따라 서로 다른 웹 페이지를 제공하는 애플리케이션을 만들어보자.
[ 코드 - index.html 파일 ]
<!DOCTYPE html>
<html>
<head>
<title>Index</title>
</head>
<body>
<h1>Hello Node.js _ Index</h1>
<h2>Author. RintIanTta</h2>
<hr/>
<p>Lorem ipsum dolor sit amet</p>
</body>
</html>
[ 코드 - OtherPage.html ]
<!DOCTYPE html>
<html>
<head>
<title>OtherPage</title>
</head>
<body>
<h1>Hello Node.js _ OtherPage</h1>
<h2>Author. RintIanTta</h2>
<hr/>
<p>Lorem ipsum dolor sit amet</p>
</body>
</html>
[ 코드 - app.js (페이지 제공) ]
//모듈을 추출한다.
var http = require('http');
var fs = require('fs');
var url = require('url');
//서버를 생성 및 실행한다.
http.createServer(function (request, response) {
//변수를 선언한다.
var pathname = url.parse(request.url).pathname;
//페이지를 구분한다.
if (pathname == '/') {
//Index.html 파일을 읽는다.
fs.readFile('index.html', function (error, data) {
//응답한다.
response.writeHead(200, {'Content-Type' : 'text/html'});
response.end(data);
})
} else if (pathname == '/OtherPage') {
//OtherPage.html 파일을 읽는다.
fs.readFile('OtherPage.html', function (error, data) {
//응답한다.
response.writeHead(200, {'Content-Type' : 'text/html'});
response.end(data);
});
}
}).listen(52273, function() {
console.log('Server Running at http://127.0.0.1:52273');
});
[ 실행 - http://127.0.0.1:52273 으로 접속했을 때 ]
[ 실행 - http://127.0.0.1:52273/OtherPage 로 접속했을 때 ]
- URL 에 따른 페이지 구분 하는 것을 확인할 수 있다.
- GET 요청인지 POST 요청인지에 따른 페이지를 제공하는 것을 하고자 한다.
- request 객체의 method 속성을 사용하면 요청 방식에 따른 페이지를 쉽게 구분할 수 있다.
[ 실행 - method 속성을 사용한 페이지 구분 ]
- http://127.0.0.1:52273 으로 URL 페이지를 요청하면 GET 방식으로 수행되는 것을 확인할 수 있다.
- URL을 입력하는 것만으로는 POST 요청을 수행할 수 없다.
4.3 GET 요청 매개변수 추출
[ 코드 - GET 요청 매개변수 추출 ]
//모듈을 추출한다.
var http = require('http');
var url = require('url');
//모듈을 사용한다.
http.createServer(function (request, response) {
//요청 매개변수를 추출한다.
var query = url.parse(request.url, true).query;
//GET 요청 매개변수 출력
response.writeHead(200, {'Content-Type' : 'text/html'});
response.end('<h1>' + JSON.stringify(query) + '</h1>');
}).listen(52273, function() {
console.log('Server Running at http://127.0.0.1:52273');
});
- url.parse(request.url, true) : true로 입력하면 배열로 파싱한다. 기본값은 false이다.
- JSON.stringify(query) : 배열을 JSON 문자열로 변환.
[ 실행 - GET 요청 매개변수 추출 ]
- http://127.0.0.1:52273/?name=rintiantta®ion=seoul 로 접속했을 때
4.4 POST 요청 매개변수 추출
- GET 방식과 달리 POST 방식은 데이터를 더 많이 담을 수 있고 보안 측면에도 좋다.
- POST 매개변수를 입력하는 화면이다.
- GET 방식으로 접속할 경우 HTMLPage.html 파일을 제공하고 POST 방식으로 접속할 경우 요청 매개변수를 화면에 출력한다.
- GET 방식으로 접속할 경우 HTMLPage.html 파일이 출력된다.
- Data A와 Data B의 입력 양식에 데이터를 입력하고 [제출] 버튼을 클릭한다.
[ 실행 - POST 요청 ]
- 앞서 입력했던 데이터가 쿼리 문자열 형태로 출력된다. Query String 모듈을 이용하면 분해하여 원하는 대로 사용할 수 있다.
- 쿠키는 request 객체의 headers 속성 안 cookie 속성에서 추출할 수 있다.
[ 실행 - 두 번째 이후 접속 ]
- 저장된 쿠키가 출력된다.
- 쿠키 값을 split()을 사용하여 ';'로 분해한다.
- 분해한 값을 다시 '='로 분해한 뒤 key와 value로 구분하여 리턴한다.
- 쿠키 값을 key와 value로 분해하여 출력한 화면이다.
'Node.js' 카테고리의 다른 글
| Node.js express 모듈 (6) | 2015.01.25 |
|---|---|
| Node.js 외부 모듈 (0) | 2014.11.12 |
| Node.js 이벤트 (0) | 2014.07.06 |
| Node.js 기본 내장 모듈 (2) | 2014.06.29 |
| Node.js 전역 객체 (0) | 2014.06.25 |
